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.
Search
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 toKR, 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.
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, sponsored listings included. price,rating,reviewCountandimageUrlappear 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.ratinguses 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.