API Product Lookup: seu produto nas respostas de compra da IA

Consulte um produto no ChatGPT, Google AI Overviews, AI Mode, Copilot e Naver AI Tab: quais mecanismos o mostram, em quais lojas e por qual preço, quais páginas cada resposta cita e como ele se compara aos concorrentes.

01

Quais mecanismos mostram seu produto

Envie o nome de um produto e um país, US ou KR. Em cada mecanismo, found indica se a resposta mostrou o produto, e otherListings reúne os outros produtos exibidos. summary.foundIn e summary.notFoundIn dividem os mecanismos em duas listas.

02

Lojas, preços e avaliações

Cada oferta exibida em uma resposta traz a loja, o preço e o catálogo de origem, com estoque, nota, número de avaliações e IDs de catálogo quando o mecanismo os fornece. No ChatGPT, modelSees guarda o que o modelo de resposta recebeu sobre o produto, e as ofertas chatgpt_widget registram as lojas e os preços que o ChatGPT escreveu nos cards do widget.

03

As páginas por trás de cada resposta

citedPages lista as páginas que cada resposta cita. summary.citedDomains as agrupa por site com os mecanismos que as citaram, e summary.merchants lista cada loja com os mecanismos que a mostraram e sua faixa de preço.

Seu produto ao lado dos concorrentes

Adicione até cinco produtos concorrentes. Cada um recebe as mesmas perguntas que o seu, e comparison[] alinha todos mecanismo por mecanismo.

  • found: quais mecanismos mostraram cada produto.
  • listings e merchants: quantas ofertas cada produto recebeu e de quantas lojas.
  • mostReviewed e priceRange: a oferta com mais avaliações e a faixa de preço que cada mecanismo mostrou.
  • prompts: quantos prompts de compra cada mecanismo respondeu e quantas dessas respostas mostraram ou citaram o produto.

O que os compradores perguntam

Adicione até três prompts de compra, como “best eye cream for puffiness”. Cada mecanismo responde a cada prompt exatamente como foi escrito, e prompts[] indica quais produtos a resposta mostrou como ofertas (shown) e quais o texto cita pelo nome (named).

Mecanismos e perguntas por mercado

Cada mercado consulta os mecanismos que mostram ofertas de produtos ali. Com engines você escolhe os seus.

  • US: o ChatGPT recebe “Buy {produto}” e “Find the best price for {produto}”, e Google AI Overviews, AI Mode e Copilot recebem o nome do produto.
  • KR: Naver AI Tab e AI Mode recebem o nome do produto, e o ChatGPT recebe “{produto} 구매” e “{produto} 최저가”.
  • O Gemini entra quando engines o inclui. No KR, Google AI Overviews e Copilot também.
Etapa 1

Envie para POST /v1/product-lookup

Envie seu produto com até cinco concorrentes e três prompts de compra. Esta consulta pergunta a quatro mecanismos sobre três produtos e dois prompts de compra: 23 perguntas por 40 créditos. idempotencyKey vira o ID da consulta.

cURL
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"
}'
Etapa 2

Cada pergunta é uma tarefa

A resposta lista cada pergunta com sua tarefa, e credits.creditsToCharge soma o preço delas. As perguntas rodam, são cobradas e enviam webhooks como qualquer tarefa. Reenviar o mesmo ID devolve as perguntas existentes e adiciona só as que faltam.

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-…",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    "…"
  ]
}
Etapa 3

Leia com GET /v1/product-lookup/:id

Consulte o ID até lookup.status ser COMPLETED, ou leia a consulta a cada webhook de uma pergunta. Leia e guarde o resultado em até 24 horas depois que as perguntas terminarem.

cURL
curl https://api.querying.ai/v1/product-lookup/eye-bomb-us \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Custo

Um produto custa 10 créditos e um prompt de compra 5, quaisquer que sejam os mecanismos consultados. Seu produto e cada concorrente contam como produtos, então a consulta acima custa 40 créditos. O preço de cada produto se divide entre suas perguntas, uma pergunta com falha devolve seus créditos ao saldo e um reenvio cobra só as perguntas que adiciona.

Ver preços →
Custo por produto por plano
Plano1.000 produtos
Basic≈ $25.00
Max≈ $10.00

Custos efetivos supondo o uso de todos os créditos mensais incluídos.

Medido em 50 produtos

Em 2026-10-20 consultamos 50 produtos pela API de produção, 25 nos EUA e 25 na Coreia.

  • US: o Copilot mostrou os 25 produtos, e Google AI Overviews e AI Mode, 23 de 25.
  • KR: o Naver AI Tab mostrou os 25 produtos, e o AI Mode, 13 de 25.
  • O ChatGPT, com as duas perguntas e os cards do widget, mostrou o produto em todas as 24 execuções nos EUA e nas 20 na Coreia.
  • Em execuções repetidas, a mesma oferta de loja manteve preço, nota e número de avaliações em 307 de 316 valores. As ofertas exibidas mudam de uma execução para outra, então leia tendências em várias consultas.

Recursos relacionados

Comece com 500 créditos grátis

Execute sua primeira tarefa no Playground ou chame a API com sua chave.