Skip to main content
Search Coupang (coupang.com) through the async task API. Send COMMERCE_SERP with site coupang 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 2 credits.
Submit the task, then poll GET /v1/async/task/{id} or receive its webhook. See Async tasks.

Parameters

  • site: Required. coupang.
  • query: Required. The search query, 1-500 characters.
  • limit: Optional integer from 1 to 40, default 20.
  • country: Optional. Defaults to KR, 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.

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, sponsored listings included.
  • price, rating, reviewCount 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.
  • rating uses a five-point scale. Abbreviated review counts such as 999+ are left out.
  • 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, 2 credits each.