docs / aliexpress
AliExpress
Product search, prices, variants, reviews and shipping.
base /aliexpress/v19 endpoints
post
/aliexpress/v1/search1 creditProduct search cards (price, sold_count, rating, store); filters sort/min_price/max_price/ship_from/free_shipping, paginated
| Parameter | Required |
|---|---|
| query | optional |
| country | optional |
| currency | optional |
| page | optional |
| max_pages | optional |
| sort | optional |
| min_price | optional |
| max_price | optional |
| ship_from | optional |
| free_shipping | optional |
post
/aliexpress/v1/product_detail1 creditFull product + SKU-variant price matrix + specs + images + store + shipping + rating
| Parameter | Required |
|---|---|
| product_id | optional |
| url | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/reviews1 creditBuyer reviews + rating distribution
| Parameter | Required |
|---|---|
| product_id | optional |
| url | optional |
| page | optional |
| page_size | optional |
| filter | optional |
| review_sort | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/description1 creditFull product description text + images
| Parameter | Required |
|---|---|
| product_id | optional |
| url | optional |
| description_url | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/shipping1 creditShipping options per destination country
| Parameter | Required |
|---|---|
| product_id | optional |
| url | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/store_info1 creditStore profile (+ live seller metrics when a query is supplied)
| Parameter | Required |
|---|---|
| store_id | optional |
| store_url | optional |
| query | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/store_items1 creditStore catalog items (keyword-scoped to the store; shopId alone lists nothing)
| Parameter | Required |
|---|---|
| store_id | required |
| query | required |
| page | optional |
| max_pages | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/store_categories1 creditStore category tree
| Parameter | Required |
|---|---|
| store_id | optional |
| store_url | optional |
| country | optional |
| currency | optional |
post
/aliexpress/v1/deals1 creditSuperDeals / discounted cards (search-derived, sorted by discount)
| Parameter | Required |
|---|---|
| query | required |
| min_discount | optional |
| sort | optional |
| page | optional |
| max_pages | optional |
| country | optional |
| currency | optional |
Example request · search
curl -X POST https://api.reefapi.com/aliexpress/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"wireless earbuds","country":"US","currency":"USD"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}