API reference · Brave

brave/news

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

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

Model IDbrave/news

Input Schema

13 parameters · 1 required · 12 optional

Parameter	Type	Required	Description
`q`	string	Required	The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.
`count`	integer	Optional	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. · Min: 1 · Max: 50 · Default: 20
`offset`	integer	Optional	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 · Min: 0 · Max: 9 · Default: 0
`country`	string	Optional	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. · Options: 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 · Default: "US" ARAUATBEBRCACLDKFIFRDEGRHKINIDITJPKRMYMXNLNZNOCNPLPTPHRUSAZAESSECHTWTRGBUSALL
`goggles`	string	Optional	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.
`ui_lang`	string	Optional	User interface language preferred in response. Usually of the format <language_code>-<country_code> . For more, see RFC 9110 . · Options: 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 · Default: "en-US" es-ARen-AUde-ATnl-BEfr-BEpt-BRen-CAfr-CAes-CLda-DKfi-FIfr-FRde-DEel-GRzh-HKen-INen-IDit-ITja-JPko-KRen-MYes-MXnl-NLen-NZno-NOzh-CNpl-PLen-PHru-RUen-ZAes-ESsv-SEfr-CHde-CHzh-TWtr-TRen-GBen-USes-US
`freshness`	string	Optional	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 · Default: ""
`operators`	boolean	Optional	Whether to apply search operators. · Default: true
`safesearch`	string	Optional	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. · Options: off, moderate, strict · Default: "strict" offmoderatestrict
`spellcheck`	boolean	Optional	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. · Default: true
`search_lang`	string	Optional	The search language preference. The 2 or more character language code for which the search results are provided. · Options: 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 · Default: "en" areubnbgcazh-hanszh-hanthrcsdanlenen-gbetfifrgldeelguhehihuisitjajpknkolvltmsmlmrnbplpt-brpt-ptparorusrskslessvtatethtrukvi
`extra_snippets`	boolean	Optional	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.
`include_fetch_metadata`	boolean	Optional	Include fetch metadata. · Default: false

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/brave/news", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "count": 20,
    "offset": 0,
    "country": "US",
    "ui_lang": "en-US",
    "freshness": "",
    "operators": true,
    "safesearch": "strict",
    "spellcheck": true,
    "search_lang": "en",
    "include_fetch_metadata": false
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

← Back to Brave News Search