Skip to main content
Search AliExpress (aliexpress.com) through the async task API. Send 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.
Submit the task, then poll 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 to US, the store’s country. Any other country is rejected with 422 REGION_UNSUPPORTED.
Only the payload fields listed above are accepted. Omit include: even include: {} returns 422 VALIDATION_ERROR on payload.include before credits are held.

Response example

Result fields

  • site, query and country echo the request. returnedCount is the number of entries in products.
  • Each product includes rank, productId, title and url. productId is the store’s own product ID. rank follows the store’s default order, and listings the store marks as sponsored are left out.
  • price, rating and imageUrl appear when the results page shows them. price is a number in the product’s currency (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.
  • rating uses a five-point scale. AliExpress shows stars without a rating count, so its products carry no reviewCount.
  • 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.