Brave Web Search

Name: Brave Web Search
Price: 0.005 USD
Availability: InStock
Author: Brave

https://api.sandbase.ai/v1/api/brave/web

Web Search from Brave. Returns the official Brave API response unchanged.

Try this API Get API key

Price: $0.005USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 1 required · 18 optional

Production route

Try the model

Playground

Open playground

Input

Count(integer)

120

The number of search results returned in response. The maximum is 20. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results. NOTE: Count only applies to web results. Range: 1 to 20.

Country(string)

The 2 character country code where the search results come from. Allowed values: AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, ALL.

Enable Rich Callback(boolean)

Enable rich callback. Allows you to get real time rich results via a callback URL when they are relevant to your query. NOTE : Requires Search plan.

Extra Snippets(boolean)

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.

Freshness(string)

Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: pd - Pages aged 24 hours or less. pw - Pages aged 7 days or less. pm - Pages aged 31 days or less. p

Goggles(string)

Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation . The parameter can be a single Goggle or a list of up to 3 Goggles.

Goggles Id(string)

Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use the goggles parameter.

Include Fetch Metadata(boolean)

Include fetch metadata.

Offset(integer)

The zero based offset that indicates number of search result pages (count) to skip before returning the result. The default is 0 and the maximum is 9. The actual number delivered may be less than requested. Use this parameter along with the count parameter to page results. For example, if your user Range: 0 to 9.

Operators(boolean)

Whether to apply search operators

Q(string)

The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.

Result Filter(array)

A comma delimited string of result types to include in the search response. Not specifying this parameter will return back all result types in search response where data is available and the plan has the corresponding option activated. The response always includes query and type to identify any quer

Safesearch(string)

Filters search results for adult content. The following values are supported: off - No filtering is done. moderate - Filters explicit content, like images and videos, but allows adult domains in the search results. strict - Drops all adult content from search results. Allowed values: off, moderate, strict.

Search Lang(string)

The 2 or more character language code for which the search results are provided. Allowed values: ar, eu, bn, bg, ca, zh-hans, zh-hant, hr, cs, da, nl, en, en-gb, et, fi, fr, gl, de, el, gu, he, hi, hu, is, it, ja, jp, kn, ko, lv, lt, ms, ml, mr, nb, pl, pt-br, pt-pt, pa, ro, ru, sr, sk, sl, es, sv, ta, te, th, tr, uk, vi.

Spellcheck(boolean)

Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.

Summary(boolean)

This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.

Text Decorations(boolean)

Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).

Ui Lang(string)

User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110 . Allowed values: es-AR, en-AU, de-AT, nl-BE, fr-BE, pt-BR, en-CA, fr-CA, es-CL, da-DK, fi-FI, fr-FR, de-DE, el-GR, zh-HK, en-IN, en-ID, it-IT, ja-JP, ko-KR, en-MY, es-MX, nl-NL, en-NZ, no-NO, zh-CN, pl-PL, en-PH, ru-RU, en-ZA, es-ES, sv-SE, fr-CH, de-CH, zh-TW, tr-TR, en-GB, en-US, es-US.

Units(string)

The measurement units. The following values are supported: metric - The standardized measurement system (km, celcius…) imperial - The British Imperial system of units (mile, fahrenheit…) Allowed values: imperial, metric.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.005 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

q: string · required
count: integer · optional
country: string (AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, ALL) · optional
enable_rich_callback: boolean · optional
extra_snippets: boolean · optional
freshness: string · optional
goggles: string · optional
goggles_id: string · optional
include_fetch_metadata: boolean · optional
offset: integer · optional
operators: boolean · optional
result_filter: array · optional
More: +7 optional parameters

Access

Provider: Brave
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/brave/web
Authentication: Bearer API key

API README

Brave Web Search API

Web Search from Brave. Returns the official Brave API response unchanged.

The response is the official Brave API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "brave/web", "q": "weather seattle", "enable_rich_callback": true}'

Parameters

Name	Type	Required	Description
`count`	integer	No	The number of search results returned in response. The maximum is 20. The actual number delivered may be less than requested. Combine this parameter with offset
`country`	string	No	The 2 character country code where the search results come from.
`enable_rich_callback`	boolean	No	Enable rich callback. Allows you to get real time rich results via a callback URL when they are relevant to your query. NOTE : Requires Search plan.
`extra_snippets`	boolean	No	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.
`freshness`	string	No	Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified da
`goggles`	string	No	Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle.
`goggles_id`	string	No	Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use t
`include_fetch_metadata`	boolean	No	Include fetch metadata.
`offset`	integer	No	The zero based offset that indicates number of search result pages (count) to skip before returning the result. The default is 0 and the maximum is 9. The actua
`operators`	boolean	No	Whether to apply search operators
`q`	string	Yes	The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.
`result_filter`	array	No	A comma delimited string of result types to include in the search response. Not specifying this parameter will return back all result types in search response w
`safesearch`	string	No	Filters search results for adult content. The following values are supported: off - No filtering is done. moderate - Filters explicit content, like images and v
`search_lang`	string	No	The 2 or more character language code for which the search results are provided.
`spellcheck`	boolean	No	Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered
`summary`	boolean	No	This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.
`text_decorations`	boolean	No	Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).
`ui_lang`	string	No	User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110 .
`units`	string	No	The measurement units. The following values are supported: metric - The standardized measurement system (km, celcius…) imperial - The British Imperial system of

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/brave/web

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/brave/web" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "q": "weather seattle",
  "count": 20,
  "offset": 0,
  "country": "US",
  "ui_lang": "en-US",
  "freshness": "",
  "operators": true,
  "safesearch": "moderate",
  "spellcheck": true,
  "search_lang": "en",
  "text_decorations": true,
  "enable_rich_callback": true,
  "include_fetch_metadata": false
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Brave Web SearchThis API `Brave`	$0.005 per call	JSON	Oct 30, 2026
Brave Image Search `Brave`	$0.005 per call	JSON	Oct 30, 2026
Brave LLM Context `Brave`	$0.005 per call	JSON	Oct 27, 2026
Brave POI Descriptions `Brave`	$0.005 per call	JSON	Oct 30, 2026
Brave Place Search `Brave`	$0.005 per call	JSON	Oct 30, 2026
Brave Local POIs `Brave`	$0.005 per call	JSON	Oct 30, 2026

Questions

FAQ

How do I use the Brave Web Search API?

Send a POST request to https://api.sandbase.ai/v1/api/brave/web with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Brave Web Search API cost?

$0.005 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Brave Web Search API accept?

Required: q (string). Optional: count (integer), country (one of AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, ALL), enable_rich_callback (boolean), extra_snippets (boolean), freshness (string) and goggles (string) and 12 more. The Parameters table and the Playground on this page list every field.

What does the Brave Web Search API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Brave developer account or API key?

No. Brave Web Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Brave API access separately.