# AliExpress Product API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/aliexpress-api/aliexpress_product](https://scrappa.co/docs/aliexpress-api/aliexpress_product) - **API group:** AliExpress API - **Endpoint:** `GET https://scrappa.co/api/aliexpress/product` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `product_id` | string | Yes | AliExpress product number of 6 to 20 digits, e.g. 3256812407941674. Take it from the product_id of a search result. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A parameter is missing or invalid. This response is not billable. | | 404 | Resource Not Found | The product or store does not exist. This response is not billable. | | 503 | Service Unavailable | AliExpress could not be reached. Retry after a short pause. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)