Skip to main content

Search

O endpoint POST /search inicia uma busca premium assíncrona. Ele consulta múltiplas fontes web e aplica julgamento LLM para selecionar e sumarizar os resultados mais relevantes.

Endpoint

Autenticação

Header X-API-Key obrigatório. Veja Autenticação.

Parâmetros

string
obrigatório
Texto da busca. Deve conter ao menos 1 caractere.
integer
padrão:"10"
Quantidade de resultados finais desejados (10–100).
string
Código ISO 3166-1 alpha-2 para restringir resultados por região (ex.: BR, US, GB).
string[]
Restringe resultados a estes domínios (até 20). Hostname exato ou subdomínio.
string[]
Omite resultados destes domínios (até 20). Não pode ter sobreposição com include_domains.
string
Janela temporal dos resultados: day, week, month, year. Omita para sem filtro.
integer
Limite de duração da busca em segundos (15–120). Omita para usar o timeout padrão do worker.
string[]
Tags de atribuição para o registro de uso (até 10 tags).

Custo

1 crédito por resultado retornado (cobrado por resultados efetivos, não solicitados). O pré-check exige saldo ≥ num_results solicitado (pior caso). Se o saldo for insuficiente, a API retorna 402.

Fluxo assíncrono

  1. Envie POST /search → receba 202 com job_id
  2. Poll via GET /jobs/{job_id} a cada 2s
  3. Quando status: "SUCCESS", os resultados estão no campo results
O campo stopped_reason pode indicar token_cap se o limite de tokens LLM foi atingido antes de processar todas as fontes.

Exemplo

Resposta de sucesso (via polling)

Erros