> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupang API

> Busca productos en la tienda Coupang como JSON: posiciones con precios, valoraciones y número de reseñas, en el orden en que la tienda los muestra.

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

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "coupang", "query": "airpods", "limit": 3 } }'
```

Envía la tarea y luego consulta `GET /v1/async/task/{id}` o recibe su webhook. Consulta [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

### 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

* [Olive Young](https://docs.querying.ai/es/engines/oliveyoung.md)
* [11st](https://docs.querying.ai/es/engines/11st.md)
* [Lotte ON](https://docs.querying.ai/es/engines/lotteon.md)
* [Todas las tiendas de Commerce](https://docs.querying.ai/es/engines/overview.md#commerce)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.