跳转到主要内容

搜索

现在 Google 所有搜索结果均通过 google.com 提供,因此发送到其他 Google TLD(如 google.co.ukgoogle.ca)的 SERP API 请求会自动路由到 google.com本地化 不再由 TLD 决定,而应使用下面的 gl(国家)和 hl(语言)参数进行配置:

gl

两字母国家代码,用于定义搜索所在国家
gl

hl

两字母语言代码,用于定义页面语言
hl

tbm

定义搜索类型。常规搜索无需使用 tbm 参数,其他类型有特定的 tbm 值。

示例:

tbm=isch - 图片
tbm=shop - 购物
tbm=nws - 新闻
tbm=vid - 视频

ibp

用于 Jobs 搜索类型。

示例:

ibp=htl;jobs - 工作搜索

start

定义结果偏移量,用于分页控制。

示例:

start=0(默认)- 第一页结果
start=10 - 第二页结果
start=20 - 第三页结果,依此类推

num

已弃用。返回结果数固定为 10。
自 2025 年 9 月 11 日起,Google 已逐步废弃 num 参数功能。
建议使用 分页请求。详情请参阅我们的 FAQ

uule

编码后的搜索位置,用于更改地理位置。可在 此处 下载所有可用 uule 值的 CSV。CSV 中的 “Canonical Name” 列可直接作为 API 参数值

示例:

&uule=New+York,New+York,United+States

brd_mobile

定义使用的设备类型。
默认或 brd_mobile=0 提供随机桌面 User-Agent;brd_mobile=1 提供随机移动 User-Agent。
特定移动平台值:
brd_mobile=ios - iPhone (别名 brd_mobile=iphone)
brd_mobile=ipad - iPad (别名 brd_mobile=ios_tablet)
brd_mobile=android - Android 手机
brd_mobile=android_tablet - Android 平板

brd_browser

定义使用的浏览器类型。可与 brd_mobile 配合使用。默认提供随机浏览器。
特定浏览器值:
brd_browser=chrome - Google Chrome
brd_browser=safari - Safari
brd_browser=firefox - Mozilla Firefox(不兼容 brd_mobile=1

hotel_occupancy

入住人数(最多 4 人)。
参见 Hotels 的 brd_occupancy 参数,可提供更多灵活性。

示例:

hotel_occupancy=1 - 1 位客人
hotel_occupancy=2(默认)- 2 位客人

hotel_dates

入住和退房日期,逗号分隔。
格式:YYYY-MM-DD,YYYY-MM-DD

示例:

hotel_dates=2022-05-01,2022-05-03 - 查询 2022 年 5 月 1 日至 3 日的可用房间
请注意,平行请求仅适用于异步模式。

multi

使用 POST 请求通过 API 发起平行请求。
可用于比较测试,即对相同参数的不同值发起多个请求。
multi=[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}] - 相同关键词不同 num 参数
multi=[{"query":{"q":"pizza"}},{"query":{"q":"burger"}}] - 不同关键词
发起请求:
x-response-id 包含请求 ID,用于后续获取结果:

brd_ai_overview

设置 brd_ai_overview=2增加 在 SERP 响应中获得 Google Generative AI Overview 的概率,通常出现在约 15-20%+ 的结果中。
  • 使用该参数可能使 SERP API 响应延迟增加约 5-10 秒,因为需启动浏览器抓取完整 AI Overview 内容。
  • 为触发 AI Overview,关键词需与 Google 认为适合生成的主题相关。

已解析的 AI Overview 示例

地图

gl

两字母国家代码,用于定义搜索所在国家
gl

hl

两字母语言代码,用于定义页面语言
hl

geo params

定义搜索位置的 GPS 坐标。构造方式为:@ + 纬度 + , + 经度 + , + 缩放级别

示例:

@47.30227,1.67458,14.00z
zoom 参数可选,但推荐使用以获得更高精度。范围从 3z(完全缩小)到 21z(完全放大)。

start

定义结果偏移量,用于分页控制。

示例:

start=0(默认)- 第一页结果
start=10 - 第二页结果
start=20 - 第三页结果,依此类推

num

定义返回结果的数量。

示例:

num=20(默认)- 返回 20 条结果
num=50 - 返回 50 条结果,依此类推

fid

根据 fid 获取 Google Maps 地点信息。使用 GET 请求访问 http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s,在末尾添加 fid 值。

brd_accomodation_type

住宿类型:酒店或度假租赁。

示例:

brd_accomodation_type=hotels(默认)- 搜索酒店
brd_accomodation_type=vacation_rentals - 搜索度假租赁

brd_json

Bright Data 自定义参数,可返回解析后的 JSON 而非原始 HTML。

示例:

brd_json=1 - 返回 JSON 格式结果

趋势(Trends)

必需参数
brd_json=1:返回解析后的 JSON 结果(Trends 仅支持解析结果)。
brd_trends=timeseries,geo_map:获取成功率最高的小组件数据。
我们仅支持 Google Trends 中的“Trending now(实时热点)”标签。其他标签(例如 “Explore(探索)”、“Home(主页)”)不受支持,因为它们需要登录才能完整访问功能。

geo

感兴趣的地区,两字母国家代码。

hl

首选语言,两字母语言代码。

date

要搜索的时间范围。
可用值包括:
now 1-H - 过去 1 小时
now 4-H - 过去 4 小时
now 1-d - 过去 1 天
now 7-d - 过去 7 天
today 1-m - 过去 30 天
today 3-m - 过去 90 天
today 12-m(默认)- 过去 12 个月
today 5-y - 过去 5 年
2020-07-01 2020-12-31 - 自定义日期范围

cat

搜索的类别。默认在所有类别中搜索。
可在此查看所有类别列表:
https://trends.google.com/trends/api/explore/pickers/category?lang=en-US&tz=240

gprop

要筛选的 Google 属性。默认 Web 搜索。
可选值包括:imagesnewsfroogle(Google Shopping)、youtube

Reviews

fid

Feature id 是用于获取评论的数据字段。fid 参数可以在 Google 搜索响应中的 knowledge.fid 字段里找到。

For example:

https://www.google.com/search?q=hilton%20new%20york%20midtown

hl

首选语言,两字母语言代码。

sort

评论排序方式。
Possible values are:
sort=qualityScore(默认)- 最相关优先
sort=newestFirst - 最新优先
sort=ratingHigh - 评分最高优先
sort=ratingLow - 评分最低优先

filter

关键词过滤器。只返回包含指定关键词的评论。

For Example:

filter=awesome - 搜索包含 ‘awesome’ 的评论

start

定义结果偏移量——从哪个结果开始返回。用于分页管理。

Examples:

start=0(默认)- 第一页结果
start=10 - 第二页结果
start=20 - 第三页结果,依此类推。

num

定义返回结果的数量。

Examples:

num=10(默认)- 返回 10 条结果
num=20 - 返回 20 条结果(最大值)。

Lens

url

你要搜索的图片 URL。

hl

首选语言,两字母语言代码。

upload

上传当前目录下名为 cat.jpg 的图片(不支持 async zones)。

brd_lens

请求中的 brd_lens 参数通过指定 tab 值(例如 productshomeworkvisual_matchesexact_matches)来获取特定 Google Lens 标签结果brd_lens

Hotels(酒店)

gl

用于定义搜索国家的两个字母国家代码。

hl

用于定义页面语言的两个字母语言代码。

brd_dates

入住与退房日期,以逗号分隔。

格式:

YYYY-MM-DD,YYYY-MM-DD

示例:

2022-01-20,2022-02-05

brd_occupancy

预订房间的入住人数(最多 6 人)。

示例:

brd_occupancy=1 - 查询 1 人房间
brd_occupancy=2(默认)- 2 人
brd_occupancy=3 - 3 人,依此类推。
也支持逗号分隔的整数列表,其中:
  • 第一个值为成年人数
  • 后续值为儿童年龄

格式:

brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>

示例:

brd_occupancy=1,5,7,12 - 1 名成人 + 3 名儿童(5、7、12 岁)
brd_occupancy=2,1,3 - 2 名成人 + 2 名儿童(1、3 岁)

brd_free_cancellation

仅显示可免费取消的房型。

示例:

brd_free_cancellation=true - 仅显示可免费取消
brd_free_cancellation=false(默认)- 显示所有选项

brd_accomodation_type

住宿类型:酒店或度假租赁。

示例:

brd_accomodation_type=hotels(默认)- 搜索酒店
brd_accomodation_type=vacation_rentals - 搜索度假租赁

brd_currency

展示价格的货币(3 字母货币代码)。

示例:

brd_currency=USD - 美元
brd_currency=EUR - 欧元
brd_currency=INR - 印度卢比

brd_mobile

定义使用何种设备类型的 user-agent。默认或 brd_mobile=0 会使用随机桌面 UA,而 brd_mobile=1 会使用随机移动 UA。
指定移动平台可使用以下值:
brd_mobile=ios - iPhone UA(别名 brd_mobile=iphone
brd_mobile=ipad - iPad UA(别名 brd_mobile=ios_tablet
brd_mobile=android - 安卓手机
brd_mobile=android_tablet - 安卓平板

brd_json

Bright Data 自定义参数,用于返回解析后的 JSON 而不是原始 HTML。

示例:

brd_json=1 - 返回 JSON 结果

Flights(航班)

gl

用于定义搜索国家的两个字母国家代码。

hl

用于定义页面语言的两个字母语言代码。

tfs

表示航班搜索参数的字符串。

curr

用于定义返回价格的货币。