Novidades20 de out. de 2026Novo

Conheça o Product Lookup

Product Lookup

O Product Lookup pergunta aos motores de compra com IA sobre o seu produto e os dos concorrentes e devolve, motor a motor, as lojas, os preços e as avaliações que cada resposta mostra.

O que você recebe

engines[]: se as respostas de cada motor mostraram o seu produto (found) e cada anúncio de loja mostrado, com preço, estoque, nota, número de avaliações e o catálogo de origem.
modelSees: o título, a descrição, a nota e as avaliações que o modelo do ChatGPT que responde recebeu de um anúncio, para ver o seu produto como o modelo o lê.
comparison[]: o seu produto e até cinco concorrentes lado a lado em cada motor, com anúncios, lojas, o anúncio com mais avaliações e a faixa de preço.
prompts[]: até três prompts de compra, com os produtos da sua consulta que cada resposta mostrou e citou.
citedPages e summary.citedDomains: as páginas citadas por cada resposta, agrupadas por site entre os motores.

Como funciona

Envie o nome de um produto e um mercado. Em US, o Product Lookup pergunta ao ChatGPT “Buy …” e “Find the best price for …” e pergunta o nome do produto aos AI Overviews do Google, ao Google AI Mode e ao Bing Copilot. Em KR, pergunta o nome ao Naver AI Tab e ao Google AI Mode, e ao ChatGPT “… 구매” e “… 최저가”. Cada concorrente recebe as mesmas perguntas, e cada prompt de compra vai como foi escrito a cada motor. A consulta abaixo, com três produtos e dois prompts de compra, terminou em cerca de dois minutos.

Ele lê os registros de produto de cada resposta e as lojas e preços que o ChatGPT escreve nos cartões de compra, e mantém os que trazem o nome do produto no título. match.score mostra quanto do nome um anúncio traz, e kits, minis e refis chegam marcados como variant. Cada consulta lê respostas ao vivo: preço, nota e avaliações de um anúncio se mantêm de uma execução para outra, enquanto o conjunto de lojas que um motor mostra muda entre respostas; compare consultas repetidas para acompanhar a tendência.

Onde ajuda

Veja quais motores mostram o seu produto e com quais lojas e preços.
Compare suas avaliações e preços com os dos concorrentes em cada motor. Na consulta abaixo, o Bing Copilot mostrou 2.942 avaliações do belif, contra 85.773 do Clinique e 117.193 do CeraVe.
Faça as perguntas de categoria que os compradores usam e veja quais produtos as respostas destacam. Na consulta abaixo, o CeraVe apareceu em 5 das 8 respostas e o belif em 2.
Rode uma consulta antes e depois de mudar o feed de produtos ou os anúncios e compare o que cada motor mostra.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 da requisição

productstringObrigatório: O nome do produto como os compradores o buscam, de 1 a 200 caracteres. Uma URL de página de produto ou um código de barras retorna VALIDATION_ERROR.
countrystringObrigatório: US ou KR. O mercado define os motores consultados e a redação das perguntas.
competitorsarray: Até 5 nomes de produtos concorrentes. Cada um recebe as mesmas perguntas do seu produto.
promptsarray: Até 3 prompts de compra, como best eye cream for puffiness, enviados a cada motor como foram escritos.
enginesarray: Motores consultados. Em US, o padrão é CHATGPT, GOOGLE, AIMODE e BING_COPILOT; em KR, NAVER_AI_TAB, CHATGPT e AIMODE. Adicione GEMINI para consultar também o Gemini.
idempotencyKeystring: Dá nome à consulta. Reenviar devolve a mesma consulta e acrescenta só as perguntas que faltam.
webhook.urlstring: Um endereço HTTPS do seu servidor. A tarefa de cada pergunta é enviada para lá assim que termina.

Resposta

A resposta, resumida para facilitar a leitura.

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: O id da consulta: seu idempotencyKey ou um criado pelo servidor. Leia a consulta com GET /v1/product-lookup/{id}.
summaryobject: Contagem das perguntas: total, succeeded e failed.
credits.creditsToChargenumber: Quanto as perguntas custam quando todas respondem: 10 créditos por produto e 5 por prompt de compra.
asksarray: Uma entrada por pergunta: o motor, o texto perguntado e a task, ou error com o código quando a pergunta foi recusada.

Receba o resultado

Cada pergunta roda como uma tarefa própria, então a consulta se completa conforme as respostas chegam. Leia-a com GET /v1/product-lookup/{id} até lookup.status ser COMPLETED, ou adicione webhook.url para receber a tarefa concluída de cada pergunta. A consulta fica disponível por 24 horas depois que as perguntas terminam.

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

Uma consulta concluída fica assim, resumida.

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 e PROCESSING enquanto as perguntas rodam, COMPLETED quando todas terminaram e ao menos uma respondeu, FAILED se todas falharam.
lookup.creditsnumber: Créditos cobrados até agora pelas perguntas que responderam.
engines[].foundboolean: Se as respostas do motor mostraram o produto: um anúncio de loja ou um cartão de compra do ChatGPT basta para true.
engines[].listingsarray: Cada anúncio de loja que mostrou o produto: merchant, price, available, nota e avaliações, o catálogo de origem (source) e, no ChatGPT, o que o modelo que responde recebeu (modelSees).
summary.merchantsarray: Cada loja que mostrou o produto, com os motores que a mostraram e sua faixa de preço.
comparisonarray: Seu produto e cada concorrente lado a lado em cada motor: found, listings, merchants, mostReviewed, priceRange e em quantas respostas a prompts de compra apareceu.
prompts[].enginesarray: Para cada prompt de compra e motor, os produtos da sua consulta que a resposta mostrou (shown) e citou no texto (named).

Erros

VALIDATION_ERRORHTTP 400: Falta um campo ou o valor está fora do intervalo. details indica o campo.
REGION_UNSUPPORTEDHTTP 422: country é um mercado diferente de US e KR.
RESOURCE_ALREADY_EXISTSHTTP 409: Este idempotencyKey já nomeia uma consulta de outro produto, concorrente, prompt ou país. Envie a requisição com uma chave nova.
INSUFFICIENT_CREDITSHTTP 402: O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.
PLAN_CONCURRENCY_LIMITHTTP 429: As tarefas simultâneas do seu plano estão cheias. Entram as perguntas que cabem, as demais voltam em asks[] com este código, e reenviar a mesma requisição após Retry-After segundos as acrescenta. Quando nenhuma cabe, a requisição inteira retorna 429.

Preço

Cada produto, o seu e cada concorrente, custa 10 créditos e cada prompt de compra 5 créditos, quaisquer que sejam os motores consultados. O preço se divide entre as perguntas daquele produto, e você paga só pelas perguntas que respondem. A consulta acima, com três produtos e dois prompts de compra, custa 40 créditos.

Mais novidades

API22 de out. de 2026Novo
Conheça o Commerce Product
Envie a URL de uma página de produto da Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando ou de outras 11 lojas e receba preço, estoque, imagens da galeria e da descrição, especificações e opções no mesmo formato.
API21 de out. de 2026Novo
A busca de produtos em 20 lojas online já está disponível
Pesquise na Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando e em mais 13 lojas de cinco países, e receba o ranking de produtos de cada uma com preços, avaliações e número de resenhas no mesmo formato.

Receba atualizações do produto por e-mail.

Feed RSS