Skip to main content
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.

​
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.
1

Envie uma tarefa

POST /v1/async/task com um taskType e um payload. Você recebe na hora um id de tarefa com status QUEUED.
2

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

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.

​
O que você recebe

Qualquer que seja o mecanismo, o núcleo útil de cada resultado tem o mesmo formato:
​
string
A resposta do mecanismo em texto simples.
​
array
As citações que o mecanismo anexou à resposta: position, url e geralmente label.
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 para o formato de cada um.

​
URL base

Todos os endpoints, exceto /health e /ready, exigem um token bearer.

Comece aqui

Envie sua primeira tarefa e receba um resultado em menos de cinco minutos.

​
Conheça os produtos