Saltar al contenido principal
Busca productos en la tienda Coupang (coupang.com) mediante la API de tareas asíncronas. Envía COMMERCE_SERP con site coupang para recibir los productos que muestra una búsqueda, en el orden de la tienda. COMMERCE_PRODUCT no lee las páginas de producto de esta tienda. Cada búsqueda completada cuesta 2 créditos.

Búsqueda

Envía la tarea y luego consulta GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.

Parámetros

  • site: Obligatorio. coupang.
  • query: Obligatorio. Consulta de búsqueda, de 1 a 500 caracteres.
  • limit: Entero opcional de 1 a 40, con 20 por defecto.
  • country: Opcional. Por defecto, KR, el país de la tienda. Cualquier otro país se rechaza con 422 REGION_UNSUPPORTED.
Solo se aceptan los campos de payload enumerados arriba. Omite include: incluso include: {} devuelve 422 VALIDATION_ERROR en payload.include antes de reservar créditos.

Campos del resultado

  • site, query y country repiten la solicitud. returnedCount es el número de elementos de products.
  • Cada producto incluye rank, productId, title y url. productId es el ID de producto propio de la tienda. rank sigue el orden predeterminado de la tienda, con los anuncios patrocinados incluidos.
  • price, rating, reviewCount e imageUrl aparecen cuando la página de resultados los muestra. price es un número en la currency del producto (ISO 4217); cuando los tamaños tienen precios distintos, es el más bajo.
  • rating usa una escala de cinco puntos. Los números de reseñas abreviados, como 999+, se omiten.
  • Cada búsqueda devuelve productos de la primera página de resultados de la tienda.

Errores y facturación

  • Una búsqueda que no devuelve productos termina como tarea fallida.
  • Solo se cobran las búsquedas completadas, a 2 créditos cada una.

Relacionado