The Brave Search API is a REST API to query Brave Search and get back search results from the web in JSON format. Requests are highly extensible, and can be customized with a range of query parameters and headers. 

Visit the [Brave Search API](https://api-dashboard.search.brave.com/app/documentation/web-search/get-started) portal for the latest detailed documentation.

--- 
## Usage and limits
- $9 CPM (cost per thousand) / $0.009 per request
- Maximum of 50 requests per second
- Unlimited requests
## Search API features
- Web search
- News search
- Video search
- Image search
- Extra alternate snippets for AI
- Schema-enriched Web results (Rich Web Search)
- [Search Goggles](https://search.brave.com/help/goggles)
- Infobox
- Discussions
- Locations
- & more
## Endpoints
- https://api.search.brave.com/res/v1/web/search
- https://api.search.brave.com/res/v1/images/search
- https://api.search.brave.com/res/v1/videos/search
- https://api.search.brave.com/res/v1/news/search
## Getting started
To get started immediately, try out a simple CURL request:

```bash
curl -s --compressed "https://api.search.brave.com/res/v1/web/search?q=sundance+film+festival" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"
```
## Example response
Here's an example of a returned JSON object:
```json
{
"query": {
"original": "sundance film festival",
"show_strict_warning": false,
"is_navigational": true,
"is_news_breaking": false,
"spellcheck_off": true,
"country": "us",
"bad_results": false,
"should_fallback": false,
"postal_code": "",
"city": "",
"header_country": "",
"more_results_available": true,
"state": ""
},

"web": {
"type": "search",
"results": [
{
"title": "Sundance Film Festival",
"url": "https://festival.sundance.org/",
"is_source_local": false,
"is_source_both": false,
"description": "Join us for the 2026 <strong>Sundance</strong> <strong>Film</strong> <strong>Festival</strong> taking place from January 22–February 1, 2026 in Park City, Utah.",
...
```

## Common query parameters for AI
Requests can be tailored with a range query parameters, some popular options include:

| String         | Description                                                                                                                                                                                        |
|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| country        | The search query country, where the results come from.                                                                                                                                             |
| count          | The number of search results returned in the response.                                                                                                                                             |
| extra_snippets | A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts.                                                |
*Note: parameters and headers can vary by endpoint.*

For detailed information for supported query parameters, refer to the documentation for featured endpoints:
- [Web Search](https://api-dashboard.search.brave.com/app/documentation/web-search/query)
- [Summarizer Search](https://api-dashboard.search.brave.com/app/documentation/summarizer-search/query)
- [Image Search](https://api-dashboard.search.brave.com/app/documentation/image-search/query)
- [Video Search](https://api-dashboard.search.brave.com/app/documentation/video-search/query)
- [News Search](https://api-dashboard.search.brave.com/app/documentation/news-search/query)

## Advanced Use Case
[Brave Goggles](https://search.brave.com/goggles/discover) is an advanced tool to add with providing advanced filters for Brave Search results.  It is currently supported in the following endpoints:
- [Web Search](https://api-dashboard.search.brave.com/app/documentation/web-search/query)
- [News Search](https://api-dashboard.search.brave.com/app/documentation/news-search/query)

### Brave Goggles Example

```bash
curl -s --compressed "https://api.search.brave.com/res/v1/web/search?q=sundance+film+festival&goggles_id=https%3A%2F%2Fraw.githubusercontent.com%2Fallsides-news%2Fbrave-goggles%2Fmain%2Fleft.goggles" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"
```