Search
O endpointPOST /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
HeaderX-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
- Envie
POST /search→ receba202comjob_id - Poll via
GET /jobs/{job_id}a cada 2s - Quando
status: "SUCCESS", os resultados estão no camporesults
O campo
stopped_reason pode indicar token_cap se o limite de tokens LLM foi atingido antes de processar todas as fontes.