AliExpress Product API Documentation Get one AliExpress product: title, web url, category id, images, video, price range, rating, sales count, review count and stock. Variants list every combination with its own price, original price, discount and stock. sku_properties describes the options such as color and size. The response also holds specs, shipping terms, package size and weight, highlights, policies, the seller block with seller_id and store_id, questions and answers, and a description_ref for the description endpoint. Use seller_id and store_id with the store endpoints. Currency and language follow the market of the request, so they can differ between calls. Failed requests are never charged. An unknown product answers 404.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
AliExpress product number of 6 to 20 digits, e.g. 3256812407941674. Take it from the product_id of a search result.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"qa": {
"questions": [
{
"answer": "You have to buy one of each, it's not a pack.",
"asked_at": "11 Sep 2026",
"question": "How do I order 5 of each model... or do I need to make multiple purchases?",
"answered_at": "20 Sep 2026",
"answer_count": 1
}
],
"total_count": 1
},
"url": "https://www.aliexpress.com/item/1005012594256426.html",
"price": {
"max": 4.25,
"min": 1.42,
"currency": "USD",
"discount": "50% off",
"formatted_max": "$4.25",
"formatted_min": "$1.42",
"formatted_original": "$2.84"
},
"specs": [
{
"name": "High-concerned chemical",
"value": "none"
},
{
"name": "Features",
"value": "Anti-Scratch"
}
],
"stock": {
"in_stock": true,
"total_available": 14011
},
"title": "INS Korean Polka Dots Dopamine Soft TPU Phone Case for iPhone 18 17 16 15 14 13 12 Pro Max 16E 17E 18 Pro Silicone Cream Cover",
"video": {
"url": "https://video.aliexpress-media.com/play/u/ae_sg_item/3000004200160/p/1/e/6/t/10301/5000591842012.mp4",
"poster_url": "https://ae-pic-a1.aliexpress-media.com/kf/S008b02d1309f4e52958f2a9913948e78K.jpg"
},
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/S34be593b88f0488ca16b517948db9201i.jpg_960x960.jpg_.webp",
"https://ae-pic-a1.aliexpress-media.com/kf/Se0a49749fe624caf9f121c76afd9aa6c7.jpg_960x960.jpg_.webp"
],
"rating": {
"average": 4.9,
"sold_text": "3,000+",
"positive_rate": 98
},
"seller": {
"benefits": [
{
"title": "positive reviews",
"value": "100.0%"
}
],
"logo_url": "https://ae-pic-a1.aliexpress-media.com/kf/Se90fceedf9d34ad1a8979283c98a1e45I/144x144.png",
"store_id": "1103573332",
"seller_id": "2678280160",
"store_name": "Stone's Store",
"is_top_rated": false,
"is_local_seller": false
},
"package": {
"width_cm": 12,
"height_cm": 1,
"length_cm": 18,
"weight_kg": 0.046,
"processing_days": 7
},
"policies": [
"Free returns within 90 days",
"Fast delivery"
],
"shipping": {
"fee": 1.99,
"notes": [
"Tracking available",
"Delivery: Oct 25 - 30"
],
"method": "AliExpress Selection Standard",
"tracking": true,
"ship_from": "China",
"formatted_fee": "$1.99",
"ship_to_country": "US",
"delivery_days_max": 11,
"delivery_days_min": 6,
"delay_compensation": "$1.00",
"estimated_delivery": {
"to": "Oct. 30",
"from": "Oct. 25"
},
"free_shipping_threshold": null
},
"variants": [
{
"price": {
"amount": 1.99,
"currency": "USD",
"discount": "53% off",
"formatted": "$1.99",
"original_amount": 4.27,
"formatted_original": "$4.27"
},
"stock": 2,
"sku_id": "12000060187897503",
"options": {
"Color": "FE-T6128",
"Compatibility by Model": "iPhone 16 Pro Max"
},
"in_stock": true,
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S0a2d16ef569d4b6aa9850e903d5bd3b8e.jpg_640x640.jpg_.webp",
"stock_text": "Only 2 left",
"max_per_order": 1
},
{
"price": {
"amount": 1.99,
"currency": "USD",
"discount": "50% off",
"formatted": "$1.99",
"original_amount": 4.04,
"formatted_original": "$4.04"
},
"stock": 282,
"sku_id": "12000060187897502",
"options": {
"Color": "FE-T6128",
"Compatibility by Model": "iPhone 15 Pro"
},
"in_stock": true,
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S0a2d16ef569d4b6aa9850e903d5bd3b8e.jpg_640x640.jpg_.webp",
"stock_text": "In stock",
"max_per_order": 1
}
],
"highlights": [
"245 people gave it a positive review"
],
"product_id": "1005012594256426",
"category_id": "202229403",
"trade_count": 3990,
"review_count": 61,
"sku_properties": [
{
"id": "14",
"name": "Color",
"values": [
{
"id": "10",
"name": "TL-T6126",
"color": "#FF0000",
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sb8917597b08046b1b5279cfa1a43fac4o.jpg_640x640.jpg_.webp"
},
{
"id": "29",
"name": "NH-T6127",
"color": "#FFFFFF",
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S89ac12d4040f4dd8802e4d4609f1b503C.jpg_640x640.jpg_.webp"
}
]
},
{
"id": "263619383",
"name": "Compatibility by Model",
"values": [
{
"id": "46471973",
"name": "iPhone 15",
"color": null,
"image_url": null
},
{
"id": "12870894957",
"name": "iPhone 13 Pro",
"color": null,
"image_url": null
}
]
}
],
"description_ref": "MTAwNTAxMjU5NDI1NjQyNnxTN2E4NmVjMjU3MjgwNDk5NjlhNGUwNTIyYTMwMTNjZjViLmpzb258ODMzYzIwNjJlNzM4ZWQ0OWE3MTcwNDQ2ODIzZWIzMTl8MjY3ODI4MDE2MA"
},
"meta": {
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"product_id": [
"The product_id must be an AliExpress product number of 6 to 20 digits."
]
},
"message": "The request validation failed"
}Resource Not Found
The product or store does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "NOT_FOUND",
"message": "The requested AliExpress resource was not found."
},
"success": false
}Service Unavailable
AliExpress could not be reached. Retry after a short pause. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "AliExpress is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.