本指南使用 Scrapers(Datasets)一次请求返回 Google SERP 第 1-100 位。您可以控制语言、地理定位、分页深度和设备类型。
前置条件
开始前,请确保您拥有:- 一个有效的 Bright Data 账户
- API key(在仪表盘 API Tokens 中可找到)
- Dataset ID:
gd_mfz5x93lmsjjjylob
计费说明: 一次成功的 API 调用 = 一次计费请求,无论分页深度如何。包含重试,无额外带宽费用。详情请参见 SERP 定价与计费。
快速开始
尝试以下示例,一次请求获取前 100 条结果。将${API_KEY} 替换为您的实际 API key。
在 Postman 测试
预配置的 Google SERP 前 100 条结果集合
基本示例
该示例返回大约 100 条结果(10 页 × 每页约 10 条):关键参数
AI Overview 提取
当搜索查询可用时,API 会自动捕获 Google AI Overview。什么是 AI Overview?
AI Overview 是 Google 自动生成的摘要,显示在搜索结果顶部,提供来自多个来源的快速答案。返回字段
AI Overview 文本返回在aio_text 字段中:
AI Overview 可用性: 如果搜索结果没有显示 AI Overview,则
aio_text 字段为空或 null。示例处理
理解异步工作流
Scrapers 为异步工作模式,工作流程如下:- 触发请求 → 获取
snapshot_id - 监控进度 → 使用
snapshot_id查看状态 - 下载结果 → 完成后获取数据
API 端点
了解更多异步工作流,请参见 异步请求。
完整工作流示例
高级配置
批量多个查询
一次请求处理多个搜索查询:移动端搜索结果
添加"brd_mobile": true 获取移动端 SERP 数据:
cURL
从 Web 标签页获取结果(udm=14)
Google 的udm 参数定义了 SERP 来自哪个搜索标签页。Bright Data SERP Scraper 将原生 Google 的 udm 值映射到其自己的请求参数 udm_web。
要获取 Web 标签页(即 Google 上的 udm=14)的结果,请在请求中将 udm_web 设置为 true:
udm_web 参数无法与 tbm 参数同时使用。cURL
包含 HTML 快照
同时捕获原始 HTML 以便审计或自定义解析:pagination[].page_html。
本地化示例
通过语言和国家组合定位特定市场:常见问题
如何选择特定的输出字段?
如何选择特定的输出字段?
您可以选择返回所有页面的解析字段。若要同时包含每页的原始 HTML,请在请求中添加
"include_paginated_html": true。这样会在解析字段旁返回 pagination[].page_html。我可以控制 AI Overview (AIO) 的显示吗?
我可以控制 AI Overview (AIO) 的显示吗?
当 Google 显示 AI Overview 且输出字段中包含该字段时,它会返回。未来将提供开关以显式包含或排除 AIO。
浏览器工作器实现有什么变化?
浏览器工作器实现有什么变化?
我们现在使用浏览器工作器进行 SERP 抓取。这减少了重复结果,提高了分页间的会话连续性,并支持更丰富的输出(例如 AI Overview)。所有现有请求仍向后兼容。
Top 100 结果的计费方式是什么?
Top 100 结果的计费方式是什么?
一次成功的 API 调用 = 一次计费请求,即使它返回了 10 页共 100+ 结果。重试请求自动包含在内,无额外带宽费用。完整详情请参见 SERP 计费。
language 和 country 参数有什么区别?
language 和 country 参数有什么区别?
language:控制 Google 使用的界面语言(例如"en"、"de"、"es")country:控制结果的地理位置(例如"US"、"DE"、"MX")
获取结果需要多长时间?
获取结果需要多长时间?
时间取决于查询复杂度和页面深度。较小的页面范围(例如
1..2)完成速度快于较大范围(例如 1..10)。可使用 Progress API 监控请求状态。下一步
计费与费用
了解请求的计费方式
Google 查询参数
探索所有可用参数
解析后的 JSON 结果
了解响应结构
异步请求
深入异步工作流