Skip to main content
POST
Web Search

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Body

application/json
query
string
required

The search query.

Required string length: 1 - 2000
model
string | null

Native engine model id. Defaults to the server's configured model.

Example:

"perplexity/sonar"

provider
enum<string> | null

Pin a specific engine. Omit to use native-first with Tavily fallback.

Available options:
native,
tavily
max_results
integer
default:5

Maximum results to return.

Required range: 1 <= x <= 20
search_depth
enum<string>
default:basic

Tavily search depth; ignored by the native engine.

Available options:
basic,
advanced
include_domains
string[] | null

Restrict results to these domains.

exclude_domains
string[] | null

Drop results from these domains.

include_answer
boolean
default:false

Ask the engine for a synthesized answer alongside results.

Response

Successful Response

query
string
required
provider
enum<string>
required
Available options:
native,
tavily
answer
string | null
results
WebSearchResultItem · object[]
request_id
string
default:""