Skip to main content
POST
You can use the deep_search parameter to enable a more comprehensive search that includes the full content of web pages, rather than just snippets. This can provide more detailed results but may take longer to process.

Web search modes

The optional mode parameter selects which underlying search engine handles the request: All modes return the same response shape (a list of results with url, metadata, and content). If mode is omitted, the tenant’s configured default is used, falling back to search if no default is set.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
queries
string[]
required

List of search queries

Example:
count
integer
default:10

Maximum number of results to return

Required range: x >= 1
Example:

10

sites
string[] | null

List of specific sites to search

Example:
timeout
integer
default:10

Timeout for the search in seconds

Required range: x >= 1
Example:

10

Whether to perform a deep search

Example:

false

mode
enum<string> | null

Web search endpoint to use: search (Brave, streaming), context (Brave LLM context), or perplexity. Omit to use the tenant default.

Available options:
search,
context,
perplexity
Example:

"search"

Response

Successful Response