La búsqueda de productos en 20 tiendas online ya está disponible

Busca en Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando y otras 13 tiendas de cinco países, y recibe la clasificación de productos de cada una con precios, valoraciones y número de reseñas en el mismo formato.

Qué obtienes

• COMMERCE_SERP: cada tarea busca en una tienda, elegida con payload.site, entre 20 tiendas de Estados Unidos, Corea, Japón, India y Alemania.
• products: la clasificación de la tienda para tu búsqueda, hasta 40 productos, cada uno con rank, productId, title y url.
• price como número con su currency, además de rating, reviewCount, brand e imageUrl cuando la página de resultados los muestra.
• Los mismos campos de producto en todas las tiendas, así que un solo parser lee Amazon, Coupang, Rakuten y Zalando por igual.

Tiendas

• Estados Unidos (US): Amazon amazon, Walmart walmart, Target target, eBay ebay, AliExpress aliexpress, Sephora sephora, Ulta ulta
• Corea (KR): Coupang coupang, Olive Young oliveyoung, 11st 11st, Lotte ON lotteon, Musinsa musinsa, Kurly kurly
• Japón (JP): Rakuten rakuten, Yahoo! Shopping yahoo_shopping, Qoo10 qoo10
• India (IN): Flipkart flipkart, Myntra myntra, Nykaa nykaa
• Alemania (DE): Zalando zalando

Cómo funciona

Cada tarea lee la primera página de resultados que la tienda muestra para tu búsqueda en su propio país y devuelve los productos en el orden predeterminado de la tienda. En todas las tiendas salvo Coupang se apartan los anuncios patrocinados, y rank cuenta el resto en el orden de la página.

productId es el ID propio de la tienda: el ASIN en Amazon, el número de artículo en eBay, shop:item en Rakuten. price es un número en la currency del producto (ISO 4217) y, cuando cada tamaño tiene su precio, el más bajo. rating usa una escala de cinco puntos en las tiendas que muestran valoraciones; Kurly y Zalando presentan los productos con precio y título.

Cuando una tienda lleva una búsqueda a otra página, los productos salen de esa página: Ulta lleva algunos nombres de marca a la página de la marca, Target lleva algunas búsquedas a una búsqueda relacionada y Nykaa muestra la página de categoría para las búsquedas que nombran una categoría. Una búsqueda que no encuentra productos termina como tarea fallida.

Para qué sirve

• Sigue día a día la posición de tu producto en la búsqueda de su categoría en Amazon, Walmart y Target.
• Compara tu precio, valoración y número de reseñas con los productos que están cerca en la clasificación.
• Sigue una línea de belleza o moda en Olive Young, Rakuten, Nykaa y Zalando con el mismo formato de solicitud.
• Pon la clasificación de la tienda junto a las respuestas de ChatGPT o Google AI Mode para la misma búsqueda y mira qué productos encuentra el comprador en cada lugar.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

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": "target", "query": "sunscreen", "limit": 10 }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.sitestringObligatorio

La tienda en la que se busca, como amazon, coupang o rakuten. Los 20 valores figuran con el motor.

payload.querystringObligatorio

La búsqueda, escrita como la teclea un comprador en el buscador de la tienda. De 1 a 500 caracteres.

payload.countrystring

El país de la tienda, como US para amazon o KR para coupang. También es el valor predeterminado.

payload.limitinteger

Productos que se devuelven, de 1 a 40. Por defecto, 20.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.returnedCountinteger

El número de productos en products.

response.productsarray

Los productos en el orden de la tienda: rank, productId, title y url, además de price, currency, rating, reviewCount, imageUrl y brand cuando la página de resultados los muestra.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Errores

VALIDATION_ERRORHTTP 422

site queda fuera de las 20 tiendas, query está vacío o supera los 500 caracteres, limit queda fuera de 1 a 40 o el payload lleva otro campo. details indica el campo.

REGION_UNSUPPORTEDHTTP 422

country es un país distinto del de la tienda, como KR con amazon.

MISSING_API_KEYHTTP 401

Falta la cabecera Authorization, o su clave es desconocida, caducó o fue revocada.

INSUFFICIENT_CREDITSHTTP 402

El saldo es menor que el precio de la tarea. Añade créditos o mejora el plan y vuelve a enviarla.

Precio

Cada búsqueda completada usa 3 créditos en todas las tiendas. Los créditos se cobran cuando la tarea se completa.