Search
AliExpress search — accepted parameters and what comes back.
GET|POST /v1/aliexpress/searchPrice $0.001 per call. List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
query | string | yes | Keywords. Required — AliExpress keyword search cannot be asked anything without words. |
categoryId | string | AliExpress category id; narrows the search. | |
currency | string | Presentment currency. | |
language | string | Presentment language. | |
page | integer ≥ 1 | 1-based page number. | |
pageSize | integer ≥ 1 | Results per page, 1-50. | |
priceMax | number ≥ 0 | Highest price to return, in decimal major units. | |
priceMin | number ≥ 0 | Lowest price to return, in decimal major units. | |
region | string | Buyer country (ISO 3166-1 alpha-2); sets shipping and availability. | |
sort | enum | Result ordering, in the shared vocabulary. price_asc price_desc best_seller |
curl "https://gateway.apinoa.com/v1/aliexpress/search?query=wireless+earbuds&priceMin=10&priceMax=40&sort=price_asc" \
-H "x-api-key: YOUR_API_KEY"AliExpress honours currency and language; other marketplaces localize by region.
No cursor — paging is by number. No brands, ratingMin, condition, freeShipping or
inStock: AliExpress search has no filter for any of them.
No best_match or newly_listed sort — AliExpress publishes no code for either.