Início rápido da API de dados de busca com IA

Guia de início · Planos e créditos da API

1. Defina suas credenciais

export BASE="https://api.querying.ai"
export API_KEY="<your-key>"

2. Envie uma tarefa

Faça uma pergunta ao Gemini. taskType escolhe o mecanismo; payload.prompt é o que você pergunta.

curl -X POST "$BASE/v1/async/task" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026", "country": "US" }
  }'

A tarefa é aceita e entra na fila:

{
  "success": true,
  "task": {
    "id": "8f2c1e40-...",
    "taskType": "GEMINI",
    "status": "QUEUED",
    "priority": 1,
    "createdAt": "2026-07-09T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 }
}

credits faz parte do envelope de resposta. No envio e no polling ele é sempre zero; o webhook informa o custo em créditos de cada mecanismo (1–2 créditos para os mecanismos de resposta públicos e 12 para o Prompt Research; o Source Influence é medido à parte). Os saldos ficam visíveis no painel.

3. Colete o resultado

Webhook (recomendado)
Polling

Adicione webhook.url ao enviar. Quando a tarefa chega a um estado final, enviamos o resultado completo por POST para esse endereço, e você nunca precisa fazer polling.

curl -X POST "$BASE/v1/async/task" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://your-server.example.com/hook" }
  }'

Seu endpoint recebe { task, credits, response }. Veja Webhooks para o contrato de entrega e novas tentativas.

Omita webhook e consulte a tarefa pelo id. response fica ausente até a tarefa terminar.

curl "$BASE/v1/async/task/8f2c1e40-..." \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true,
  "task": { "id": "8f2c1e40-...", "status": "COMPLETED", "...": "..." },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 },
  "response": {
    "text": "The best wireless earbuds in 2026 are ...",
    "sources": [{ "position": 1, "url": "https://...", "label": "..." }]
  }
}

O polling público fica disponível por 24 horas após a conclusão. Consulte dentro desse prazo, ou uma tarefa concluída retornará 404 por ter expirado.

4. Envie em lote

POST /v1/async/task/batch aceita um array JSON com os mesmos objetos de tarefa, até 500 por requisição. Você pode misturar mecanismos livremente em um lote.

curl -X POST "$BASE/v1/async/task/batch" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    { "taskType": "GEMINI",     "payload": { "prompt": "best wireless earbuds 2026" } },
    { "taskType": "PERPLEXITY", "payload": { "prompt": "best wireless earbuds 2026" } },
    { "taskType": "GOOGLE",     "payload": { "query":  "best wireless earbuds 2026" } }
  ]'

Um lote bem formado sempre retorna 200. Falhas individuais aparecem como results[].success = false, então uma tarefa com problema nunca derruba as demais. Veja Envio em lote.

Os mecanismos da família Google (GOOGLE, AIMODE, NAVER_*) leem payload.query. Os mecanismos LLM leem payload.prompt. Qualquer um dos dois passa na validação, mas cada mecanismo lê primeiro o campo que espera.

Próximos passos

Escolha um mecanismo

Cada taskType e o que ele retorna.

Trate as falhas

Códigos de erro, códigos de status e o que pode ser repetido.

Primeiros passos

Conceitos principais

Mecanismos

Source Influence

Prompt Research

Monitoramento GEO

Migração

Início rápido da API de dados de busca com IA

1. Defina suas credenciais

2. Envie uma tarefa

3. Colete o resultado

4. Envie em lote

Próximos passos

Escolha um mecanismo

Trate as falhas

​1. Defina suas credenciais

​2. Envie uma tarefa

​3. Colete o resultado

​4. Envie em lote

​Próximos passos

Escolha um mecanismo

Trate as falhas

1. Defina suas credenciais

2. Envie uma tarefa

3. Colete o resultado

4. Envie em lote

Próximos passos