Skip to main content
POST
Search across the web
Search for information with various retrieval strategies.

Example Request

Body

application/json

Input contract for POST /search

query
string
required

Natural-language search query

mode
enum<string>
default:auto

Retrieval strategy: let backend choose, force keyword, or force embedding

Available options:
auto,
keyword,
neural
depth
enum<string>
default:basic

Depth/quality tier; advanced costs more & may run longer

Available options:
basic,
advanced
topic
enum<string>
default:general

Domain-specific retrieval agent

Available options:
general,
news
max_results
integer
default:10

Maximum number of results to return

Required range: 1 <= x <= 50
add_answer
default:false

false → no answer. basic → one-sentence LLM answer. detailed → richer

Available options:
false
include_raw_content
boolean
default:false

If true, include cleaned HTML text in each result

include_images
boolean
default:false

If true, also run an image search

recency

Limit results to this many days in the past or a preset

Available options:
day,
week,
month,
year
filters
object

Fine-grained filtering for /search

view
enum<string>[]

Which data blocks to include in the response

Selective blocks to include in response

Available options:
results,
answer,
images,
embeddings
similar_to
string<uri>

Return docs similar to this URL instead of keyword search

stream
boolean

If true, respond with NDJSON streaming

response_format
enum<string>

Serialization format for large/bulk results

Available options:
json,
ndjson,
csv,
parquet
user_context
object

Opaque object echoed for personalization

Response

Search results

Universal response wrapper

data
object
required

Endpoint-specific payload

request_id
string

Echo of client-supplied ID or server-assigned UUID

meta
object

Metadata block attached to every response