Suggest API

Getting Started

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.

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 Suggest Search API is currently available at the following endpoint and exposes an API to generate potential suggestions for a given query.

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

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.

Examples

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



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: