Skip to main content
GET
Image Search

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

accept
enum<string>
默认值:application/json

The default supported media type is application/json.

可用选项:
application/json,
*/*
示例:

"application/json"

api-version
string | null

The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.

cache-control
enum<string> | null

Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.

可用选项:
no-cache
Allowed value: "no-cache"
user-agent
string | null

The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.

查询参数

count
integer
默认值:50

The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested.

NOTE: Image search is not paginated and has no offset parameter. Raise count to get more results.

必填范围: 1 <= x <= 200
country
enum<string>
默认值:US

The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries and ALL for worldwide.

可用选项:
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
q
string
必填

The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.

Required string length: 1 - 400
safesearch
enum<string>
默认值:strict

Filters search results for adult content. The following values are supported:

  • off - No content filtering (except for illegal content).
  • strict - Drops all adult content from search results.
可用选项:
off,
strict
示例:

""

search_lang
enum<string>
默认值:en

The search language preference. The 2 or more character language code for which the search results are provided.

可用选项:
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
默认值:true

Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.

示例:

""

true

false

响应

Successful Response

query
Query · object
必填

Image search query string.

results
ImageResult · object[]
必填

The list of image results for the given query.

extra
Extra · object
必填

Additional information about the image search results.

type
enum<string>
默认值:images
可用选项:
images
Allowed value: "images"