BRAVE_SEARCH loads Brave’s results page for one query and returns its organic results, ads, FAQ, knowledge panel, news, videos, discussions, places and related queries. Brave answers from its own index and renders the page on the server, so results arrive with the page and no browser runs.
Request
Parameters
Response
A block the page carries is included; a block it does not carry is omitted.
Responses carry no HTML payload, so
include has nothing to add.
Limits and errors
- A query over 600 characters or 75 words returns
422 VALIDATION_ERRORat submit. - A
countryoutside the list above, an unknownlang, asafesearchoutside the three values, a malformedfreshnessor apageoutside 1-10 returns422 VALIDATION_ERROR. - A request Brave rate-limits answers
BRAVE_HTTP_429after retrying on another address.BRAVE_UNEXPECTED_PAGEmeans Brave answered with a page this engine does not read, andBRAVE_TIMEOUTthat it did not answer in time. - Other request errors are listed in Errors.
Related
- Bing Search for Bing’s results page and its AI summary
- Scrape to read one result’s whole page