> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Páginas HTML: a tela do próprio mecanismo para cada resposta

> Adicione include.html a uma tarefa do ChatGPT, Gemini, Perplexity, Meta AI, Google AI Overviews ou Google AI Mode e receba uma página compartilhável da tela que o mecanismo mostrou.

Defina `include.html` como `true` e a tarefa retorna um link para a tela que o mecanismo mostrou com a resposta, salva como uma página HTML autossuficiente que você pode colocar em um relatório.

## Requisição

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US", "include": { "html": true } } }'
```

## Mecanismos suportados

| taskType | A página |
| - | - |
| `CHATGPT` | A tela completa do ChatGPT (barra lateral, pergunta, resposta e caixa de mensagem) como o ChatGPT a mostrou ao terminar a resposta. Os scripts são removidos e as imagens são incluídas, então ela abre sem carregar nada. |
| `GEMINI` | A tela do Gemini como o Gemini a mostrou ao terminar a resposta. Os scripts são removidos e os estilos, as fontes e as imagens são incluídos, então ela abre sem carregar nada. |
| `PERPLEXITY` | A tela do Perplexity como o Perplexity a mostrou ao terminar a resposta, preparada da mesma forma que no `GEMINI`. |
| `META_AI` | A tela do Meta AI como o Meta AI a mostrou ao terminar a resposta, preparada da mesma forma que no `PERPLEXITY`. |
| `GOOGLE` | A página de resultados que o Google retornou, sem os scripts, para abrir com segurança. Os estilos do Google e as miniaturas incluídas na página são mantidos, e os links abrem no Google. |
| `AIMODE` | A página do AI Mode que o Google retornou, preparada da mesma forma que no `GOOGLE`. |

Os outros mecanismos recusam a flag com `422 EVIDENCE_UNSUPPORTED`. `GET /v1/capabilities` marca os mecanismos suportados com `evidence: true`. O `CHATGPT` recusa com o mesmo erro quando a tarefa tem uma `location`, pede `CN` ou `HK`, ou continua uma conversa com `continueFrom`: o ChatGPT só desenha a tela de uma conversa nova respondida sem localização do dispositivo.

## Resposta

O `response` da tarefa ganha um objeto `html`. Por exemplo:

```json theme={"theme":"css-variables"}
{
  "html": {
    "status": "ok",
    "url": "https://api.querying.ai/v1/evidence/1791551389-5cf17d26396946be8d68bf514e1dca18.html",
    "expiresAt": "2026-11-08T13:09:49.000Z"
  }
}
```

| Campo | Descrição |
| - | - |
| `status` | `ok`, ou `failed` quando nenhuma página pôde ser salva. |
| `url` | A página. Não exige chave de API. |
| `expiresAt` | Quando a URL deixa de funcionar, 30 dias após o fim da tarefa. |
| `error` | `EVIDENCE_FAILED` quando `status` é `failed`. |

## Acesso e retenção

* A URL não exige chave de API, então funciona em um link ou em um relatório. Qualquer pessoa com a URL pode abri-la até `expiresAt`.
* Depois de `expiresAt`, a URL responde `404` e a página é apagada. Baixe o que precisar guardar.
* Um mesmo endereço IP pode baixar até 600 páginas por minuto; acima disso, recebe `429`.

## Créditos

No `CHATGPT`, no `PERPLEXITY` e no `META_AI`, a página custa 0,25 crédito além do preço do mecanismo. Esses créditos são reservados no envio e cobrados só quando `html.status` é `ok`. No `GEMINI`, no `GOOGLE` e no `AIMODE`, a página não custa nada a mais.

## Quando a página falha

A tarefa termina mesmo assim com a resposta, e `html` chega como `{ "status": "failed", "error": "EVIDENCE_FAILED" }`, quando:

* a tela do mecanismo não pôde ser obtida ou não correspondia à resposta;
* a página não pôde ser armazenada;
* no `GEMINI`, a tarefa tem uma `location` ou pede `CN`, `DE`, `GB` ou `IR`. Esses casos sempre falham.

Reenvie a tarefa para tentar de novo.

## Erros

| Status | Código | Quando |
| - | - | - |
| `422` | `EVIDENCE_UNSUPPORTED` | O mecanismo não consegue retornar uma página HTML, ou uma tarefa do `CHATGPT` tem `location`, `CN`, `HK` ou `continueFrom`. |
| `400` | `VALIDATION_ERROR` | `include.html` não é booleano, ou a requisição define `include.screenshot: true`. Capturas de tela não estão mais disponíveis; use `include.html`. |

## Relacionados

* [Markdown e respostas brutas](/pt/engines/response-options.md)
* [ChatGPT](/pt/engines/chatgpt.md) · [Gemini](/pt/engines/gemini.md) · [Perplexity](/pt/engines/perplexity.md) · [Meta AI](/pt/engines/meta-ai.md) · [Google AI Overviews](/pt/engines/google-ai-overviews.md) · [Google AI Mode](/pt/engines/google-ai-mode.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.