AliExpress Search API
Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response.
Pricing and providers
AliExpress Search API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get AliExpress search in one request
{
"data": {
"items": [
{
"currency": "USD",
"deliveryDaysMax": 42,
"deliveryDaysMin": 42,
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"isChoice": true,
"isSponsored": true,
"listedUtc": 12.5,
"originalPrice": 19.99,
"price": 19.99,
"productId": "a1b2c3d4",
"rating": 4.6,
"shipFrom": "example",
"skuId": "a1b2c3d4",
"soldCount": 12500,
"storeName": "Example title",
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-23 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- querystring
minecraft room projector
Search keywords, e.g. "wireless earbuds".
- countrystring
Ship-to country as a 2-letter ISO code, e.g. US or DE. It changes prices, availability and delivery estimates.
- currencystring
Price currency as a 3-letter ISO code, e.g. USD or EUR.
- maxPricenumber
Optional maximum product price, in the requested currency.
- minPricenumber
Optional minimum product price, in the requested currency.
- pageinteger
1-based results page of about 60 products; AliExpress serves no results past page 60. Each page is billed as one request.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `shipFrom`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- sortenum
Result order: best_match (AliExpress relevance, the default), best_seller (most orders first), price_low, or price_high.
Response
JSON, one example value per field.
Matching AliExpress product cards for the requested page. Populated whenever the provider has data for the entity.
- currencystring
Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.
- deliveryDaysMaxintegercan require
Most days the estimated delivery to the requested country takes, or null when not reported.
- deliveryDaysMinintegercan require
Fewest days the estimated delivery to the requested country takes, or null when not reported.
- imagestring
Primary product image URL, or null when the card shows none. Populated whenever the provider has data for the entity.
- imagesstring[]
Every product image URL the card carries, primary first; empty when the card shows none.
- isChoicebooleancan require
True when the product carries the AliExpress Choice badge, or null when the serving source does not report it.
- isSponsoredboolean
True when the card is a paid placement, or null when not reported.
- listedUtcnumbercan require
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. The day the product was first listed, as midnight UTC of that date; null when the serving source does not report it.
- originalPricenumber
Price before the current discount, or null when the product is not discounted.
- pricenumber
Current price in the requested currency, or null when the card shows no price. Populated whenever the provider has data for the entity.
- productIdstring
AliExpress product id, the number in the product URL; pass it to the AliExpress Product or AliExpress Reviews SKU. Populated whenever the provider has data for the entity.
- ratingnumber
Average customer rating, 0-5, or null when the product is unrated.
- shipFromstringcan require
2-letter ISO code of the country the product ships from, e.g. "CN", or null when not reported.
- skuIdstring
Id of the product variant the card's price is for, or null when not reported.
- soldCountinteger
Number of units sold, or null when not shown. One source reads it from AliExpress's rounded label, so "60,000+ sold" comes back as 60000. Populated whenever the provider has data for the entity.
- storeNamestringcan require
Name of the store selling the product, or null when the card does not show it.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
AliExpress product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Search result wrapper, or null when nothing matched.
- totalResultsintegercan require
Total products AliExpress reports for the search, or null when the serving source does not report it.
- foundboolean
True when the search returned at least one product.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the AliExpress Search API
The AnyAPI AliExpress Search API returns AliExpress search data as normalized JSON from one POST call to /v1/run/aliexpress.search. Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $0.85 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of AliExpress search calls through AnyAPI succeeded, with a median response time of 3.2 seconds across 1 measured calls.