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

# API de dados de respostas e citações da busca com IA

> Infraestrutura de dados para observar as superfícies de busca com IA voltadas ao consumidor: ChatGPT, Perplexity, Gemini, Google AI Overview e outras.

A querying.ai é uma API que responde a uma pergunta: **o que um mecanismo de IA diz quando você pergunta algo a ele?**
Você envia um prompt direcionado a um mecanismo, e nós devolvemos a resposta desse mecanismo junto com as fontes que ele citou.

Ela segue o contrato padrão de tarefas assíncronas das APIs de mecanismos de resposta, então um cliente existente
costuma migrar trocando apenas a URL base e a chave de API, sem mudar código. Veja
[Migrar uma integração existente](/pt/migrating).

## Como funciona

Toda requisição é **assíncrona**. Você envia uma tarefa, nós a colocamos na fila, um worker consulta o mecanismo de
destino e extrai o resultado, que volta para você por webhook ou por polling.

<Steps>
  <Step title="Envie uma tarefa">
    `POST /v1/async/task` com um `taskType` e um `payload`. Você recebe na hora um `id` de tarefa com status `QUEUED`.
  </Step>

  <Step title="Consultamos o mecanismo">
    Um worker pega a tarefa, consulta o mecanismo e extrai o texto da resposta, as fontes e os dados extras de cada mecanismo.
  </Step>

  <Step title="Colete o resultado">
    Se você informou `webhook.url`, enviamos o resultado por POST para esse endereço. Caso contrário, consulte
    `GET /v1/async/task/{id}` até que `status` seja `COMPLETED` ou `FAILED`.
  </Step>
</Steps>

## O que você recebe

Qualquer que seja o mecanismo, o núcleo útil de cada resultado tem o mesmo formato:

<ResponseField name="text" type="string">
  A resposta do mecanismo em texto simples.
</ResponseField>

<ResponseField name="sources" type="array">
  As citações que o mecanismo anexou à resposta: `position`, `url` e geralmente `label`.
</ResponseField>

Cada mecanismo acrescenta seus próprios campos: o Google devolve um envelope de SERP completo; ChatGPT e Perplexity
podem devolver as consultas de busca que dispararam; a aba de IA do Naver devolve o painel de compras que exibiu.
Veja [Mecanismos](/pt/engines/overview) para o formato de cada um.

## URL base

```
https://api.querying.ai
```

Todos os endpoints, exceto `/health` e `/ready`, exigem um [token bearer](/pt/authentication).

<Card title="Comece aqui" icon="rocket" href="/pt/quickstart">
  Envie sua primeira tarefa e receba um resultado em menos de cinco minutos.
</Card>

## Conheça os produtos

* [Coleta de respostas de IA](https://querying.ai/pt/answers)
* [Análise de evidências das fontes](https://querying.ai/pt/source-influence)
* [Monitoramento GEO](https://querying.ai/pt/monitors)
* [Guia de início da API](https://querying.ai/pt/guides/quickstart)