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)

Errors