Skip to main content
POST

Autorizações

X-API-Key
string
header
obrigatório

Corpo

application/json

Request do POST /search premium — query + filtros Context-like.

query
string
obrigatório
Minimum string length: 1
country
string | null

Código ISO 3166-1 alpha-2 com mapeamento DDGS (ex.: BR, US, GB). Códigos sem região DDGS são rejeitados.

Required string length: 2
exclude_domains
string[] | null

Omite resultados destes domínios.

Maximum array length: 20
freshness
string | null

Janela temporal dos resultados: day, week, month, year. Omita ou use any para sem filtro (mapeado para timelimit DDGS).

include_domains
string[] | null

Restringe resultados a estes domínios (hostname exato ou subdomínio).

Maximum array length: 20
num_results
integer
padrão:10

Quantidade de resultados finais (10–100).

Intervalo obrigatório: 10 <= x <= 100
query_fanout
boolean
padrão:true

Quando true (padrão), a query é expandida por LLM em até 5 termos para maior recall. Quando false, pula esse julgamento de intenção e busca apenas a query crua — mais rápido e com 1 chamada LLM a menos (o julgamento de score de relevância continua rodando).

tags
string[] | null

Tags de atribuição para o registro de uso (até 10).

timeout_seconds
integer | null

Limite de duração da busca em segundos (15–120). Omita para usar o timeout padrão do worker (300 s).

Intervalo obrigatório: 15 <= x <= 120
use_cache
boolean
padrão:false

Reutiliza um resultado completo recente (10 min) para a mesma combinação de query e filtros, quando disponível. Só resultados completos com achados são cacheados.

Resposta

Busca premium enfileirada. Usar GET /jobs/{job_id} para polling.