GET/web/search

Web Search

Search Brave's independent web index. Returns web results plus news, videos, discussions, FAQ, infobox and locations where relevant.

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: "/web/search",
  query: {
    "q": "example"
  }
});

console.log(output);

Query parameters

qrequired

string

Search query (max 600 chars, 75 words). Supports operators like site:, filetype:, quotes and -exclusions

country

string

2-letter country code for results (default US)

search_lang

string

Language code for results (default en)

ui_lang

string

UI language, e.g. en-US

count

integer

Web results per page (1-20, default 20)

offset

integer

Page offset (0-9)

safesearch

string

off, moderate, or strict (default moderate)

freshness

string

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

result_filter

string

Comma list of result types: discussions,faq,infobox,news,query,videos,web,locations

extra_snippets

boolean

Up to 5 extra excerpts per result

spellcheck

boolean

Spellcheck the query (default true)

text_decorations

boolean

Include highlight markers in snippets

units

string

metric or imperial

goggles

string

Goggle URL or inline definition for custom re-ranking

operators

boolean

Apply search operators (default true)

include_fetch_metadata

boolean

Include fetch metadata for results (default false)