Skip to main content
POST
Run a search

Body

application/json
query
string
required
Maximum string length: 512
q
string

Accepted as an alias for query.

tier
enum<string>
default:instant

Search depth. instant/fast/auto share one recall budget; deep doubles it; deep_reasoning widens it further and extracts nearly everything it recalls.

Available options:
instant,
fast,
auto,
deep,
deep_reasoning
limit
integer
default:10
Required range: 1 <= x <= 50
enrich
boolean
default:true

Fetch and extract page bodies for the top results. Off is roughly ten times faster and returns engine snippets only.

format
enum<string>
default:json
Available options:
json,
markdown,
text
site
string

Restrict to one host.

lang
string
freshness
enum<string>
Available options:
any,
day,
week,
month,
year
category
enum<string>
default:general
Available options:
general,
news,
science,
images,
videos,
it

Response

Ranked results

success
boolean
message
string
result
object