E-commerce & Marketplaces

AliExpress API

The AliExpress API returns product search, full detail and store data as clean JSON.

10 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns products with id, title, URL, images, price, original price, discount, units sold and rating, and you can pull a product_detail with SKUs, reviews, similar products, description, shipping options, a store's info, items and categories, and current deals. It is built for price research, dropshipping and catalog tools that need AliExpress data without scraping a heavily-defended marketplace. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/aliexpress/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "wireless earbuds",
    "country": "US",
    "currency": "USD"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "aliexpress",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1561.2,
    "record_count": 60,
    "bytes": 736717,
    "cache_hit": false,
    "version": "0.1",
    "page": 1,
    "pagination": {
      "page": 1,
      "has_more": true
    }
  },
  "data": {
    "query": "wireless earbuds",
    "country": "US",
    "currency": "USD",
    "results": [
      {
        "product_id": "[redacted-phone]",
        "title": "Baseus Bass EP10 NC -43dB Noise Cancelling ANC True Wireless Earbuds Bluetooth 6.0 In-Ear Wireless Earphones 4-Mics ENC Ear buds",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/Sa802af2e290b4ffdb151cacc25733ef8x.jpg",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/Sa802af2e290b4ffdb151cacc25733ef8x.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sa71cf8de22bb44808f92748d95d1413dt.png",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sa73b727b92734a5bb1ac082531d50829Z.png"
        ],
        "price": 13.75,
        "original_price": 44.43,
        "currency": "USD",
        "discount_pct": 69,
        "price_formatted": "US $13.75",
        "sold_count": 10000,
        "sold_text": "10,000+ sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "New shoppers save $30.68",
          "Lowest price in 90 days"
        ],
        "sku_id": "[redacted-phone]"
      },
      {
        "product_id": "[redacted-phone]",
        "title": "QCY T13 ANC Active Noise Cancelling Wireless Earbuds Bluetooth 5.3 Headphones 4 Mics ENC Clear Calls Earphones 30H Playtime IPX5",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/S5fdfcad8a1a24f919f7734a805f46c84l.jpg",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/S5fdfcad8a1a24f919f7734a805f46c84l.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S46d0988a85bc42a38eb4155c50f516c26.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S66d59a917dd943caa4d014993d4215c6O.jpg"
        ],
        "price": 26.39,
        "original_price": 55.34,
        "currency": "USD",
        "discount_pct": 52,
        "price_formatted": "US $26.39",
        "sold_count": 5000,
        "sold_text": "5,000+ sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "Save $28.95",
          "Delivery: Jul 24 - 29"
        ],
        "sku_id": "[redacted-phone]"
      },
      {
        "product_id": "[redacted-phone]",
        "title": "Bluetooth headset TWS hands-free LED Dispay headset Bluetooth HiFi stereo music wireless earplug game headset",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/S2b686cc68e564b6e83fb2a593aaa0f4fT.jpg",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/S2b686cc68e564b6e83fb2a593aaa0f4fT.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sa90e58eeca6c415885f6fab146615b63y.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sbc5bb29cba2c4a81b05a7a8bf5b8c993c.jpg"
        ],
        "price": 0.33,
        "original_price": 7.95,
        "currency": "USD",
        "discount_pct": 95,
        "price_formatted": "US $0.33",
        "sold_count": 5000,
        "sold_text": "5,000+ sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "Save $7.62",
          "Delivery: Jul 24 - 29"
        ],
        "sku_id": "[redacted-phone]"
      }
    ],
    "related_searches": [
      "wireless earrings earbuds",
      "aptx wireless earbuds",
      "wireless earbuds ear hook"
    ],
    "ranking_searches": [
      "wireless headphones",
      "white earbuds",
      "ear buds"
    ]
  }
}

Actions

What the AliExpress API does

Action	Description	Concrete use case	Key params
search	Product search cards (price, sold_count, rating, store); filters sort/min_price/max_price/ship_from/free_shipping, paginated	Pricing teams call search to get product search cards (price, sold_count, rating, store); filters sort/min_price/max_price/shi….	query, country, currency, page, max_pages, ...
product_detail	Full product + SKU-variant price/stock matrix + specs + images + video + store + shipping + rating + coupons + sale countdown + wishlist counts	Marketplace operators call product_detail to get full product + SKU-variant price/stock matrix + specs + images + video + store + shipping + r….	product_id, url, country, currency
reviews	Buyer reviews (paginated — fetch many pages in one call) + rating distribution	Catalog enrichment teams call reviews to get buyer reviews (paginated.	product_id, url, page, max_pages, page_size, ...
similar	Products similar to a given item (search-backed 'more like this', seed product excluded), paginated	Retail analysts call similar to get products similar to a given item (search-backed 'more like this', seed product excluded), pag….	product_id, url, query, page, max_pages, ...
description	Full product description text + images	Pricing teams call description to get full product description text + images.	product_id, url, description_url, country, currency
shipping	Shipping options per destination country	Marketplace operators call shipping to get shipping options per destination country.	product_id, url, country, currency
store_info	Store profile (+ live seller metrics when a query is supplied)	Catalog enrichment teams call store_info to get store profile (+ live seller metrics when a query is supplied).	store_id, store_url, query, country, currency
store_items	Store catalog items (keyword-scoped to the store; shopId alone lists nothing)	Retail analysts call store_items to get store catalog items (keyword-scoped to the store; shopId alone lists nothing).	store_id, query, page, max_pages, country, ...
store_categories	Store category tree	Pricing teams call store_categories to get store category tree.	store_id, store_url, country, currency
deals	SuperDeals / discounted cards (search-derived, sorted by discount)	Marketplace operators call deals to get superDeals / discounted cards (search-derived, sorted by discount).	query, min_discount, sort, page, max_pages, ...

Code samples

Call search from your stack

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"}'

import requests

r = requests.post(
    "https://api.reefapi.com/aliexpress/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "wireless earbuds",
  "country": "US",
  "currency": "USD"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/aliexpress/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "wireless earbuds",
  "country": "US",
  "currency": "USD"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.aliexpress.search with {"query":"wireless earbuds","country":"US","currency":"USD"}.

Use cases

Who uses this API and why

Dropshipping tools call search and product_detail to source products with prices, SKUs and shipping.
Price-research products use deals and reviews to find trending, well-rated items.
Catalog tools use store_items to mirror a supplier's full AliExpress inventory.

FAQ

Questions developers ask before integrating

What is the AliExpress API?

AliExpress API is a ReefAPI endpoint group for product search, prices, variants, reviews and shipping. It returns live JSON through POST requests under /aliexpress/v1.

Is the AliExpress API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. AliExpress calls use the same shared credit balance as every other ReefAPI engine.

Do I need a AliExpress login or account?

No login to AliExpress is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the AliExpress data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the AliExpress API use?

AliExpress actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call AliExpress from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call aliexpress actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the AliExpress API a AliExpress scraper?

It is the managed alternative to a DIY AliExpress scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same product search, prices, variants, reviews and shipping back as clean JSON.

Why does my AliExpress scraper keep getting blocked?

Most AliExpress scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / aliexpress

AliExpress

Product search, prices, variants, reviews and shipping.

base /aliexpress/v110 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/stock matrix + specs + images + video + store + shipping + rating + coupons + sale countdown + wishlist counts

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 (paginated — fetch many pages in one call) + 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).
max_pages = 1	optional	1–20	How many consecutive review pages to gather in one call (1–20). Combine with page_size=20 to pull all reviews of a product (e.g. max_pages=10 → up to 200 reviews).
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/similar1 credit

Products similar to a given item (search-backed 'more like this', seed product excluded), paginated

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.
query	optional	—	Optional seed keywords — overrides the product's own title (skips the detail lookup). Provide product_id/url OR query.
sort = best_match	optional	best_match · orders · price_low · price_high · newest · default · best_selling · price_asc · price_desc	Result ordering.
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/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
}