GET/news/search

News Search

Search a dedicated index of news articles with freshness, country and language filters.

Brave Search·$0.006 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "brave-search",
  path: "/news/search",
  query: {
    "q": "example"
  }
});

console.log(output);

Query parameters

qrequired

string

Search query (max 400 chars, 50 words)

country

string

2-letter country code, or ALL for worldwide (default US)

search_lang

string

Language code for results (default en)

ui_lang

string

UI language, e.g. en-US

count

integer

Results per page (1-50, default 20)

offset

integer

Page offset (0-9)

safesearch

string

off, moderate, or strict (default strict)

freshness

string

pd (24h), pw (7d), pm (31d), py (365d), or YYYY-MM-DDtoYYYY-MM-DD

extra_snippets

boolean

Up to 5 extra excerpts per result

spellcheck

boolean

Spellcheck the query

goggles

string

Goggle URL or inline definition for custom re-ranking

operators

boolean

Apply search operators

include_fetch_metadata

boolean

Include fetch metadata for results (default false)