Skip to main content
GET
Web search
Returns organic results, FAQ, discussions, inline videos/news/images, related searches and other source-provided rich blocks. page is a 1-based native page ordinal; count slices one native page without changing its boundaries. Inspect query_info for source spelling corrections and query relaxation. Credits: 7. Confirmed empty results and failed requests are unbilled. query must be nonblank and no longer than 2,048 characters. Country and UI-language codes come from the locale reference. Safe-search accepts off, moderate, or strict (default).

Errors

Invalid or unsupported parameters return 422; unavailable source content returns an error instead of a billable empty result. A key without the brave scope returns 403. See the overview for pagination, fields and authentication.

Authorizations

X-API-Key
string
header
required

Query Parameters

query
string
required

Native Brave search query

Required string length: 1 - 2048
country
enum<string>
default:us

Native result region; see /locales

Available options:
us,
all,
ar,
au,
at,
be,
br,
ca,
cl,
cn,
dk,
fi,
fr,
de,
gr,
hk,
in,
id,
it,
jp,
kr,
my,
mx,
nl,
nz,
no,
ph,
pl,
pt,
ru,
sa,
sg,
za,
es,
se,
ch,
tw,
tr,
gb
ui_language
enum<string>
default:en-us

UI labels/date language; does not restrict result language

Available options:
en-us,
az,
id,
ms,
br,
ca,
cs,
cy,
da,
de-de,
et,
en-ca,
en-in,
en-gb,
es,
eu,
fr-ca,
fr-fr,
gl,
hr,
it,
sw-ke,
lv,
lt,
hu,
nl,
nb,
pl,
pt-br,
ro,
sq-al,
sk,
sl,
sr-latn,
fi-fi,
sv,
vi,
tr,
el,
bg,
ru,
sr,
uk,
ka,
th,
ko,
zh,
zh-tw,
ja-jp
Available options:
off,
moderate,
strict
page
integer
default:1

1-based native page ordinal

Required range: 1 <= x <= 10
count
integer
default:20

Slice one native page; does not change native page boundaries

Required range: 1 <= x <= 20
freshness
enum<string>
default:any
Available options:
any,
day,
week,
month,
year
spellcheck
boolean
default:false

Allow native spelling correction

Response

Successful Response

query
string
required
country
string
required
ui_language
string
required
result_count
integer
required
results
BraveResult · object[]
required
query_info
Query Info · object
required
source_url
string
required
fetched_at
string
required
fetched_utc
number
required
page
integer
required
has_next
boolean
required
next_page
integer | null
faq
Faq · object[]
discussions
BraveResult · object[]
videos
BraveResult · object[]
news
BraveResult · object[]
images
BraveResult · object[]
rich_blocks
Rich Blocks · object