AliExpress API: Get product details (v1)

Returns one product by product_id or product URL: every variant with its price and stock, shipping to country, store, rating and properties. data is null when the product does not exist or is not sold to country.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

product_id*string

The product id from a search result's product_id, or a product URL such as https://www.aliexpress.com/item/1005010225936968.html.

Length6 <= length <= 2000

country?string

Ship-to country as an ISO 3166-1 alpha-2 code. It prices shipping and decides availability: a product not sold to this country returns data: null.

Match^[A-Za-z]{2}$

Length2 <= length <= 2

Default"US"

currency?string

ISO 4217 currency for every price in the response.

Match^[A-Za-z]{3}$

Length3 <= length <= 3

Default"USD"

curl -X GET "https://example.com/v1/aliexpress/product?product_id=1005010225936968" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "product_id": "string",    "url": "string",    "title": "string",    "category_id": 0,    "category_path": [      "string"    ],    "images": [      "string"    ],    "currency": "USD",    "price": 1.09,    "price_formatted": "string",    "price_min": 0,    "price_max": 0,    "rating": 4.9,    "review_count": 103,    "sales_summary": "string",    "wishlist_count": 0,    "in_stock": true,    "store": {      "name": "Stone's Store",      "store_id": 1103573332,      "seller_id": 0,      "url": "string",      "country": "China",      "opened": "2024-03-01 00:05:27",      "positive_feedback_percent": 100,      "top_rated": true,      "scores": {        "property1": "string",        "property2": "string"      }    },    "properties": [      {        "name": "string",        "value": "string"      }    ],    "options": [      {        "id": 0,        "name": "Color",        "values": [          {            "id": 0,            "name": "Black",            "image": "string"          }        ]      }    ],    "variants": [      {        "sku_id": "string",        "attributes": {          "Color": "Black",          "Compatible Model": "iPhone 15"        },        "price": 1.09,        "price_formatted": "string",        "stock": 88,        "available": true      }    ],    "shipping": [      {        "method": "AliExpress Selection Standard Shipping",        "fee": 1.99,        "fee_formatted": "string",        "free": true,        "ship_from": "China",        "ship_to": "US",        "delivery_days_min": 0,        "delivery_days_max": 0,        "tracking": true      }    ],    "description_url": "string"  },  "details": {    "reason": "string",    "message": "string"  }}