跳转到主要内容
本指南使用 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 条):

关键参数

分页范围: 使用 start_pageend_page 控制深度:
  • 1..2 ≈ 前 20 条结果
  • 1..5 ≈ 前 50 条结果
  • 1..10 ≈ 前 100 条结果
较小范围完成更快,返回的 payload 更小。

AI Overview 提取

当搜索查询可用时,API 会自动捕获 Google AI Overview

什么是 AI Overview?

AI Overview 是 Google 自动生成的摘要,显示在搜索结果顶部,提供来自多个来源的快速答案。

返回字段

AI Overview 文本返回在 aio_text 字段中:
AI Overview 可用性: 如果搜索结果没有显示 AI Overview,则 aio_text 字段为空或 null。

示例处理

理解异步工作流

Scrapers 为异步工作模式,工作流程如下:
  1. 触发请求 → 获取 snapshot_id
  2. 监控进度 → 使用 snapshot_id 查看状态
  3. 下载结果 → 完成后获取数据

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
当 Google 显示 AI Overview 且输出字段中包含该字段时,它会返回。未来将提供开关以显式包含或排除 AIO。
我们现在使用浏览器工作器进行 SERP 抓取。这减少了重复结果,提高了分页间的会话连续性,并支持更丰富的输出(例如 AI Overview)。所有现有请求仍向后兼容。
一次成功的 API 调用 = 一次计费请求,即使它返回了 10 页共 100+ 结果。重试请求自动包含在内,无额外带宽费用。完整详情请参见 SERP 计费
  • language:控制 Google 使用的界面语言(例如 "en""de""es"
  • country:控制结果的地理位置(例如 "US""DE""MX"
这两个参数可以独立组合,以针对特定市场。
时间取决于查询复杂度和页面深度。较小的页面范围(例如 1..2)完成速度快于较大范围(例如 1..10)。可使用 Progress API 监控请求状态。

下一步

计费与费用

了解请求的计费方式

Google 查询参数

探索所有可用参数

解析后的 JSON 结果

了解响应结构

异步请求

深入异步工作流