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 ≥ requestednum_results (worst case). If the
balance is insufficient, the API returns 402.
Asynchronous flow
- Send
POST /search→ receive202withjob_id - Poll via
GET /jobs/{job_id}every 2s - When
status: "SUCCESS", results are in theresultsfield
The
stopped_reason field may be token_cap if the LLM token limit was hit before all sources were processed.