Skip to main content
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

The task runs asynchronously. Read the result as described in Async tasks.

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_ERROR at submit.
  • A country outside the list above, an unknown lang, a safesearch outside the three values, a malformed freshness or a page outside 1-10 returns 422 VALIDATION_ERROR.
  • A request Brave rate-limits answers BRAVE_HTTP_429 after retrying on another address. BRAVE_UNEXPECTED_PAGE means Brave answered with a page this engine does not read, and BRAVE_TIMEOUT that it did not answer in time.
  • Other request errors are listed in Errors.
  • Bing Search for Bing’s results page and its AI summary
  • Scrape to read one result’s whole page