Skip to main content

Search

POST /search starts an asynchronous premium search. It queries multiple web sources and applies LLM judgment to select and summarize the most relevant results.

Endpoint

Authentication

X-API-Key header required. See Authentication.

Parameters

string
required
Search text. Must contain at least 1 character.
integer
default:"10"
Desired number of final results (10–100).
string
ISO 3166-1 alpha-2 code to restrict results by region (e.g. BR, US, GB).
string[]
Restrict results to these domains (up to 20). Exact hostname or subdomain.
string[]
Omit results from these domains (up to 20). Must not overlap with include_domains.
string
Time window for results: day, week, month, year. Omit for no filter.
integer
Search duration limit in seconds (15–120). Omit to use the worker default timeout.
string[]
Attribution tags for usage records (up to 10 tags).

Cost

1 credit per returned result (charged for effective results, not requested count). The pre-check requires balance ≥ requested num_results (worst case). If the balance is insufficient, the API returns 402.

Asynchronous flow

  1. Send POST /search → receive 202 with job_id
  2. Poll via GET /jobs/{job_id} every 2s
  3. When status: "SUCCESS", results are in the results field
The stopped_reason field may be token_cap if the LLM token limit was hit before all sources were processed.

Example

Successful response (via polling)

Result fields

Search result keys are in Portuguese (titulo, trecho). Read them exactly as returned — there are no title or snippet aliases.

Errors