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		Allowed / range	Description
query	required	—	What to search for (product keywords).
sort = best_match	optional	best_match · orders · price_low · price_high · newest · default · best_selling · price_asc · price_desc	Result ordering.
min_price	optional	0–	Only items at or above this price (in `currency`).
max_price	optional	0–	Only items at or below this price (in `currency`).
ship_from	optional	—	Only items shipped from this country (2-letter ISO code, e.g. CN, US, ES).
free_shipping = false	optional	—	Only items with free shipping.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).
page = 1	optional	1–	Page number to start from (easy paging: 1, 2, 3…).
max_pages = 1	optional	1–10	How many consecutive pages to fetch in one call (1–10, ~48–60 results per page; larger values are capped at 10).

Try in playground →

post/aliexpress/v1/product_detail1 credit

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

Parameter		Allowed / range	Description
product_id	optional	—	AliExpress product ID — the digits in the product URL (…/item/<id>.html). Provide product_id OR url.
url	optional	—	Full product URL — alternative to product_id.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).

Try in playground →

post/aliexpress/v1/reviews1 credit

Buyer reviews + rating distribution

Parameter		Allowed / range	Description
product_id	optional	—	AliExpress product ID — the digits in the product URL (…/item/<id>.html). Provide product_id OR url.
url	optional	—	Full product URL — alternative to product_id.
filter = all	optional	all · image · additional	Which reviews to return (passed to the upstream feedback API; the 3 listed are the documented values).
page_size = 10	optional	1–20	Reviews per page (1–20; larger values are capped at 20).
review_sort = complex_default	optional	—	Upstream sort key (advanced) — leave at the default.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).
page = 1	optional	1–	Page number to start from (easy paging: 1, 2, 3…).

Try in playground →

post/aliexpress/v1/description1 credit

Full product description text + images

Parameter		Allowed / range	Description
product_id	optional	—	AliExpress product ID — the digits in the product URL (…/item/<id>.html). Provide product_id OR url.
url	optional	—	Full product URL — alternative to product_id.
description_url	optional	—	Direct description URL from a previous product_detail response (advanced — skips one lookup).
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).

Try in playground →

post/aliexpress/v1/shipping1 credit

Shipping options per destination country

Parameter		Allowed / range	Description
product_id	optional	—	AliExpress product ID — the digits in the product URL (…/item/<id>.html). Provide product_id OR url.
url	optional	—	Full product URL — alternative to product_id.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).

Try in playground →

post/aliexpress/v1/store_info1 credit

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

Parameter		Allowed / range	Description
store_id	optional	—	AliExpress store ID — the digits in the store URL (…/store/<id>). Provide store_id OR store_url.
store_url	optional	—	Full store URL — alternative to store_id.
query	optional	—	Any keyword the store sells — unlocks live seller metrics (score, positive rate, feedback count). Optional.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).

Try in playground →

post/aliexpress/v1/store_items1 credit

Store catalog items (keyword-scoped to the store; shopId alone lists nothing)

Parameter		Allowed / range	Description
store_id	required	—	AliExpress store ID — the digits in the store URL (…/store/<id>).
query	required	—	Keyword to search within the store (required — the store catalog is only reachable through a keyword).
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).
page = 1	optional	1–	Page number to start from (easy paging: 1, 2, 3…).
max_pages = 1	optional	1–10	How many consecutive pages to fetch in one call (1–10, ~48–60 results per page; larger values are capped at 10).

Try in playground →

post/aliexpress/v1/store_categories1 credit

Store category tree

Parameter		Allowed / range	Description
store_id	optional	—	AliExpress store ID — the digits in the store URL (…/store/<id>). Provide store_id OR store_url.
store_url	optional	—	Full store URL — alternative to store_id.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).

Try in playground →

post/aliexpress/v1/deals1 credit

SuperDeals / discounted cards (search-derived, sorted by discount)

Parameter		Allowed / range	Description
query	required	—	Product keywords to find deals for.
min_discount = 0	optional	0–99	Only items discounted at least this % off the original price.
sort = orders	optional	best_match · orders · price_low · price_high · newest · default · best_selling · price_asc · price_desc	How candidate items are ranked before the discount filter.
country = US	optional	—	Ship-to country (2-letter ISO code, e.g. US, DE, TR). Changes prices, availability and shipping options.
currency = USD	optional	—	Currency for prices (3-letter ISO code, e.g. USD, EUR, TRY).
page = 1	optional	1–	Page number to start from (easy paging: 1, 2, 3…).
max_pages = 1	optional	1–10	How many consecutive pages to fetch in one call (1–10, ~48–60 results per page; larger values are capped at 10).

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
}