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

# Commerce Search API (COMMERCE_SERP)

> Busca en Amazon, Walmart, eBay, AliExpress, Google Shopping, Sephora, Coupang, Olive Young, Rakuten, Flipkart, Zalando y más, una tienda por tarea, y recibe productos ordenados con precio, valoración y número de reseñas en un mismo formato.

Busca los productos de una tienda y recibe la lista ordenada como JSON mediante la API de tareas asíncronas. Elige la tienda con `site`; todas las tiendas devuelven los mismos campos de producto. Cada búsqueda completada cuesta **3 créditos**.

## Solicitud

```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": "amazon", "query": "wireless earbuds", "limit": 20 } }'
```

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

## Parámetros

* `site`: Obligatorio. La tienda donde buscar, de la tabla siguiente.
* `query`: Consulta de búsqueda obligatoria, de 1 a 500 caracteres.
* `country`: Opcional. Por defecto, el país de la tienda. Cualquier otro país se rechaza con `422 REGION_UNSUPPORTED`.
* `limit`: Entero opcional de 1 a 40, con 20 por defecto.

| `site` | Tienda | `country` |
| - | - | - |
| `amazon` | amazon.com | `US` |
| `walmart` | walmart.com | `US` |
| `target` | target.com | `US` |
| `ebay` | ebay.com | `US` |
| `aliexpress` | aliexpress.com | `US` |
| `google_shopping` | shopping.google.com | `US` |
| `sephora` | sephora.com | `US` |
| `ulta` | ulta.com | `US` |
| `coupang` | coupang.com | `KR` |
| `oliveyoung` | oliveyoung.co.kr | `KR` |
| `11st` | 11st.co.kr | `KR` |
| `lotteon` | lotteon.com | `KR` |
| `musinsa` | musinsa.com | `KR` |
| `kurly` | kurly.com | `KR` |
| `rakuten` | rakuten.co.jp | `JP` |
| `yahoo_shopping` | shopping.yahoo.co.jp | `JP` |
| `qoo10` | qoo10.jp | `JP` |
| `flipkart` | flipkart.com | `IN` |
| `myntra` | myntra.com | `IN` |
| `nykaa` | nykaa.com | `IN` |
| `zalando` | zalando.de | `DE` |

## Ejemplo de respuesta

```json theme={"theme":"css-variables"}
{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}
```

## 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, como el ASIN en Amazon, el número de artículo en eBay o `shop:item` en Rakuten. `rank` sigue el orden predeterminado de la tienda. Salvo en Coupang, omite los anuncios que la tienda marca como patrocinados.
* `price`, `rating`, `reviewCount`, `imageUrl` y `brand` aparecen cuando la página de resultados los muestra. `price` es un número en la `currency` (ISO 4217) de cada producto: una misma búsqueda de Amazon puede mostrar más de una moneda. Si los tamaños tienen precios distintos, `price` es el más bajo. Los precios de Target son los de su tienda en línea predeterminada. Los precios de AliExpress son los precios de venta que ve un comprador de EE. UU. sin iniciar sesión.
* `rating` usa una escala de cinco estrellas. Kurly y Zalando no muestran valoraciones, AliExpress muestra estrellas sin el número de valoraciones, y los recuentos abreviados como 999+ se omiten. `brand` llega de Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa y Zalando, que muestran la marca aparte del título.
* En `google_shopping`, `productId` es el ID de producto de Google, o el ID de la oferta cuando Google no ha agrupado el anuncio en un producto. La página de Google no enlaza la página del producto ni la del comercio, así que `url` es la página de resultados de Google Shopping donde apareció el producto, con `#product={productId}&title={title}` al final. Pase esa `url` a [Commerce Product](/es/engines/commerce-product.md) para leer las tiendas, especificaciones y descripción del producto. `seller` es la tienda que Google muestra primero, y `reviewCount` aparece solo cuando Google muestra el número exacto (menos de 1.000).
* Cada búsqueda devuelve productos de la primera página de resultados de la tienda. Esa página muestra hasta 30 productos en Yahoo! Shopping, 32 en Myntra y 24 en Zalando. En Flipkart tiene 40 posiciones y en Nykaa 20, con los anuncios patrocinados incluidos.
* Si una tienda envía la búsqueda a otra página, los productos vienen de esa página: Ulta envía algunas marcas a su página de marca, Target envía algunas búsquedas a una búsqueda relacionada y Nykaa muestra la página de categoría en las búsquedas que nombran una categoría.
* Una búsqueda sin productos termina como tarea fallida. Se factura por búsqueda completada.

## Relacionado

* [Commerce Product](/es/engines/commerce-product.md)
* [Resumen de motores](/es/engines/overview.md)
* [Créditos y límites](/es/concepts/credits-and-limits.md)


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