Brave Summarizer Search API

Request Headers

Summarizer Search API Request Headers

This table lists the request headers supported by all the Summarizer Search API endpoints, most of which are optional.

HeaderRequiredNameDescription
AcceptfalseAccept

The default supported media type is application/json

Accept-EncodingfalseAccept Encoding

The supported compression type is gzip.

Api-VersionfalseWeb Search API Version

The Brave Web Search API version to use. This is denoted by the format YYYY-MM-DD. The latest version is used by default, and the previous ones can be found in the API Changelog.

Cache-ControlfalseCache Control

Search will return cached web search results by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.

User-AgentfalseUser Agent

The user agent of the client sending the request. Search can utilize the user agent to provide a different experience depending on the client sending the request.

The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.

User agent string examples by platform:

  • Android: Mozilla/5.0 (Linux; Android 13; Pixel 7 Pro) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Mobile Safari/537.36

  • iOS: Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1

  • macOS: Mozilla/5.0 (Macintosh; Intel Mac OS X 12_0_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/

  • Windows: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/

X-Subscription-TokentrueAuthentication token

The secret token for the subscribed plan to authenticate the request. Can be obtained from API Keys.