Brave Search API

Brave results.
Ready for your next step.

Search the web with organic rankings, snippets, FAQs and discussions. Bring images, videos and news into the same workflow.

Open playground Read the docs

39 country choicesSafe-search controls

/v1/brave/search?query=coffee+machine&count=1

{
  "query": "coffee machine",
  "page": 1,
  "result_count": 1,
  "results": [
    {
      "position": 1,
      "title": "Coffee, Tea & Espresso Makers",
      "url": "https://www.costco.com/coffee-espresso-makers.html",
      "site_name": "Costco"
    }
  ],
  "has_next": true,
  "next_page": 2
}

Example response excerpt · rich blocks depend on the query

One API for the search journey

Web search

GET /v1/brave/search

Organic results with FAQs, discussions, inline videos and related searches.

Image search

GET /v1/brave/images

Original image URLs, thumbnails, dimensions and source pages.

Video search

GET /v1/brave/videos

Video links, duration, creators, publishers and pagination.

News search

GET /v1/brave/news

Headlines, snippets, source profiles and displayed dates.

Autocomplete

GET /v1/brave/autocomplete

Native search-box suggestions with entity metadata.

Supported locales

GET /v1/brave/locales

39 country choices and 49 UI languages. Free reference data.

Keep the context around every result

Ranked URLs and snippets with source profiles and thumbnails.
FAQs and discussions with source-provided votes and comments.
Explicit next-page metadata, query corrections and operator state.
Separate publication, source-fetch and observation timestamps.

Estimate your usage

EndpointRequests

7 credits per request · 7,000 credits total

Loading plans…

Start with a single request

curl -H "X-API-Key: YOUR_KEY" \
  "https://scrapebadger.com/v1/brave/search?query=coffee+machine&country=us&page=1"

Use the same endpoint through the official SDKs, the CLI and the hosted MCP server. See examples.

Frequently asked questions

Do I need a Brave API key?

No. Use your ScrapeBadger API key in the X-API-Key header. The API returns public Brave Search data without a Brave account.

Which rich results are included?

Web search preserves FAQs, forum discussions, inline videos and related searches when Brave includes them. Rich blocks vary by query. Generated AI answers are outside this API.

How does pagination work?

Use page=1, then follow next_page while has_next is true. Pages follow Brave’s native boundaries; count limits the returned rows within a page. A smaller count does not move the next page’s starting point.

Can I localize the results?

Choose a country for regional results and a UI language for labels and displayed dates. UI language does not guarantee that every result is written in that language. The free locales endpoint lists the supported choices.

Are empty or failed searches charged?

Failed requests and verified empty result lists are not charged. The response keeps query alteration and search-operator metadata so you can see when Brave relaxes a query.

Give your workflow a wider view.

Try the playground

ScrapeBadger is independent and is not affiliated with, endorsed by, or sponsored by Brave Software. Brave is a trademark of Brave Software, Inc.

Brave results.Ready for your next step.