Get started with Brave Search API

Brave Search API is a REST API to query Brave Search and get back search results from the web. The following sections describe how to curate requests, including parameters and headers, to Brave Search API and get a JSON response back.

Note
To try the API on a Free plan, you’ll still need to subscribe—you simply won’t be charged. Once subscribed, you can get an API key in the API Keys section.

Endpoints

Brave Search API exposes multiple endpoints for specific types of data, based on the level of your subscription. If you don’t see the endpoint you’re interested in, you may need to change your subscription.

Brave Suggest Search API

Brave Suggest Search API is currently available at the following endpoint and exposes an API to generate potential suggestions for a given query.

Endpoint
https://api.search.brave.com/res/v1/suggest/search

Get started immediately with CURL. An example request will look something like this:

Curl
curl -s --compressed "https://api.search.brave.com/res/v1/suggest/search?q=hello&country=US&count=5" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Next steps

To learn what parameters are available and what responses can be expected while querying Brave Search, please review the following pages: