AliExpress API — Getting Started — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Getting Started

Search in a market you choose, keep the product ids you care about, then poll their prices and follow their reviews — three requests, all JSON.

1. Get your API key

Create an account and generate a FetchLayer API key from your dashboard. There is no AliExpress affiliate program to join and no open-platform app key to request.

Create free account →

2. Search in a pinned market

bash
curl -X POST https://api.fetchlayer.dev/aliexpress/search-products \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"mechanical keyboard","shipTo":"US","currency":"USD","language":"en_US"}'

One page is 60 products, each with its productId, price and original price, discount, rating, sold count, ship-from country and category id. The response echoes the market it was read in. Currencies USD, EUR, GBP, CAD, AUD, NZD, BRL, MXN, CLP, COP, PEN, ARS, JPY and KRW, and languages en_US, de_DE and pt_BR are accepted; anything else is a 400.

Tip

Walk further with pages (each page counts as one request), or pass nextCursor back as cursor. Consecutive pages can repeat a product, so de-duplicate by productId.

3. Check prices in one request

bash
curl -X POST https://api.fetchlayer.dev/aliexpress/product-prices \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"products":["1005009494458560","1005006994630464"],"shipTo":"US","currency":"USD"}'

Up to 20 products per request, each back in request order with its own status: ok, unavailable, not_found, or failed — which means check that one again later. Pass { "product": "…", "skuId": "…" } to track one variant; the skuIds are on /product-details.

Retry a 503 here

Product details and price checks depend on lookups AliExpress refuses in bursts, so an occasional 503 is temporary: wait and retry. Search and reviews are not affected. Keep shipTo and currency fixed between checks — a price in another market is a different price, not a change.

4. Follow the reviews

bash
curl -X POST https://api.fetchlayer.dev/aliexpress/product-reviews \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"product":"1005009494458560","sort":"latest","shipTo":"US","language":"en_US"}'

Twenty reviews per page with the star distribution, each with the text translated into your language and the reviewer's original words, country, the variant bought and any seller reply. Many AliExpress reviews are a rating with no text.

Tip

Have a link rather than an id? /resolve-url turns any AliExpress URL into the product id, variant id, search query or category id the other endpoints take. It makes no upstream request and does not consume a credit.

Next steps