Receba a tela que cada mecanismo de IA mostrou com a resposta

Ative include.html no ChatGPT, Gemini, Perplexity, Meta AI, Google AI Overviews ou AI Mode e receba um link para a tela de resposta do próprio mecanismo, salva como uma página que abre sem chave de API.

O que você recebe

• payload.include.html: true em CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE e AIMODE.
• html na resposta: status (ok ou failed), url e expiresAt. O link funciona por 30 dias após o fim da tarefa.
• A página abre sem chave de API e não carrega nada de fora, então você pode compartilhá-la por link ou incorporá-la num relatório.
• Os campos da resposta (text, sources e os demais) chegam como antes. Uma página que falha nunca faz a tarefa falhar.

Como funciona

No ChatGPT, Gemini, Perplexity e Meta AI, a pergunta é feita num navegador real no site do próprio mecanismo, e a tela é salva quando a resposta termina: a barra lateral, a pergunta, a resposta com suas fontes e a caixa de mensagem. Os campos da resposta vêm dessa mesma pergunta, e uma tela que não bate com a resposta não é salva.

Antes de salvar, os scripts são removidos, e imagens, estilos e fontes ficam dentro do arquivo. A página abre igual em qualquer navegador, sem carregar nada do mecanismo.

No Google AI Overviews e AI Mode, a página é a de resultados que o Google devolveu para a tarefa, sem os scripts. O AI Overview e sua lista de fontes são salvos abertos, como se Mostrar mais e Mostrar tudo tivessem sido clicados, então a resposta inteira pode ser lida sem scripts.

Quando a tela não pode ser capturada ou salva, html é { "status": "failed", "error": "EVIDENCE_FAILED" } e a tarefa termina com a resposta. Uma tarefa do ChatGPT com location, CN, HK ou continueFrom, e uma do Gemini com location, CN, DE, GB ou IR, sempre voltam sem página.

Onde ajuda

• Coloque a tela do próprio mecanismo ao lado de cada número num relatório para cliente, para mostrar a resposta como um usuário a viu.
• Abra a página quando um resultado processado parecer estranho e veja onde a marca ou a fonte aparecia na tela.
• Guarde um registro com data do que cada mecanismo respondeu. As páginas ficam 30 dias, então baixe as que precisar por mais tempo.

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": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": true }
    }
  }'

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.include.htmlboolean

Com true, chega também html, um link para a tela que o mecanismo mostrou com a resposta. Em CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE e AIMODE. Desativado por padrão.

webhook.urlstring

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

Resposta

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

{
  "success": true,
  "task": {
    "id": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

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.sourcesarray

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

response.htmlobject

A tela do mecanismo: status (ok ou failed), url (abre sem chave de API) e expiresAt, 30 dias após o fim da tarefa. Uma página que falhou traz error EVIDENCE_FAILED, e a tarefa termina mesmo assim com a resposta.

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"

Erros

EVIDENCE_UNSUPPORTEDHTTP 422

include.html está ativado num mecanismo que não tem página. Só CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE e AIMODE devolvem uma.

VALIDATION_ERRORHTTP 400

Falta um campo ou o valor está fora do intervalo. details indica o campo.

MISSING_API_KEYHTTP 401

Falta o cabeçalho Authorization, ou a chave é desconhecida, expirou ou foi revogada.

INSUFFICIENT_CREDITSHTTP 402

O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.

Preço

No ChatGPT, Perplexity e Meta AI, a página soma 0,25 crédito ao preço do mecanismo. Esse 0,25 é reservado no envio e só é cobrado quando html.status é ok. No Gemini, Google AI Overviews e AI Mode, a página é gratuita. Com a página, uma tarefa em qualquer um dos seis mecanismos custa 1,25 crédito, como a tarefa do Perplexity no exemplo.