Brave News Search

Name: Brave News Search
Price: 0.0075 USD
Availability: InStock
Author: Brave

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

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

Try this API Get API key

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

Production route

Try the model

Playground

Open playground

Input

Count(integer)

150

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

Country(string)

The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide. 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.

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.

Include Fetch Metadata(boolean)

Include fetch metadata.

Offset(integer)

The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your u 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 400 characters and 50 words in the query.

Safesearch(string)

Filters search results for adult content. The following values are supported: off - No filtering is done. moderate - Filter out explicit content. strict - Filter out explicit and suggestive content. Allowed values: off, moderate, strict.

Search Lang(string)

The search language preference. 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 the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.

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.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.0075 / 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
extra_snippets: boolean · optional
freshness: string · optional
goggles: string · optional
include_fetch_metadata: boolean · optional
offset: integer · optional
operators: boolean · optional
safesearch: string (off, moderate, strict) · optional
search_lang: string (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) · optional
spellcheck: boolean · optional
More: +1 optional parameters

Access

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

API README

Brave News Search API

News 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/news", "q": "<q>"}'

Parameters

Name	Type	Required	Description
`count`	integer	No	The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset
`country`	string	No	The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide.
`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.
`include_fetch_metadata`	boolean	No	Include fetch metadata.
`offset`	integer	No	The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivere
`operators`	boolean	No	Whether to apply search operators.
`q`	string	Yes	The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.
`safesearch`	string	No	Filters search results for adult content. The following values are supported: off - No filtering is done. moderate - Filter out explicit content. strict - Filte
`search_lang`	string	No	The search language preference. The 2 or more character language code for which the search results are provided.
`spellcheck`	boolean	No	Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in alte
`ui_lang`	string	No	User interface language preferred in response. Usually of the format <language_code>-<country_code> . For more, see RFC 9110 .

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/news

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/news" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "count": 20,
  "offset": 0,
  "country": "US",
  "ui_lang": "en-US",
  "freshness": "",
  "operators": true,
  "safesearch": "strict",
  "spellcheck": true,
  "search_lang": "en",
  "include_fetch_metadata": false
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

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

Questions

FAQ

How do I use the Brave News Search API?

Send a POST request to https://api.sandbase.ai/v1/api/brave/news 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 News Search API cost?

$0.0075 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 News 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), extra_snippets (boolean), freshness (string), goggles (string) and include_fetch_metadata (boolean) and 6 more. The Parameters table and the Playground on this page list every field.

What does the Brave News 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 News 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.