docs / aliexpress

AliExpress

Product search, prices, variants, reviews and shipping.

base /aliexpress/v19 endpoints

post/aliexpress/v1/search1 credit

Product 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

Try in playground →

post/aliexpress/v1/product_detail1 credit

Full product + SKU-variant price matrix + specs + images + store + shipping + rating

Parameter	Required
product_id	optional
url	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/reviews1 credit

Buyer reviews + rating distribution

Parameter	Required
product_id	optional
url	optional
page	optional
page_size	optional
filter	optional
review_sort	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/description1 credit

Full product description text + images

Parameter	Required
product_id	optional
url	optional
description_url	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/shipping1 credit

Shipping options per destination country

Parameter	Required
product_id	optional
url	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/store_info1 credit

Store profile (+ live seller metrics when a query is supplied)

Parameter	Required
store_id	optional
store_url	optional
query	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/store_items1 credit

Store 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

Try in playground →

post/aliexpress/v1/store_categories1 credit

Store category tree

Parameter	Required
store_id	optional
store_url	optional
country	optional
currency	optional

Try in playground →

post/aliexpress/v1/deals1 credit

SuperDeals / 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

Try in playground →

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
}