Novedades20 oct 2026Nuevo

Presentamos Product Lookup

Product Lookup

Product Lookup pregunta a los motores de compra con IA por tu producto y los de tu competencia, y devuelve, motor por motor, las tiendas, los precios y las reseñas que muestra cada respuesta.

Qué obtienes

engines[]: si las respuestas de cada motor mostraron tu producto (found) y cada anuncio de tienda que mostraron, con precio, disponibilidad, valoración, número de reseñas y el catálogo de origen.
modelSees: el título, la descripción, la valoración y las reseñas que recibió el modelo de ChatGPT que responde, para ver tu producto como lo lee el modelo.
comparison[]: tu producto y hasta cinco competidores lado a lado en cada motor, con anuncios, tiendas, el anuncio con más reseñas y el rango de precios.
prompts[]: hasta tres prompts de compra, con los productos de tu consulta que cada respuesta mostró y nombró.
citedPages y summary.citedDomains: las páginas que cita cada respuesta, agrupadas por sitio entre motores.

Cómo funciona

Envía el nombre de un producto y un mercado. En US, Product Lookup pregunta a ChatGPT “Buy …” y “Find the best price for …”, y pregunta el nombre del producto a los AI Overviews de Google, a Google AI Mode y a Bing Copilot. En KR pregunta el nombre a Naver AI Tab y a Google AI Mode, y a ChatGPT “… 구매” y “… 최저가”. Cada competidor recibe las mismas preguntas, y cada prompt de compra va tal cual a cada motor. La consulta de abajo, con tres productos y dos prompts de compra, terminó en unos dos minutos.

Lee los registros de producto de cada respuesta y las tiendas y precios que ChatGPT escribe en sus tarjetas de compra, y se queda con los que llevan el nombre del producto en el título. match.score indica cuánto del nombre lleva un anuncio, y los packs, los minis y los recambios llegan marcados como variant. Cada consulta lee respuestas en vivo: el precio, la valoración y las reseñas de un anuncio se mantienen entre ejecuciones, y el conjunto de tiendas que muestra un motor cambia de una respuesta a otra, así que compara consultas repetidas para seguir la tendencia.

Para qué sirve

Comprueba qué motores muestran tu producto y con qué tiendas y precios.
Compara tus reseñas y precios con los de la competencia en cada motor. En la consulta de abajo, Bing Copilot mostró 2.942 reseñas de belif frente a 85.773 de Clinique y 117.193 de CeraVe.
Haz las preguntas de categoría que usan los compradores y mira qué productos destacan las respuestas. En la consulta de abajo, CeraVe apareció en 5 de las 8 respuestas y belif en 2.
Lanza una consulta antes y después de cambiar tu feed de productos o tus anuncios, y compara lo que muestra cada motor.

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/product-lookup \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "belif Moisturizing Eye Bomb",
    "country": "US",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "idempotencyKey": "eye-bomb-us"
  }'

Campos de la solicitud

productstringObligatorio: El nombre del producto tal como lo buscan los compradores, de 1 a 200 caracteres. Una URL de página de producto o un código de barras devuelve VALIDATION_ERROR.
countrystringObligatorio: US o KR. El mercado define los motores y la redacción de las preguntas.
competitorsarray: Hasta 5 nombres de productos de la competencia. Cada uno recibe las mismas preguntas que tu producto.
promptsarray: Hasta 3 prompts de compra, como best eye cream for puffiness, que se envían tal cual a cada motor.
enginesarray: Motores a los que se pregunta. En US son CHATGPT, GOOGLE, AIMODE y BING_COPILOT por defecto, y en KR NAVER_AI_TAB, CHATGPT y AIMODE. Añade GEMINI para preguntar también a Gemini.
idempotencyKeystring: Da nombre a la consulta. Si la reenvías, recibes la misma consulta y solo se añaden las preguntas que faltan.
webhook.urlstring: Una dirección HTTPS de tu servidor. La tarea de cada pregunta se envía allí en cuanto termina.

Respuesta

La respuesta, recortada para que se lea mejor.

JSON

{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
  },
  "summary": { "total": 23, "succeeded": 23, "failed": 0 },
  "credits": { "creditsToCharge": 40, "creditsCharged": 0 },
  "asks": [
    {
      "engine": "CHATGPT",
      "taskType": "CHATGPT",
      "role": "product",
      "prompt": "Buy belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    {
      "engine": "GOOGLE",
      "taskType": "GOOGLE",
      "role": "product",
      "query": "belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "0d6d6839-8705-44c1-ac3c-c5f56cb25d08",
        "taskType": "GOOGLE",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.472Z",
        "idempotencyKey": "eye-bomb-us:GOOGLE:name"
      }
    },
    "…"
  ]
}

lookup.idstring: El id de la consulta: tu idempotencyKey o uno que crea el servidor. Lee la consulta con GET /v1/product-lookup/{id}.
summaryobject: Recuento de las preguntas: total, succeeded y failed.
credits.creditsToChargenumber: Lo que cuestan las preguntas cuando todas responden: 10 créditos por producto y 5 por prompt de compra.
asksarray: Una entrada por pregunta: el motor, el texto preguntado y su task, o error con su código si se rechazó.

Recibe el resultado

Cada pregunta corre como una tarea propia, así que la consulta se completa a medida que llegan las respuestas. Léela con GET /v1/product-lookup/{id} hasta que lookup.status sea COMPLETED, o añade webhook.url para recibir la tarea terminada de cada pregunta. La consulta se puede leer durante 24 horas después de que terminen sus preguntas.

curl "https://api.querying.ai/v1/product-lookup/$LOOKUP_ID" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Así se ve una consulta terminada, recortada por extensión.

JSON

{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "status": "COMPLETED",
    "createdAt": "2026-10-20T09:22:43.422Z",
    "completedAt": "2026-10-20T09:24:36.695Z",
    "credits": 40
  },
  "summary": {
    "foundIn": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"],
    "notFoundIn": [],
    "merchants": [
      {
        "merchant": "Ulta Beauty",
        "engines": ["CHATGPT", "BING_COPILOT"],
        "price": { "currency": "USD", "min": 48, "max": 48 }
      },
      {
        "merchant": "Amazon",
        "engines": ["CHATGPT"],
        "price": { "currency": "USD", "min": 43, "max": 43 }
      },
      "…"
    ],
    "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
    "citedDomains": [
      {
        "domain": "ulta.com",
        "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
      },
      "…"
    ],
    "credits": 10
  },
  "engines": [
    {
      "engine": "CHATGPT",
      "status": "COMPLETED",
      "found": true,
      "via": [
        {
          "taskType": "CHATGPT",
          "prompt": "Buy belif Moisturizing Eye Bomb",
          "taskId": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
          "status": "COMPLETED",
          "credits": 2
        },
        "…"
      ],
      "listings": [
        {
          "ask": 1,
          "position": 1,
          "title": "belif Moisturizing Eye Bomb Eye Cream",
          "merchant": "Ulta Beauty",
          "source": "merchant_feed",
          "price": { "value": 48, "currency": "USD", "raw": "$48.00" },
          "available": true,
          "modelSees": {
            "rating": 4.5,
            "reviewCount": 105,
            "brand": "belif"
          },
          "match": { "score": 1 }
        },
        {
          "ask": 2,
          "position": 1,
          "title": "Amazon",
          "merchant": "Amazon",
          "source": "chatgpt_widget",
          "price": { "value": 43, "currency": "USD", "raw": "$43.00" },
          "match": { "score": 1 }
        },
        "…"
      ],
      "citedPages": [
        {
          "ask": 1,
          "domain": "lgbeauty.com",
          "title": "Moisturizing Eye Bomb"
        },
        "…"
      ]
    },
    "…"
  ],
  "comparison": [
    {
      "product": "belif Moisturizing Eye Bomb",
      "role": "product",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 5,
          "mostReviewed": {
            "reviewCount": 2942,
            "rating": 4.58,
            "merchant": "Comparor"
          },
          "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
          "prompts": { "answered": 2, "appeared": 1 }
        },
        "…"
      ]
    },
    {
      "product": "CeraVe Eye Repair Cream",
      "role": "competitor",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 6,
          "mostReviewed": {
            "reviewCount": 117193,
            "rating": 4.35,
            "merchant": "Pasteur Pharmacy"
          },
          "priceRange": { "currency": "USD", "min": 15.95, "max": 38.95 },
          "prompts": { "answered": 2, "appeared": 0 }
        },
        "…"
      ]
    },
    "…"
  ],
  "prompts": [
    {
      "prompt": "best moisturizing eye cream",
      "engines": [
        {
          "engine": "GOOGLE",
          "status": "COMPLETED",
          "shown": ["CeraVe Eye Repair Cream", "Clinique All About Eyes"],
          "named": [
            "belif Moisturizing Eye Bomb",
            "CeraVe Eye Repair Cream",
            "Clinique All About Eyes"
          ]
        },
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "shown": ["belif Moisturizing Eye Bomb"],
          "named": ["belif Moisturizing Eye Bomb"]
        },
        "…"
      ]
    },
    "…"
  ]
}

lookup.statusstring: QUEUED y PROCESSING mientras corren las preguntas, COMPLETED cuando todas terminaron y al menos una respondió, FAILED si todas fallaron.
lookup.creditsnumber: Créditos cobrados hasta ahora por las preguntas que respondieron.
engines[].foundboolean: Si las respuestas del motor mostraron el producto: basta un anuncio de tienda o una tarjeta de compra de ChatGPT para que sea true.
engines[].listingsarray: Cada anuncio de tienda que mostró el producto: merchant, price, available, valoración y reseñas, el catálogo de origen (source) y, en ChatGPT, lo que recibió el modelo que responde (modelSees).
summary.merchantsarray: Cada tienda que mostró el producto, con los motores que la mostraron y su rango de precios.
comparisonarray: Tu producto y cada competidor lado a lado en cada motor: found, listings, merchants, mostReviewed, priceRange y en cuántas respuestas a prompts de compra apareció.
prompts[].enginesarray: Para cada prompt de compra y motor, los productos de tu consulta que la respuesta mostró (shown) y nombró en el texto (named).

Errores

VALIDATION_ERRORHTTP 400: Falta un campo o su valor está fuera de rango. details indica el campo.
REGION_UNSUPPORTEDHTTP 422: country es un mercado distinto de US y KR.
RESOURCE_ALREADY_EXISTSHTTP 409: El idempotencyKey ya nombra una consulta de otro producto, competidor, prompt o país. Envía la solicitud con una clave nueva.
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.
PLAN_CONCURRENCY_LIMITHTTP 429: Las tareas simultáneas de tu plan están completas. Entran las preguntas que caben, el resto vuelve en asks[] con este código y reenviar la misma solicitud tras Retry-After segundos las añade. Si no cabe ninguna, la solicitud entera devuelve 429.

Precio

Cada producto, el tuyo y cada competidor, cuesta 10 créditos y cada prompt de compra 5, sea cual sea el motor al que preguntes. El precio se reparte entre las preguntas de ese producto y pagas solo las que responden. La consulta de arriba, con tres productos y dos prompts de compra, cuesta 40 créditos.

Más novedades

API22 oct 2026Nuevo
Presentamos Commerce Product
Pasa la URL de una página de producto de Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando y otras 11 tiendas, y recibe su precio, stock, imágenes de galería y de descripción, especificaciones y opciones en el mismo formato.
API21 oct 2026Nuevo
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.

Recibe las actualizaciones por correo.

Feed RSS