NAV Navbar
http

Introduction 👋

Aliseeks API allows interaction with two data sources.

Aliseeks API provides online retail search, product details with variations, and freight information. We also are working on providing Ordering and Shipment Tracking. You can view request and response samples of each API operation.

We are no longer accepting new integrations at this time.

Authentication

To authorize your requests, append a header X-Api-Client-Id with your API key:

GET / HTTP/1.1
X-Api-Client-Id: Your API Key
POST / HTTP/1.1
X-Api-Client-Id: Your API Key
{ "anyrequest": "anyrequest" } 

Make sure to replace Your API Key with your API key available from your dashboard on Aliseeks.

Aliseeks API uses API keys to allow access to our API.

Aliseeks expects for the API key to be included in all API requests in a header that look like the following:

X-Api-Client-Id: Your Api Key

Search API

Search Products (Realtime)

POST /v1/search/realtime HTTP/1.1
{
  "text": "battery backup",
  "category": "200003482",
  "priceRange": {
    "from": 12.50,
    "to": 30.00
  },
  "attributes": [
    {
      "id": "16",
      "value": "256"
    }
  ],
  "shipToCountry": "US",
  "shipFromCountry": "CN",
  "sort": "BEST_MATCH",
  "skip": 20
}

The above command returns JSON structured like this:

{
    "aggregation": {
        "totalCount": 1522577,
        "shipFromCountries": [
            "US",
            "CN"
        ],
        "attributes": [
          {
            "id": "16",
            "value": "Color",
            "values": [
              {
                "id": "256",
                "name": "Blue",
                "color": "Blue",
                "count": 567
              },
              {
                "id": "872",
                "name": "Red",
                "color": "Red",
                "count": 90
              }
            ]
          }
        ]
    },
    "items": [
        {
            "id": "32827273458",
            "imageUrl": "http://ae01.alicdn.com/kf/HTB1M4ztXUrrK1RkSne1q6ArVVXam.jpg",
            "title": "KPYTOMOA Boho Vintage Mini Dress Women 2018 Summer Casual",
            "ratings": 4.6,
            "orders": 670,
            "freight": {
                "price": {
                    "currency": "USD",
                    "value": "0"
                }
            },
            "priceOptions": [
                {
                    "type": "pc_price",
                    "amount": {
                        "currency": "USD",
                        "value": "12.79"
                    }
                },
                {
                    "type": "app_price",
                    "amount": {
                        "currency": "USD",
                        "value": "12.59"
                    }
                }
            ]
        }
    ]
}

This endpoint allows searching AliExpress in realtime using different criteria. The data retrieved by this endpoint is the same that you would get from searching on AliExpress. This can be used for product sourcing, finding dropshipping items or dynamically displaying products on a site.

HTTP Request

POST https://api.aliseeks.com/v1/search/realtime

Body Parameters

Parameter Type Default Description Allowed Values
text string empty The search text used to search for products by name
sort string BEST_MATCH Defines how the matched items should be sorted. BEST_MATCH, HIGHEST_PRICE, LOWEST_PRICE, NUMBER_OF_ORDERS, SELLER_RATING, NEWEST_TO_OLDEST
category integer empty The category of the item See valid categories
priceRange Range null A price filter to apply to matched items.
attributes attribute[] null A list of selected attributes to refine the search by.
shipToCountry string empty The country where the product will be shipped to
shipFromCountry string empty The country where the product should ship from
skip integer 0 The number of matched items to skip [0 - 5000]

Search Products (Non-realtime)

POST /v1/search HTTP/1.1
{
  "text": "phone charger",
  "sort": "BEST_MATCH",
  "currency": "USD",
  "category": 200000147,
  "orderRange": {
    "from": 50
  },
  "ratingsRange": {
    "from": 4.0,
    "to": 5.0
  },
  "quantityRange": {
    "from": 0,
    "to": 1
  },
  "priceRange": {
    "from": 2.00,
    "to": 50.00
  },
  "freightTypes": [
    "ePacket"
  ],
  "sellers": [
    "738716"
  ],
  "storeNames": [
    "Shop1828218 Store"
  ],
  "skip": 0,
  "limit": 25,
  "scrollPagination": false
}

The above command returns JSON structured like this:

{
  "aggregation": {
    "totalCount": 4947,
    "skip": 0,
    "limit": 25,
    "scrollIdentifier": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAD"
  },
  "items": [
    {
        "id": "32818641835",
        "title": "1PCS Hunting Duck Commander Duck Picker Call Mallard Duck Call",
        "categoryId": 200000147,
        "imageUrl": "https://ae01.alicdn.com/kf/HTB1RxisSXXXXXbaXpXXq6xXFXXXG.jpg_960x960.jpg_.webp",
        "detailUrl": "https://www.aliexpress.com/item/32818641835/32818641835.html",
        "lotSize": 1,
        "lotUnit": "piece",
        "price": {
            "currency": "USD",
            "value": "9.990"
        },
        "ratings": 5,
        "orders": 2,
        "freight": {
            "price": {
                "currency": "USD",
                "value": "0.0"
            },
            "type": "ePacket"
        },
        "seller": {
            "storeName": "OSPRO FISHING TACKLE & HUNTING CO.,LTD",
            "positiveFeedback": 13388,
            "totalFeedback": 14227
        }
    }
  ]
}

This endpoint allows searching the Aliseeks Product database using different criteria. This can be used for product sourcing, finding dropshipping items or dynamically displaying products on a site.

For deep pagination, set scrollPagination to true and use the scrollIdentifier returned in the aggregation.scrollIdentifier field to retrieve the next page of results. Every sub-sequent request will have an aggregation.scrollIdentifier, use the latest returned value to retrieve the next page of results.

HTTP Request

POST https://api.aliseeks.com/v1/search

Body Parameters

Parameter Type Default Description Allowed Values
text string empty The search text used to search for products by name
sort string BEST_MATCH Defines how the matched items should be sorted. PRODUCT_ID, BEST_MATCH, MONTHLY_TRANSACTION_RATE, WHOLESALE_PRICE, ITEM_RATING, ORDERS, TRANSACTIONS, UPDATE_TIME
sortDirection string ASC Defines the direction that the items should be sorted. ASC, DESC
category integer empty The category of the item See valid categories
includeSubcategories boolean false When this is set to true, we will include all the products in subcategories of category true or false
currency string USD The currency of the prices in the matched items. See supported non-realtime currencies.
ratingsRange Range null A rating filter to apply to matched items.
quantityRange Range null A lot size (sold by quantity) to apply to matched items.
priceRange Range null A non-wholesale price filter to apply to matched items.
unitPriceRange Range null A wholesale price filter to apply to matched items.
orderRange Range null A number of orders filter to apply to matched items.
freightTypes string[] null Freight types filter to apply to matched items. You can use this filter to find items that ship with a shipping method. See supported freight types.
sellers integer[] null A seller filter to retrieve items that are sold by particular seller IDs.
storeNames string[] null A list of store names to retrieve items that are sold by a particular store name.
skip integer 0 The number of matched items to skip [0 - 5000]
limit integer 50 The number of matched items to return [5 - 50]
scrollPagination boolean false Use for deep pagination, set this to true and use the scrollIdentifier returned to retrieve the next page of results true or false
scrollIdentifier string empty Use for deep pagination, set this to the previously retrieved scroll identifier. This value can change between requests, please use the latest one.

Search Products By Image (Realtime)

You can obtain an uploadKey by using the Upload Image API.


POST /v1/search/image HTTP/1.1
{
  "uploadKey": "abcdefg.jpg",
  "currency": "USD",
  "category": 6000
}

The above command returns JSON structured like this:

{
  "selectedCategoryId": 3000041,
  "categories": [
    {
      "id": 40001,
      "name": "Shirts"
    },
    {
      "id": 3000041,
      "name": "Electronics"
    }
  ],
  "items": [
    {
      "id": "32279008015",
      "title": "SANYO  New Circular fan modified car electric turbocharger fan 4A 13V 6 * 6.5cm * 7.6cm diameter 9CR0612POJ50",
      "imageUrl": "http://ae01.alicdn.com/kf/HTB1r1Q3SFXXXXauaXXXq6xXFXXXZ.jpg_350x350.jpg",
      "price": {
          "currency": "USD",
          "value": "17.2"
      },
      "orders": 1
    }
  ]
}

This endpoint allows performing a realtime AliExpress search by image. You will need to upload an image using the Upload Image API.

This endpoint will automatically select the most relavent category and provide a list of items that match the Search Image. You can invoke this API with any of the returned categories to obtain a list of items that match the Search Image and the particular category.

HTTP Request

POST https://api.aliseeks.com/v1/search/image

Request Parameters

Parameter Type Default Description Allowed Values
uploadKey string empty The file key provided when an image is uploaded using the Upload Image API
currency string USD The currency that prices should be returned See supported realtime currencies.
category integer null The category to search in See valid categories

Search Best Selling Products (Realtime)

POST /v1/search/bestSelling HTTP/1.1
{
  "range": "top",
  "category": "all",
  "skip": 20,
  "locale": "en_US",
  "currency": "USD"
}

The above command returns JSON structured like this:

{
    "items": [
        {
            "id": "32287093437",
            "title": "LongWay Vintage Big Round Flower Gold color Silver color Statement Drop Earrings For Women Crystal Wedding Earrings SER140389",
            "imageUrl": "http://g04.a.alicdn.com/kf/HTB1ayPsLFXXXXcMXXXXq6xXFXXX1/New-Arrival-Big-Round-Drop-Earrings-For-Women-Real-Gold-Silver-Plated-Brincos-Pendientes-Crystal-Statement.jpg_350x350.jpg",
            "ratings": "4.7",
            "orders": 157,
            "detailUrl": "http://www.aliexpress.com/item/New-Arrival-Big-Round-Drop-Earrings-For-Women-Real-Gold-Silver-Plated-Brincos-Pendientes-Crystal-Statement/32287093437.html?sdom=655.123089.110643.0_32287093437",
            "storeDetailUrl": "http://www.aliexpress.com/store/product/New-Arrival-Big-Round-Drop-Earrings-For-Women-Real-Gold-Silver-Plated-Brincos-Pendientes-Crystal-Statement/728483_32287093437.html?sdom=655.123089.110643.0_32287093437",
            "priceOptions": [
                {
                    "type": "pc_price",
                    "originalAmount": {
                        "currency": "USD",
                        "value": "3.9"
                    },
                    "amount": {
                        "currency": "USD",
                        "value": "1.99"
                    }
                },
                {
                    "type": "app_price",
                    "originalAmount": {
                        "currency": "USD",
                        "value": "3.9"
                    },
                    "amount": {
                        "currency": "USD",
                        "value": "1.95"
                    }
                }
            ]
        }
    ]
}

This endpoint allows searching best selling weekly or top AliExpress products in multiple categories in realtime. This can be used to find the best selling products provided by AliExpress and then using these products for dropshipping or reselling on other sites.

HTTP Request

POST https://api.aliseeks.com/v1/search/bestSelling

Body Parameters

Parameter Type Default Description Allowed Values
range string top Either search for top or weekly best selling items top weekly
category string electronics The category to search for best selling items. Only certain categories are allowed per range. See below. all fashion sports health_beauty home_garden kids_baby automotive men women
skip integer 0 The number of matched items to skip [0 - 5000]
locale string en_US The locale that the product and information should be returned in. See locales
currency string USD The currency that prices should be returned See supported realtime currencies.

When finding top best selling items the categories all, fashion, electronics, sports, health_beauty, kids_baby, home_garden, automotive are supported.

When finding weekly best selling items the categories woman, men, electronics, sports, health_beauty, kids_baby automotive are supported.

Upload Image

This request is not a JSON body, rather it is Form Data. Please check your language's client documentation for more information on how to send multipart form data file requests.


POST /v1/search/image HTTP/1.1
Content-Type: multipart/form-data
{
  "file": "file-binary-data"
}

The above command returns JSON structured like this:

{
  "uploadKey": "UTB8NelmDOaMiuJk43PTq6ySmXXaD.jpg"
}

This endpoint allows an image to be uploaded which can then be used for Image Search.

There is about a ~4MB size limit on file uploads, if you have trouble with this limit then please let us know.

Upload Image With URL

You can obtain an uploadKey by using the Upload Image API.


POST /v1/search/image/upload HTTP/1.1
{
  "url": "https://assets.pernod-ricard.com/uk/media_images/test.jpg"
}

The above command returns JSON structured like this:

{
  "uploadKey": "UTB8NelmDOaMiuJk43PTq6ySmXXaD.jpg"
}

HTTP Request

POST https://api.aliseeks.com/v1/search/image/upload

Request Parameters

Parameter Type Default Description Allowed Values
url string empty The URL to download an image from Limited to 4MB

This endpoint allows an image to be uploaded which can then be used for Image Search.

There is about a ~4MB size limit on file uploads, if you have trouble with this limit then please let us know.

Product API

Get Product

POST /v1/products HTTP/1.1
{
    "productId": "32826897725",
    "currency": "USD",
    "locale": "en_US",
    "country": "US",
    "quantity": 1,
    "components": [
      "variations",
      "shipping",
      "html_description"
    ]
}

The above command returns JSON structured like this:

{
    "id": "32826897725",
    "categoryId": "200000346",
    "companyId": "214558387",
    "sellerId": "202046246",
    "detailUrl": "https://www.aliexpress.com/item/32826897725/32826897725.html",
    "title": "Office Bow Tie Blouse Women Lantern Sleeve White Button Necktie Shirts Female Elegant Work Shirt Casual Tops New 2018 Spring",
    "statusId": 0,
    "status": "active",
    "countPerLot": 1,
    "wishListCount": 8587,
    "unit": "piece",
    "multiUnit": "pieces",
    "seller": {
        "storeId": 516346,
        "storeUrl": "http://m.aliexpress.com/store/storeHome.htm?sellerAdminSeq=202046246",
        "storeName": "YUNSHAN E-commerce CO.,LTD Store",
        "sellerLevel": "31-s",
        "positiveFeedbackRate": "96.3"
    },
    "reviews": {
        "fiveStarCount": 131,
        "fourStarCount": 20,
        "threeStarCount": 1,
        "twoStarCount": 6,
        "oneStarCount": 2,
        "totalCount": 0,
        "positiveCount": 151,
        "negativeCount": 8,
        "neutralCount": 1,
        "ratings": "4.7"
    },
    "trade": {
        "sold": 739
    },
    "promotion": {
        "discount": "11",
        "timeLeft": {
            "days": 1,
            "hours": 3,
            "minutes": 50,
            "seconds": 2
        }
    },
    "productImages": [
        "https://ae01.alicdn.com/kf/HTB1zBLQHkKWBuNjy1zjq6AOypXaa.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB13mbkl5MnBKNjSZFoq6zOSFXaD.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1GmYCyZuYBuNkSmRyq6AA3pXaE.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1VVzqy2iSBuNkSnhJq6zDcpXaB.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1DjsqHkyWBuNjy0Fpq6yssXXab.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1u37GHbGYBuNjy0Foq6AiBFXay.jpg_960x960.jpg_.webp"
    ],
    "attributes": [
        {
            "name": "Brand Name",
            "id": 2,
            "value": "LOSSKY",
            "valueId": "201785910"
        },
        {
            "name": "Material",
            "id": 10,
            "value": "Polyester,Cotton",
            "valueId": "48,47"
        },
        {
            "name": "Clothing Length",
            "id": 200000303,
            "value": "Regular",
            "valueId": "200001122"
        },
        {
            "name": "Style",
            "id": 326,
            "value": "Casual",
            "valueId": "200000072"
        }
    ],
    "htmlDescription": "<p align=\"center\"><a href=\"https://www.aliexpress.com/item/LOSSKY-Knitted-Dress-Women-Elegant-Long-Sleeve-Sashes-Winter-Mini-Party-Dresses-2018-Autumn-Jumper-Casual/32903148144.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/Summer-Women-Lace-Dress-Sexy-Backless-V-neck-Beach-Dresses-2018-Fashion-Sleeveless-Spaghetti-Strap-White/32875342721.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/2016-New-Women-s-Winter-Fashion-Casual-Warm-Wool-Shirts-Blouse-Women-s-Long-Sleeve-Plus/32789435835.html\"></a><a href=\"http://www.aliexpress.com/item/anywhere/32789435835.html\"></a><a href=\"http://www.aliexpress.com/item/anywhere/32789435835.html\"><img src=\"http://ae01.alicdn.com/kf/HTB1AtOJXyDxK1RjSsD4q6z1DFXaZ.jpg\" width=\"950\" /></a></p> <p align=\"center\"><br /></p> <p align=\"center\">  <kse:widget data-widget-type=\"relatedProduct\" id=\"24210853\" title=\"YOUHUIQ\" type=\"custom\"></kse:widget></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/LOSSKY-Fashion-Clothes-Vestidos-Women-Dress-2018-Autumn-Winter-Velvet-Dress-Female-O-Neck-Long-Sleeve/32919443041.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/LOSSKY-Fashion-Clothes-Vestidos-Women-Dress-2018-Autumn-Winter-Dress-Female-O-Neck-Long-Sleeve-Lace/32919443041.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/LOSSKY-Fashion-Clothes-Vestidos-Women-Dress-2018-Autumn-Winter-Dress-Female-O-Neck-Long-Sleeve-Lace/32919443041.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/Summer-Women-Lace-Dress-Sexy-Backless-V-neck-Beach-Dresses-2018-Fashion-Sleeveless-Spaghetti-Strap-White/32875342721.html\"></a></p> <p><a href=\"https://www.aliexpress.com/item/Summer-Women-Lace-Dress-Sexy-Backless-V-neck-Beach-Dresses-2018-Fashion-Sleeveless-Spaghetti-Strap-White/32875342721.html\"></a></p> <p align=\"center\"><a href=\"https://www.aliexpress.com/item/Sexy-Summer-Button-Beach-Boho-Bohemian-Dress-Women-2018-Floral-Print-Polka-Dots-Striped-17-Colors/32866446904.html\"></a></p> <p align=\"center\">&nbsp;<img src=\"http://ae01.alicdn.com/kf/HTB1TtglinJYBeNjy1zeq6yhzVXar.jpg\" /></p> <table style=\"margin:0px auto;width:95%;font-size:20px;\" border=\"1\" cellspacing=\"0\" cellpadding=\"0\" align=\"center\">  <tbody>   <tr>    <td colspan=\"11\"><p style=\"color:#000000;\">1.The size system of different brands is different.</p><p style=\"color:#000000;\">2.Please refer to the below detail size information before order. Thanks!</p><p style=\"color:#000000;\">3.Measurement difference from 1-3cm,1 cm=0.39 inch</p></td>   </tr>   <tr style=\"background-color:#ffffff;\">    <td style=\"text-align:center;\">Size/Tag</td>    <td style=\"text-align:center;\" colspan=\"2\">S</td>    <td style=\"text-align:center;\" colspan=\"2\">M</td>    <td style=\"text-align:center;\" colspan=\"2\">L</td>    <td style=\"text-align:center;\" colspan=\"2\">XL</td>   </tr>   <tr style=\"background-color:#ffffff;\">    <td style=\"text-align:center;color:#000000;\">Cm/Inch</td>    <td style=\"text-align:center;\">Cm</td>    <td style=\"text-align:center;\">Inch</td>    <td style=\"text-align:center;\">Cm</td>    <td style=\"text-align:center;\">Inch</td>    <td style=\"text-align:center;\">Cm</td>    <td style=\"text-align:center;\">Inch</td>    <td style=\"text-align:center;\">Cm</td>    <td style=\"text-align:center;\">Inch</td>   </tr>   <tr style=\"background-color:#ffffff;\">    <td style=\"text-align:center;\">Length</td>    <td style=\"text-align:center;\">65</td>    <td style=\"text-align:center;\">25.61</td>    <td style=\"text-align:center;\">66</td>    <td style=\"text-align:center;\">26</td>    <td style=\"text-align:center;\">67</td>    <td style=\"text-align:center;\">26.4</td>    <td style=\"text-align:center;\">68</td>    <td style=\"text-align:center;\">26.79</td>   </tr>   <tr style=\"background-color:#ffffff;color:#000000;\">    <td style=\"text-align:center;color:#000000;\">Bust</td>    <td style=\"text-align:center;\">83</td>    <td style=\"text-align:center;\">32.7</td>    <td style=\"text-align:center;\">87</td>    <td style=\"text-align:center;\">34.28</td>    <td style=\"text-align:center;\">91</td>    <td style=\"text-align:center;\">25.85</td>    <td style=\"text-align:center;\">95</td>    <td style=\"text-align:center;\">37.43</td>   </tr>   <tr style=\"background-color:#ffffff;\">    <td style=\"text-align:center;\">Waist</td>    <td style=\"text-align:center;\">76</td>    <td style=\"text-align:center;\">29.94</td>    <td style=\"text-align:center;\">80</td>    <td style=\"text-align:center;\">31.52</td>    <td style=\"text-align:center;\">84</td>    <td style=\"text-align:center;\">33.1</td>    <td style=\"text-align:center;\">88</td>    <td style=\"text-align:center;\">34.67</td>   </tr>   <tr style=\"background-color:#ffffff;color:#000000;\">    <td style=\"text-align:center;color:#000000;\">Shoulder</td>    <td style=\"text-align:center;\">35</td>    <td style=\"text-align:center;\">13.79</td>    <td style=\"text-align:center;\">36</td>    <td style=\"text-align:center;\">14.18</td>    <td style=\"text-align:center;\">37</td>    <td style=\"text-align:center;\">14.58</td>    <td style=\"text-align:center;\">38</td>    <td style=\"text-align:center;\">14.97</td>   </tr>  </tbody> </table> <p align=\"center\">&nbsp;</p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB14M6JflsmBKNjSZFFq6AT9VXa5.jpg\" width=\"920\" /></p> <p align=\"center\">&nbsp;</p> <p align=\"center\">&nbsp;</p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1HEfsl3LD8KJjSszeq6yGRpXaq.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1K5SHd.o09KJjSZFDq6z9npXaO.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1GdjhlZrI8KJjy0Fhq6zfnpXaU.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1WjbRdAfb_uJkSmRyq6zWxVXaj.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1LSrAl4rI8KJjy0Fpq6z5hVXaX.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1SjS7l_nI8KJjSszgq6A8ApXa5.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1hOzRl4PI8KJjSspoq6x6MFXah.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1EZ_Dl3vD8KJjy0Flq6ygBFXaE.jpg\" width=\"850\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1qcXQdAfb_uJjSsrbq6z6bVXaV.jpg\" width=\"795\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1u5nGeNHI8KJjy1zbq6yxdpXau.jpg\" width=\"795\" /></p> <p align=\"center\"><img alt=\"aeProduct.getSubject()\" src=\"http://ae01.alicdn.com/kf/HTB1I1BpXDzGK1JjSspkq6xNUpXa9.jpg\" width=\"570\" /></p> <p align=\"center\"><img alt=\"aeProduct.getSubject()\" src=\"http://ae01.alicdn.com/kf/HTB1k4UwXw2DK1JjSZFOq6ybwFXaV.jpg\" width=\"574\" /></p> <p align=\"center\"><img alt=\"aeProduct.getSubject()\" src=\"http://ae01.alicdn.com/kf/HTB1RzVqXDzGK1JjSspnq6yVgXXae.jpg\" width=\"553\" /></p> <p align=\"center\"><img alt=\"aeProduct.getSubject()\" src=\"http://ae01.alicdn.com/kf/HTB1G9BrXE_FK1Jjy0Fnq6zXfXXa5.jpg\" width=\"562\" /></p> <p align=\"center\"><img alt=\"aeProduct.getSubject()\" src=\"http://ae01.alicdn.com/kf/HTB1x9NqXDzGK1JjSspaq6xPmpXaK.jpg\" width=\"589\" /></p> <p align=\"center\"><img src=\"http://ae01.alicdn.com/kf/HTB1btOjiXGWBuNjy0Fbq6z4sXXaw.jpg\" /></p> <div style=\"margin:0px auto;\">  <p style=\"overflow:hidden;height: 1.0px;padding: 0;margin: 0;\">12341</p>  <div style=\" text-align: center;\">   <div style=\"text-align: center;clear: both; padding:5px 0; display: inline-block;\">    <table border=\"0\" cellpadding=\"0\" cellspacing=\"0\">     <tbody>      <tr>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32855699106.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB18xBAXojrK1RkHFNRq6ySvpXam.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32966159357.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1Qgr_binrK1RjSsziq6xptpXaw.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32964399629.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB19bwfbdfvK1RjSszhq6AcGFXaA.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32959780076.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1XYT1be6sK1RjSsrbq6xbDXXaX.jpg\" /></a></td>      </tr>      <tr>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32975058140.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1e.7abhrvK1RjSszeq6yObFXaz.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32959018011.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1Vib4bifrK1RjSspbq6A4pFXaq.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32730724140.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1ArFAXiLxK1Rjy0Ffq6zYdVXah.jpg\" /></a></td>       <td> <a href=\"http://www.aliexpress.com/item/anywhere/32955412325.html\"><img style=\"margin: 1px; border: 0px currentColor; \" src=\"http://ae01.alicdn.com/kf/HTB1ILQdbh2rK1RkSnhJq6ykdpXaI.jpg\" /></a></td>      </tr>     </tbody>    </table>   </div>  </div>  <div style=\"clear: both;\"></div> </div> <table style=\"margin:0px auto;width:95%;\" border=\"0\" cellspacing=\"0\" cellpadding=\"0\" align=\"center\">  <tbody>   <tr>    <td style=\"text-align:center;font-family:Georgia,serif;color:#0e0101;font-size:18px;\">More products click on the picture below to enter the shop</td>   </tr>   <tr>    <td style=\"text-align:center;font-family:Georgia,serif;color:#f71013;font-size:36px;\"><a href=\"https://yunshan.aliexpress.com/store/516346?spm=2114.10010108.0.0.4da6c4b6CZg8rN\"><img alt=\"\" src=\"http://ae01.alicdn.com/kf/HTB1DJc3hASWBuNjSszdq6zeSpXaX.jpg\" width=\"950\" height=\"300\" /></a> </td>   </tr>   <tr>    <td style=\"text-align:center;font-family:Georgia,serif;color:#f71013;font-size:36px;\"><img alt=\"\" src=\"http://ae01.alicdn.com/kf/HTB1LtShif9TBuNjy0Fcq6zeiFXav.jpg\" width=\"950\" height=\"80\" /> </td>   </tr>   <tr>    <td style=\"text-align:center;\"><img alt=\"\" src=\"http://ae01.alicdn.com/kf/HTB1rd8Ldi6guuRjy0Fmq6y0DXXaT.jpg\" width=\"950\" height=\"635\" /> </td>   </tr>   <tr>    <td style=\"text-align:center;\"><img alt=\"\" src=\"http://ae01.alicdn.com/kf/HTB1EmKYNVXXXXX1XpXXq6xXFXXXN.jpg\" width=\"950\" height=\"49\" /> </td>   </tr>   <tr>    <td style=\"text-align:center;\"><img alt=\"\" src=\"http://ae01.alicdn.com/kf/HTB1nqJPiKySBuNjy1zdq6xPxFXat.jpg\" width=\"950\" height=\"508\" /> </td>   </tr>   <tr>    <td style=\"text-align:center;\">     <div>      <div>       <p><strong>Wholesale and drop shipping are both welcomed?</strong> </p>       <p>For wholesale,we will offer discount or free express shipping which only takes 3-7 days to arrive.</p>       <p>For drop shipping,we could send the goods to your customers directly and won\\'t leave information about us if you\\'d like to.</p>       <p>&nbsp;</p>       <p><strong>How can</strong>&nbsp;<strong>I&nbsp;track my parcel?</strong> </p>       <p>You can track your parcel on the following website using your tracking number: www.17track.net/en &nbsp;(Copied to the browser to open)</p>       <p>&nbsp;</p>       <p><strong>What can I do when purchase protection time is running out?</strong> </p>       <p>If your purchase protection time is running out, please contact us and we can help you to extend it. So your money will not go to my account.<span>.</span> </p>      </div>     </div></td>   </tr>  </tbody> </table>",
    "priceSummary": {
        "originalAmount": {
            "min": {
                "currency": "USD",
                "value": "16.49"
            },
            "max": {
                "currency": "USD",
                "value": "16.09"
            }
        },
        "unitOriginalAmount": {
            "min": {
                "currency": "USD",
                "value": "16.49"
            },
            "max": {
                "currency": "USD",
                "value": "16.09"
            }
        },
        "discountedAmount": {
            "min": {
                "currency": "USD",
                "value": "14.32"
            },
            "max": {
                "currency": "USD",
                "value": "14.68"
            }
        },
        "unitDiscountedAmount": {
            "min": {
                "currency": "USD",
                "value": "15"
            },
            "max": {
                "currency": "USD",
                "value": "14"
            }
        },
        "bulkAmount": {
            "min": {
                "currency": "USD",
                "value": "13.30"
            },
            "max": {
                "currency": "USD",
                "value": "14.25"
            }
        },
        "unitBulkAmount": {
            "min": {
                "currency": "USD",
                "value": "13.30"
            },
            "max": {
                "currency": "USD",
                "value": "14.25"
            }
        }
    },
    "prices": [
        {
            "originalPrice": {
                "currency": "USD",
                "value": "16.49"
            },
            "discountedPrice": {
                "currency": "USD",
                "value": "14.68"
            },
            "bulkPrice": {
                "currency": "USD",
                "value": "13.97"
            },
            "bulkQuantity": 2,
            "skuImage": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_640x640q90.jpg_.webp",
            "skuThumbnail": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp",
            "stock": 50,
            "properties": [
                {
                    "propertyId": 14,
                    "valueId": 29,
                    "valueName": "White",
                    "valueDisplayName": "White",
                    "sku": "14:29#White"
                },
                {
                    "propertyId": 5,
                    "valueId": 361385,
                    "valueDisplayName": "L",
                    "sku": "5:361385"
                }
            ]
        },
        {
            "originalPrice": {
                "currency": "USD",
                "value": "16.49"
            },
            "discountedPrice": {
                "currency": "USD",
                "value": "14.68"
            },
            "bulkPrice": {
                "currency": "USD",
                "value": "13.97"
            },
            "bulkQuantity": 2,
            "skuImage": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_640x640q90.jpg_.webp",
            "skuThumbnail": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp",
            "stock": 47,
            "properties": [
                {
                    "propertyId": 14,
                    "valueId": 29,
                    "valueName": "White",
                    "valueDisplayName": "White",
                    "sku": "14:29#White"
                },
                {
                    "propertyId": 5,
                    "valueId": 361386,
                    "valueDisplayName": "M",
                    "sku": "5:361386"
                }
            ]
        },
        {
            "originalPrice": {
                "currency": "USD",
                "value": "16.09"
            },
            "discountedPrice": {
                "currency": "USD",
                "value": "14.32"
            },
            "bulkPrice": {
                "currency": "USD",
                "value": "13.59"
            },
            "bulkQuantity": 2,
            "skuImage": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_640x640q90.jpg_.webp",
            "skuThumbnail": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp",
            "stock": 49,
            "properties": [
                {
                    "propertyId": 14,
                    "valueId": 29,
                    "valueName": "White",
                    "valueDisplayName": "White",
                    "sku": "14:29#White"
                },
                {
                    "propertyId": 5,
                    "valueId": 100014064,
                    "valueDisplayName": "S",
                    "sku": "5:100014064"
                }
            ]
        },
        {
            "originalPrice": {
                "currency": "USD",
                "value": "16.49"
            },
            "discountedPrice": {
                "currency": "USD",
                "value": "14.68"
            },
            "bulkPrice": {
                "currency": "USD",
                "value": "13.97"
            },
            "bulkQuantity": 2,
            "skuImage": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp",
            "skuThumbnail": "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_640x640q90.jpg_.webp",
            "stock": 50,
            "properties": [
                {
                    "propertyId": 14,
                    "valueId": 29,
                    "valueName": "White",
                    "valueDisplayName": "White",
                    "sku": "14:29#White"
                },
                {
                    "propertyId": 5,
                    "valueId": 100014065,
                    "valueDisplayName": "XL",
                    "sku": "5:100014065"
                }
            ]
        }
    ],
    "shipping": [
        {
            "company": "ePacket",
            "serviceName": "EMS_ZX_ZX_US",
            "tracking": true,
            "amount": {
                "currency": "USD",
                "value": "0.0"
            },
            "discount": "100",
            "commitDays": 60,
            "shipFrom": "CN",
            "deliveryTime": {
                "from": 25,
                "to": 25
            }
        },
        {
            "company": "AliExpress Standard Shipping",
            "serviceName": "CAINIAO_STANDARD",
            "tracking": true,
            "amount": {
                "currency": "USD",
                "value": "2.58"
            },
            "discount": "60",
            "commitDays": 60,
            "shipFrom": "CN",
            "deliveryTime": {
                "from": 23,
                "to": 23
            }
        }
    ]
}

This endpoint is the preferred endpoint for retrieving realtime product information from AliExpress. This endpoint provides all the same data as GetProductDetails, GetProductShipping, GetProductVariations, and GetProductHTMLDescription.

Parameter Type Default Description Allowed Values
productId string empty The product ID to retrieve.
currency string USD The currency that prices should be returned See supported realtime currencies.
locale string en_US The locale that the product and information should be returned in. See locales
country string US The country used when fetching shipping information (See supported ship to countries below)
sendGoodsCountry string null The country where goods should be shipped from (See supported ship to countries below)
quantity integer 1 The quantity desired to order
components string[] empty List of information to retrieve, allowed values are variations, shipping, and html_description

Get Product Details

POST /v1/products/details HTTP/1.1
{
    "productId": "32826897725",
    "currency": "AUD",
    "locale": "en_US"
}

The above command returns JSON structured like this:

{
    "id": "32826897725",
    "categoryId": "200000346",
    "sellerId": "202046246",
    "detailUrl": "https://www.aliexpress.com/item/32826897725/32826897725.html",
    "title": "Office Bow Tie Blouse Women Lantern Sleeve White Button Necktie Shirts Female Elegant Work Shirt Casual Tops New 2018 Spring",
    "productImages": [
        "https://ae01.alicdn.com/kf/HTB1zBLQHkKWBuNjy1zjq6AOypXaa.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB13mbkl5MnBKNjSZFoq6zOSFXaD.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1GmYCyZuYBuNkSmRyq6AA3pXaE.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1VVzqy2iSBuNkSnhJq6zDcpXaB.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1DjsqHkyWBuNjy0Fpq6yssXXab.jpg_960x960.jpg_.webp",
        "https://ae01.alicdn.com/kf/HTB1u37GHbGYBuNjy0Foq6AiBFXay.jpg_960x960.jpg_.webp"
    ],
    "promotions": [
        {
            "maxAmount": {
                "currency": "AUD",
                "value": "21.5"
            },
            "minAmount": {
                "currency": "AUD",
                "value": "20.97"
            },
            "discount": "9",
            "timeLeft": {
                "days": 0,
                "hours": 3,
                "minutes": 27,
                "seconds": 0
            },
            "stock": 382
        }
    ],
    "attributes": [
        {
            "name": "Brand Name",
            "id": 2,
            "value": "LOSSKY",
            "valueId": "201785910"
        },
        {
            "name": "Material",
            "id": 10,
            "value": "Polyester,Cotton",
            "valueId": "48,47"
        },
        {
            "name": "Clothing Length",
            "id": 200000303,
            "value": "Regular",
            "valueId": "200001122"
        },
        {
            "name": "Style",
            "id": 326,
            "value": "Casual",
            "valueId": "200000072"
        }
    ],
    "prices": [
        {
            "maxAmount": {
                "currency": "AUD",
                "value": "23.62"
            },
            "maxAmountPerPiece": {
                "currency": "AUD",
                "value": "23.62"
            },
            "minAmount": {
                "currency": "AUD",
                "value": "23.04"
            },
            "minAmountPerPiece": {
                "currency": "AUD",
                "value": "23.04"
            },
            "minimumPurchase": 1,
            "processingTime": "7",
            "bulkOption": {
                "price": {
                    "currency": "AUD",
                    "value": "22.44"
                },
                "discount": "5",
                "bulkOrderCount": 2
            }
        }
    ],
    "statusId": 0,
    "countPerLot": 1,
    "wishListCount": 7355,
    "unit": "piece",
    "multiUnit": "pieces",
    "reviews": {
        "fiveStarCount": 140,
        "fourStarCount": 25,
        "threeStarCount": 4,
        "twoStarCount": 2,
        "oneStarCount": 3,
        "totalCount": 0,
        "positiveCount": 165,
        "negativeCount": 5,
        "neutralCount": 4,
        "ratings": "4.7"
    },
    "trade": {
        "sold": 1557
    },
    "skuProperties": [
        {
            "propertyId": 14,
            "propertyName": "Color",
            "values": [
                {
                    "propertyValueName": "Sky blue",
                    "propertyValueId": 173,
                    "propertyValueDisplayName": "Blue"
                },
                {
                    "propertyValueName": "White",
                    "propertyValueId": 29,
                    "propertyValueDisplayName": "White"
                }
            ]
        },
        {
            "propertyId": 5,
            "propertyName": "Size",
            "values": [
                {
                    "propertyValueName": "S",
                    "propertyValueId": 100014064,
                    "propertyValueDisplayName": "S"
                },
                {
                    "propertyValueName": "M",
                    "propertyValueId": 361386,
                    "propertyValueDisplayName": "M"
                },
                {
                    "propertyValueName": "L",
                    "propertyValueId": 361385,
                    "propertyValueDisplayName": "L"
                },
                {
                    "propertyValueName": "XL",
                    "propertyValueId": 100014065,
                    "propertyValueDisplayName": "XL"
                }
            ]
        }
    ]
}

This endpoint allows retrieving realtime product information from AliExpress. The product information is retrieved by Product ID and can be modified by currency and locale.

Parameter Type Default Description Allowed Values
productId string empty The product ID to retrieve.
currency string USD The currency that prices should be returned See supported realtime currencies.
locale string en_US The locale that the product and information should be returned in. See locales

Get Product Shipping

POST /v1/products/shipping HTTP/1.1
{
    "productId": "32826897725",
    "country": "US",
    "sendGoodsCountry": "CN",
  "currency": "USD"
    "quantity": 1,
}

The above command returns JSON structured like this:

{
    "options": [
        {
            "company": "Seller's Shipping Method",
            "serviceName": "Other",
            "tracking": false,
            "amount": {
                "currency": "USD",
                "value": "0.0"
            },
            "discount": "100",
            "commitDays": 60,
            "shipFrom": "CN",
            "deliveryTime": {
                "from": 21,
                "to": 39
            }
        },
        {
            "company": "AliExpress Standard Shipping",
            "serviceName": "CAINIAO_STANDARD",
            "tracking": true,
            "amount": {
                "currency": "USD",
                "value": "20.84"
            },
            "discount": "60",
            "commitDays": 60,
            "shipFrom": "CN",
            "deliveryTime": {
                "from": 14,
                "to": 17
            }
        },
        {
            "company": "DHL",
            "serviceName": "DHL",
            "tracking": true,
            "amount": {
                "currency": "USD",
                "value": "25.26"
            },
            "discount": "87",
            "commitDays": 30,
            "shipFrom": "CN",
            "deliveryTime": {
                "from": 7,
                "to": 14
            }
        }
    ]
}

This endpoint allows retrieval of realtime product shipping information.

Parameter Type Default Description Allowed Values
productId string empty The product ID to retrieve.
country string US The country that the product will be shipped to. (See supported ship to countries below)
sendGoodsCountry string CN The country which the product will be shipped from.
quantity integer 1 The amount that will be shipped.
currency string USD The currency that shipping prices will be retrieved in. See supported realtime currencies.

Supported Ship To Countries

AD, AE, AF, AG, AI, AL, ALA, AM, AN, AO, AR, AS, ASC, AT, AU, AU, AW, AZ, BA, BB, BD, BE, BE, BF, BG, BH, BI, BJ, BLM, BM, BN, BO, BQ, BR, BR, BS, BT, BW, BY, BZ, CA, CA, CC, CF, CG, CH, CI, CK, CL, CL, CM, CO, CR, CV, CW, CX, CY, CZ, DE, DE, DJ, DK, DM, DO, DZ, EAZ, EC, EE, EG, ER, ES, ES, ET, FI, FJ, FK, FM, FO, FR, FR, GA, GBA, GD, GE, GF, GGY, GH, GI, GL, GM, GN, GP, GQ, GR, GT, GU, GW, GY, HK, HN, HR, HT, HU, ID, IE, IL, IL, IN, IQ, IS, IT, IT, JEY, JM, JO, JP, KE, KG, KH, KI, KM, KN, KR, KS, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MAF, MC, MD, MG, MH, MK, ML, MM, MN, MNE, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PL, PM, PR, PS, PT, PW, PY, QA, RE, RO, RU, RU, RW, SA, SB, SC, SE, SG, SGS, SI, SK, SL, SM, SN, SO, SR, SRB, SS, ST, SV, SX, SZ, TC, TD, TG, TH, TJ, TLS, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UK, UK, US, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZR, ZW

Get Product Reviews

POST /v1/products/reviews HTTP/1.1
{
    "productId": "32844651460",
    "page": 1
}

The above command returns JSON structured like this:

{
    "currentPage": 1,
    "totalCount": 772,
    "totalPages": 39,
    "reviews": [
        {
            "buyerName": "S***a",
            "buyerCountry": "UA",
            "buyerRating": "100",
            "reviewDate": "2019-03-13",
            "review": "В Украину за 17 дней, трек отслеживался только по Китаю. Все работает",
            "translatedReview": "In ukraine in 17 days, the track was tracked only in china. Everything works",
            "images": [
                "https://ae01.alicdn.com/kf/UTB8rlmPJSnEXKJk43Ubq6zLppXaH.jpg"
            ],
            "shipping": "Bpost International",
            "downVotes": 0,
            "upVotes": 0
        },
        {
            "buyerName": "M***d",
            "buyerCountry": "NL",
            "buyerRating": "100",
            "reviewDate": "2019-01-09",
            "review": "Looks good. I have not tested yet, but then I will know of it is much noise. Thank you!",
            "translatedReview": "Looks good. I have not tested yet, but then I will know of it is much noise. Thank you!",
            "images": [
                "https://ae01.alicdn.com/kf/UTB8H2OXnbPJXKJkSafSq6yqUXXaK.jpg",
                "https://ae01.alicdn.com/kf/UTB8kFR5ndnJXKJkSaiyq6AhwXXaN.jpg",
                "https://ae01.alicdn.com/kf/UTB8eu5yGVfFXKJk43Otq6xIPFXaL.jpg",
                "https://ae01.alicdn.com/kf/UTB88nafnevJXKJkSajhq6A7aFXaE.jpg"
            ],
            "shipping": "China Post Ordinary Small Packet Plus",
            "downVotes": 0,
            "upVotes": 0
        }
    ]
}

This endpoint allows retrieving product reviews in realtime from AliExpress.

Parameter Type Default Description Allowed Values
productId string empty The product ID to retrieve.
page integer 1 The page number of reviews to retrieve
country string US The country where the product will be shipped from (See supported ship to countries below)

Get Product Variations

POST /v1/products/variations HTTP/1.1
{
    "productId": "32826897725",
    "currency": "AUD",
    "locale": "en_US"
}

The above command returns JSON structured like this:

{
    "variations": [
        {
            "propertyIdentifiers": [
                {
                    "propertyId": 14,
                    "propertyValueId": 173,
                    "propertyValueName": "Sky blue"
                },
                {
                    "propertyId": 5,
                    "propertyValueId": 361385
                }
            ],
            "propertyValueIds": [
                173,
                361385
            ],
            "productId": "32826897725",
            "price": {
                "currency": "AUD",
                "value": "23.62"
            },
            "stock": 50,
            "bulkQuantity": 2,
            "imageUrl":  "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp",
            "thumbnailImageUrl":  "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp"
        },
        {
            "propertyIdentifiers": [
                {
                    "propertyId": 14,
                    "propertyValueId": 173,
                    "propertyValueName": "Sky blue"
                },
                {
                    "propertyId": 5,
                    "propertyValueId": 361386
                }
            ],
            "propertyValueIds": [
                173,
                361386
            ],
            "productId": "32826897725",
            "price": {
                "currency": "AUD",
                "value": "23.62"
            },
            "stock": 50,
            "bulkQuantity": 2,
            "imageUrl":  "https://ae01.alicdn.com/kf/HTB18_ObHxWYBuNjy1zkq6xGGpXaX.jpg_120x120q90.jpg_.webp"
        }
    ]
}

This endpoint returns stock and pricing for all variations of a particular product.

The property mapping information can be found by cross mapping the Product Detail response.

Parameter Type Default Description Allowed Values
productId string empty The product ID to retrieve.
country string US The country that the product will be shipped to. (See supported ship to countries below)
quantity integer 1 The amount that will be shipped.

Get Product HTML Description

POST /v1/products/description/html HTTP/1.1
{
    "productId": "32826897725"
}

The above command returns JSON structured like this:

{
    "description": "<kse:widget data-widget-type=\"relatedProduct\" id=\"34324485\" title=\"Dress\" type=\"relation\"></kse:widget> <h1 style=\"text-align: center;\"> Hot Summer beach Dress Sexy Women Casual Sleeveless Beach Short Dress Tassel Solid White Mini Lace Dress Plus Size Drop Shipping </h1> <p align=\"left\"> <span style=\"font-family:Arial;font-size:large;\"><b><span style=\"font-style:italic;background-color:#FF6699;\">Item specifics</span></b></span></p> <ul>  <li> <p align=\"left\" style=\"margin:10px;\"> <span style=\"font-size:11pt;background-color:#FFFFFF;font-family:Arial;\">Gender:Women</span> </p> </li>  <li> <p align=\"left\" style=\"margin:10px;\">"
}

This endpoint returns the HTML product description as seen on the AliExpress.

The description will be returned in HTML which means that there can be embedded images and HTML formatting.

Parameter Type Default Description Allowed Values
productId string null The product ID to retrieve.

Get Product Transaction History

POST /v1/products/transactions HTTP/1.1
{
  "productId": "32826897725",
  "page": 1
}

The above command returns JSON structured like this:

{
    "count": 1039,
    "transactions": [
        {
            "id": "98290654042210",
            "name": "P***.",
            "countryCode": "fr",
            "quantity": 1,
            "date": "2019-01-29T07:46:00Z",
            "unit": "piece"
        },
        {
            "id": "98526313392210",
            "name": "P***.",
            "countryCode": "fr",
            "quantity": 1,
            "date": "2019-01-29T07:44:00Z",
            "unit": "piece"
        }
    ]
}

This endpoint returns the transaction history of an item on AliExpress.

The recent transactions includes the date of the transaction and the quantity purchased, along with the country code of the customer.

Parameter Type Default Description Allowed Values
productId string null The product ID to retrieve.
page integer 1 The page to retrieve [1-50]

Ordering API

The Ordering API allows create and retrieving orders. You can place orders on behalf of merchants that are registered to your Aliseeks account. Each merchant registered will be assigned a unique Merchant ID. You can register a merchant through Aliseeks.com or by using the Register Merchant endpoint.

How to Onboard a Merchant

Single Merchant per Account

  1. Join the AliExpress Dropshipping Program. dropshipping

  2. Onboard a merchant through the Aliseeks Console. slack

  3. The Merchant ID is provided on the Aliseeks Console. slack

Multiple Merchants per Account

  1. Make sure all your merchants have agreed to the join the AliExpress Dropshipping Program. dropshipping
  2. Onboard a merchant by redirecting to the URL provided in Register Merchant.
  3. Persist the Merchant ID returned by the Register Merchant API.

Create Order

This is only a sample request, do not use this in production. Fill in the request body with a known address, phone number and correct product information.

POST /v1/orders HTTP/1.1
{
    "merchantId": "YOUR_MERCANT_ID",
    "locale": "en_US",
    "mailingAddress": {
        "contactName": "John Modena",
        "phoneNumber": {
            "number": "7137398000",
            "countryPrefix": "+1"
        },
        "address": {
            "line1": "1600 Lamar St",
            "line2": "",
            "city": "Houston",
            "state": "Texas",
            "country": "US",
            "postalCode": "77010"
        }
    },
    "items": [
        {
            "productId": 32690828906,
            "quantity": 1,
            "shippingService": "YANWEN_JYT",
            "properties": [
                {
                    "sku": "14:29#clear"
                },
                {
                    "sku": "200000061:1454#6x8mm  70pcs"
                }
            ]
        }
    ]
}

The above command returns JSON structured like this:

{
    "merchantId": "YOUR_MERCHANT_ID",
    "orderIds": [
        101274465122817
    ]
}

Creates an order on AliExpress. The order will be created under the account associated with the Merchant ID. The order will not be paid, the AliExpress account owner will need to click on "Pay Now" to complete the transaction, they can pay with any payment method they would prefer.

Use case - Create an Order Guide.

Parameter Type Default Description Allowed Values
merchantId string empty The Merchant ID to use when fetching the order.
locale Locale en_US The locale that the item is being purchased from. Supported Locales
mailingAddress MailingAddress null Mailing address information for the order.
items OrderLineItem[] null List of line items for the order.

Get Order

GET /v1/orders?merchantId=AjbjasWsnzse&orderId=828752957 HTTP/1.1

The above command returns JSON structured like this:

{
    "id": "828752957xxx",
    "created": "2017-03-29T00:07:56Z",
    "total": {
        "currency": "USD",
        "value": "71.78"
    },
    "status": "order_completed",
    "shippingStatus": "shipped",
    "store": {
        "id": "718232",
        "name": "BIG TREE TECH Store",
        "url": "https://www.aliexpress.com/store/718232"
    },
    "shipping": [
        {
            "trackingNumber": "DH002886407AE",
            "shippingService": "CAINIAO_STANDARD"
        },
        {
            "trackingNumber": "LP00068298585456",
            "shippingService": "CAINIAO_STANDARD"
        }
    ],
    "items": [
        {
            "productId": 32602496788,
            "quantity": 2,
            "name": "50PCS 3D Printer Prusa Mendel 12v40w 6*20 Cartridge Heater Reprap 12V 40W WITH Free Shipping",
            "price": {
                "currency": "USD",
                "value": "38.89"
            }
        }
    ]
}

Fetches the information for a particular Order.

Parameter Type Default Description Allowed Values
merchantId string empty The Merchant ID to use when fetching the order.
orderId string empty The Order ID to retrieve information about.

Get Tracking Information

Being implemented - Coming soon!

Are you interested? Send us an email and let us know you want this.

Register Merchant

POST /v1/merchants HTTP/1.1
{
  "redirectUrl": "https://your-domain.com/accounts/merchants",
  "merchantId": "ExistingMerchantId"
}

Please make sure to save the merchantId returned by this API as you will need it to interact with an account. The above command returns JSON structured like this:

{
  "merchantId": "AjbjasWsnzse",
  "redirectUrl": "https://redirect-your-customer-here.com"
}

This endpoint allows registration of merchant accounts through the API. Merchants can usually only be registered through the Aliseeks Console, however your account may be whitelisted to use this endpoint to allow registering more than one merchant on your account.

To register a customer account and allow placing automated orders, call this endpoint and provide a redirectUrl which we will use to redirect your customer after receiving Authorization to allow Aliseeks to place orders on their behalf.

Redirect your customer to the redirectUrl provided in the response. Do not reuse this redirectUrl between customers. It can only be used once.

Be sure to save the merchantId in the response so you can use it to place or get orders on behalf of this customer. You can optionally pass in a merchantId if you are re-authorizing your customer.

Parameter Type Default Description Allowed Values
redirectUrl string empty The URL that the customer will be redirected to after authorizing Aliseeks to access their AliExpress account.
merchantId string empty Optional - Can be used when re-authorizing a customer to keep a consistent Merchant ID between re-authorizations

Types

Range

Simple range

{
  "from": 5,
  "to": 10
}

Ranges are usually integers but can be doubles

{
  "from": 5.2,
  "to": 10.5
}

A Range type is used to define a to and from range.

The fields of the Range type are to and from.

Ranges are usually inclusive.

Currency

Example of a currency

{
  "currency": "GBP"
}

Currency is represented by a currency code string.

Depending on whether you are calling a realtime or non-realtime endpoint, the allowed currency codes will be different.

Supported Realtime Currencies

AUD, BRL, CAD, CHF, CLP, EUR, GBP, IDR, KRW, MXN, NZD, PLN, RUB, SEK, SGD, TRY, UAH, USD

Supported non-Realtime Currencies

AUD, BRL, CAD, CHF, CLP, CNY, EUR, GBP, IDR, INR, JPY, KRW, MXN, NZD, PLN, RUB, SEK, SGD, TRY, UAH, USD

Locale

Example of a locale

{
  "locale": "fr_FR"
}

Locale is represented by a locale string.

Locale's are used to represent both language code and country code. The first two characters of a locale string is the language code and the last two characters are the country code. Click here to see a list of locale's globally.

Only a small subset of the global locales can be used in the Aliseeks API.

Supported Locales

ar_SA, de_DE, en_US, es_ES, fr_FR, he_IL, ko_KR, pl_PL, pt_BR, ru_RU, tr_TR

Freight Types

Example of a freight type

{
  "freight": "ePacket"
}

Freight type is represented by a freight type string.

Freight types are used to filter or retrieve items by the offered freight methods (shipping methods) of a particular item.

Supported Freight Types

MailingAddress

Example of a mailing address

{
  "contactName": "John Smith",
  "fullName": "John Smith",
  "taxNumber": "12345",
  "phoneNumber": {
    "number": "777-777-7777",
    "countryPrefix": "+1"
  },
  "address": {
    "line1": "12345 Jolly St",
    "line2": "APT 1234",
    "city": "Denver",
    "state": "Colorado",
    "country": "US",
    "postalCode": "80123"
  }
}

A mailing address defines all the components needed to mail an item to a particular location.

Parameter Type Default Description Allowed Values
contactName string empty Required The name of the individual at the address
fullName string empty Additional name of the individual at the address
taxNumber string empty Tax identification number associated with the address
phoneNumber.number string empty Required The phone number for the address
phoneNumber.countryPrefix string empty Required The country prefix for the address
address.line1 string empty Required The primary street level address, e.g. 12345 Jolly St
address.line2 string empty Required The secondary street level address, e.g. APT 12345
address.city string empty Required The city of the address
address.state string empty Required The state/providence of the address
address.country string empty Required The country code of the address, must be ISO 2 Character.
address.postalCode string empty The postal code of the address.

OrderLineItem

Example of an order line item

{
  "productId": 32844651460,
  "quantity": 1,
  "shippingService": "YANWEN_JYT",
  "properties": [
    {
      "id": "200009570",
      "value": "350262"
    }
  ]
}

An order line item defines a specific line item in an order. The shipping service can be retrieved from calling Get Product Shipping. The properties are also referred to as sku properties are the identifiers that define an AliExpress sku and can be retrieved from calling Get Product.

Parameter Type Default Description Allowed Values
productId number empty Required The AliExpress product ID of the item
quantity number empty Required The number of the item
shippingService number empty Required The shipping service to use to ship the item, can be retrieved from Get Product Shipping.
properties property[] empty Required List of sku identifiers that define a product variation, can be retrieved from Get Product.

Errors

Typical error response (in this case the request is missing productId)

POST /v1/search HTTP/1.1
x-error-code: NotNull
x-error-detailed-message: NotNull may not be null
[
    {
        "code": "NotNull",
        "field": "productId",
        "violation": "NotNull may not be null"
    }
]

Anything other than a 200 response status code will indicate an error.

Sometimes, you may get back strange responses with a 200 response. If this is the case, please retry your request and let us know if you see persistant problems.

Errors can be read from the JSON body response of the API or can be read off of the headers: x-error-code, x-error-detailed-message .

WARNING: This API is not very mature yet and things may change or not work properly. This API may cease to operate at any point in time without warning. You assume all risks associated with using this API.