COMMERCE_SERP with site aliexpress to get the products a search shows, in the store’s order. COMMERCE_PRODUCT does not read this store’s product pages. A completed search costs 0.5 credits.
Search
GET /v1/async/task/{id} or receive its webhook. See Async tasks.
Parameters
site: Required.aliexpress.query: Required. The search query, 1-500 characters.limit: Optional integer from 1 to 40, default 20.country: Optional. Defaults toUS, the store’s country. Any other country is rejected with422 REGION_UNSUPPORTED.
include: even include: {} returns 422 VALIDATION_ERROR on payload.include before credits are held.
Response example
Result fields
site,queryandcountryecho the request.returnedCountis the number of entries inproducts.- Each product includes
rank,productId,titleandurl.productIdis the store’s own product ID.rankfollows the store’s default order, and listings the store marks as sponsored are left out. price,ratingandimageUrlappear when the results page shows them.priceis a number in the product’scurrency(ISO 4217); when sizes are priced apart, it is the lowest one. AliExpress prices are the sale prices shown to a signed-out shopper in the US.ratinguses a five-point scale. AliExpress shows stars without a rating count, so its products carry noreviewCount.- Each search returns products from the store’s first results page.
Errors and billing
- A search that returns no products ends as a failed task.
- Only completed searches are charged, 0.5 credits each.