O ChatGPT já está disponível

Pergunte ao ChatGPT a partir do mercado que você escolher e receba em JSON a resposta que um visitante real desse mercado vê, com todas as fontes citadas.

O que você recebe

• text e markdown: a resposta completa, em texto simples e com a formatação.
• sources: cada página que a resposta cita, em ordem, com URL e título.
• searchQueries: as buscas na web que o ChatGPT fez ao responder, para você ver como ele pesquisou o seu prompt.
• model: o modelo que respondeu nessa sessão.

Como funciona

Cada tarefa abre uma nova sessão do ChatGPT no país definido e faz a sua pergunta exatamente como foi escrita. Você recebe a resposta que um visitante novo desse mercado recebe, então as marcas recomendadas e as páginas citadas são as que seus clientes leem.

Cada execução é uma nova observação. Repita os mesmos prompts periodicamente e compare as execuções para ver como a resposta, as marcas recomendadas e as páginas citadas mudam ao longo do tempo.

Onde ajuda

• Verifique se o ChatGPT recomenda a sua marca nas perguntas que seus compradores fazem.
• Encontre as páginas que o ChatGPT cita na sua categoria e planeje o conteúdo em torno delas.
• Compare a resposta a um mesmo prompt entre países.

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/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

Campos da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.promptstringObrigatório

A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.

payload.countrystring

Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.

payload.locationstring

Um lugar dentro de country, como uma estação, um bairro ou um endereço, com até 200 caracteres. O motor responde como a um usuário que está ali. Para CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP.

payload.include.markdownboolean

Retorna markdown, a resposta com títulos, listas, tabelas e links. Ativado por padrão.

payload.include.searchQueriesboolean

Retorna searchQueries, as buscas na web que o ChatGPT fez para a resposta. Ativado por padrão.

payload.include.shoppingboolean

Retorna em shoppingCards os cartões de produto que o ChatGPT mostra. Ativado por padrão.

payload.include.rawResponseboolean

Com true, a saída original do motor chega junto ao resultado estruturado, para a sua própria análise. Desativado por padrão.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

idempotencyKeystring

Seu próprio ID para a requisição. Cada chave cria uma única tarefa por conta, então um reenvio continua sendo uma tarefa.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "success": true,
  "task": {
    "id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.textstring

A resposta em texto puro.

response.markdownstring

A resposta com a formatação: títulos, listas, tabelas e links.

response.sourcesarray

As páginas que a resposta cita, na ordem do motor, com position, url e label.

response.searchQueriesarray

As buscas na web que o motor fez para escrever a resposta.

response.shoppingCardsarray

Cartões de produto exibidos com a resposta: nome, preço, loja, avaliação e link.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

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

Preço

Cada tarefa do ChatGPT concluída usa 2 créditos.