SERP API 常见问题

通过详细的常见问题解答，了解如何高效使用 Bright Data 的 SERP API，包括设置、故障排查及高级搜索技巧，如 Google 图片和酒店数据抓取。

为什么要使用 Bright Data 的 SERP API？

Bright Data SERP API 解决方案让你专注于最重要的事情——数据。它提供了一个三合一代理解锁方案，自动处理 代理管理（选择何时使用哪个代理）、解锁逻辑（验证码破解、指纹识别、重试、最佳请求头等）以及 抓取 功能。

易于集成

易于集成

在代码中，只需将常规代理请求的一行替换为 SERP API 请求即可。

只为成功请求付费

易于集成

仅为成功请求付费。

稳定且可预测的计费

易于集成

因为按页面数计费（每千次请求价格），请求的带宽无影响。

高精度

易于集成

使用真实用户设备，进行精确的地理定位（包括城市级）采集主要搜索引擎的搜索结果页 (SERPs)。

支持高流量和扩展

易于集成

Bright Data 能支持增长中的流量需求和高峰期请求，成功率高，响应时间优异（低于 5 秒）。

降低成本

易于集成

节省数据抓取工程师和 IT 人员成本，无需担心服务器维护。

避免运营问题

易于集成

每个请求使用不同 IP，确保不被封禁。

结构化数据响应

易于集成

获取解析或未解析的 JSON 或 HTML 响应，方便集成到任何系统。

高度自定义

易于集成

支持多种参数以满足搜索需求，包括不同搜索类型、设备、每页结果数等。

真实住宅 IP

易于集成

可访问每月 4 亿+ 住宅 IP，覆盖所有地理位置。

如何使用 SERP API 进行 "Google 图片搜索"？

使用 Bright Data SERP API 可以轻松收集 Google 图片搜索数据。

Google 反向图片搜索（官方称为 “Google Search by Image”）允许用户 以图片作为起点 进行搜索，而非文字或语音查询。

JSON 响应包含以 base64 编码的图片。

使用图片 URL 搜索

curl -v --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/searchbyimage?image_url={TARGET_IMAGE_URL}"

查看更多 Google 图片 SERP 功能。

如何使用 SERP API 抓取酒店数据？

Bright Data SERP API 可轻松收集酒店数据，如价格、可用性、评价等。

抓取酒店数据有两种方式：

Google 搜索酒店知识图谱

提供每家酒店的有限价格和日期信息

当你在 Google 搜索特定酒店时，酒店详情和评价会显示在右侧知识图谱/小部件中：

可设置入住/退房日期、入住人数及比较价格。

使用 SERP API，可通过专用参数设置这些字段以收集不同价格组合。完整酒店参数和功能见 API 文档。

Google Travel 酒店页面

提供酒店全量详情、价格及日期

SERP API 还可抓取 Google Travel 酒店页面（Google.*/travel/hotels/…），可获取更多价格并按额外参数搜索（如入住/退房日期、成人和儿童人数、儿童年龄、是否可免费取消）。

仅支持 //Google.*/travel/hotels/… URL。

在控制面板 API 指南 查看如何抓取该页面及可用参数，或查看 API 文档。

如何在不使用 SSL 证书的情况下发送 SERP API HTTPS 请求？

针对 HTTPS，URL 数据是加密的。因此，为了让 SERP API 解密数据并返回结果，你需要下载并安装 Bright Data 证书。

示例代码：

Shell

curl "https://www.google.com/search?q=pizza&lum_json=1" -v --insecure --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

如何发送带 SSL 验证的 HTTPS 请求？

Shell

使用 --cacert 标志加上证书路径：

Shell

curl -v --compressed "https://www.google.com/search?q=pizza&lum_json=1" --cacert “{证书路径}“ --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

Java

将证书导入 Java Keystore，例如使用 keytool：

Java

%JAVA_HOME% Keystore（通常在 ..\lib\security\cacerts）

其他编程语言

按照文章 下载并安装 Bright Data 证书 指导，将证书添加到本地受信任根证书。

Shell

T_ID&zone={ASYNC_ZONE}&output={output_fomat_html/json}&response_id={response_id} -H "Authorization: Bearer {API_KEY}" -o {Your_result_ouput_file}

如何解析 SERP API 返回的 JSON？

请参考文章：解析搜索结果

如何在同一 API 请求中发送多查询？

SERP API 支持在单个 API 请求中使用 multi 参数发送 2 个并行查询。

这些并行请求使用相同 IP 和会话，可用于收集额外数据、对比测试等。

条件：

• 仅支持启用 异步请求 的 zone
• 仅支持 Google 搜索
• 限制为 2 个请求
• 按 2 个请求计费

不同 num 参数

multi:[
  {"keyword":"pizza","num":20},
  {"keyword":"pizza","num":100}
]

发送请求

curl -v --compressed "https://api.brightdata.com/serp/req" -H "Content-Type: application/json" -H "Authorization: Bearer $API_KEY" -d "{\"zone\":\"$ZONE\",\"country\":\"us\",\"multi\":[{\"keyword\":\"pizza\",\"num\":20},{\"keyword\":\"pizza\",\"num\":100}]}"

Google 最近停止支持 `num` 参数，我该怎么办？

自 2025 年 9 月 10 日起，Google 已开始逐步弃用 num 参数。

我们建议需要更多 Google SERP 页面（超过第一页）的客户使用 Bright Data 的 Scrapers（Google SERP – 100 Results）一次获取前 100 个结果，无需手动分页，可通过 start_page/end_page 控制深度（1..10 ≈ 前 100）。

了解如何一次获取前 100 条结果

SERP API 的常见使用场景有哪些？

自然排名监测

自然排名监测

监测公司在不同地区的关键词排名

品牌保护

自然排名监测

追踪公司品牌及商标的搜索结果

价格比较

自然排名监测

对在线购物网站商品进行搜索并比较不同供应商价格

市场调研

自然排名监测

收集公司、联系人、地点等信息

版权侵权检测

自然排名监测

搜索图片或其他受版权保护的内容

广告情报

自然排名监测

查看不同国家关键词展示的广告，包括 DoubleClick 和 Google 广告服务

如何对 Microsoft Bing 进行日期过滤查询？

以下内容分析 Bing 上不同日期搜索查询选项及使用方法。

​

日期过滤查询类型

所有日期

不使用日期过滤

• URL: https://www.bing.com/search?q=YOUR_QUERY

过去 24 小时

URL 加上 filters=ex1%3a"ez1"

• URL: https://www.bing.com/search?q=YOUR_QUERY&filters=ex1%3a”ez1”

过去一周

URL 加上 filters=ex1%3a"ez2"

• URL: https://www.bing.com/search?q=YOUR_QUERY&filters=ex1%3a”ez2”

过去一年

URL 加上 filters=ex1%3a"ez3"

• URL: https://www.bing.com/search?q=YOUR_QUERY&filters=ex1%3a”ez3”

精确匹配

指定精确日期范围，URL 添加 filters=ex1:"ez5_StartDateSequence_EndDateSequence"

• URL: https://www.bing.com/search?q=YOUR_QUERY&filters=ex1:“ez5_StartDateSequence_EndDateSequence”

StartDateSequence 和 EndDateSequence 可按以下逻辑计算。

​

精确匹配日期序列计算

1. 以已知序列为起点

   使用 2024 年 1 月 1 日为起点，已知序列为 19723

2. 计算 StartDateSequence

   • 统计从 1 月 1 日到目标开始日期的天数
   • 将统计天数加到起点序列数，得到 StartDateSequence

   计数从 0 开始，例如 0, 1, 2 …

   ​

   示例：

   计算 2024 年 2 月 4 日序列：

   • 1 月 1 日到 2 月 4 日共 35 天
   • 35 - 1 = 34
   • 2 月 4 日序列: 19723 + 34 = 19757 (StartDateSequence)

3. 计算 EndDateSequence

   将日期范围天数加到 StartDateSequence，得到 EndDateSequence。

   ​

   示例：

   2 月 4 日序列: 19757 2 月 4 日到 2 月 20 日天数: 17 17 - 1 = 16 2 月 20 日序列: 19757 + 16 = 19773 (EndDateSequence)

4. 构建序列字符串

   • 格式：ez5_StartDateSequence_EndDateSequence
   • 替换起始序列和结束序列

   ​

   示例：

   • 起始序列: 19757
   • 结束序列: 19773
   • 序列字符串: ez5_19757_19773
   • 查询 pizza 的 URL:
     https://www.bing.com/search?q=pizza&filters=ex1:“ez5_19757_19773”

   

为什么会出现错误: "400 this endpoint is not supported"?

SERP API 仅支持部分搜索引擎相关域名/端点，某些子域或端点可能不支持。例如：https://trends.google.com/trends 不支持，而 https://trends.google.com/trends/explore 支持。

建议查看 SERP Playground 和 SERP 文档 了解支持的域名和路径示例。

如何在 Google 搜索结果中查看更多广告？

如果你在监控 Google 搜索广告并希望最大化可见性，可在 Google.com SERP API 请求中使用 Enhanced Ads 功能。

默认 SERP 行为：

• 获取广域内的自然搜索结果和广告。 启用 Enhanced Ads：
• 扩展搜索结果和广告范围，模拟无 Cookie 的隐身浏览体验。

在控制面板 SERP API zone 配置页启用该功能。

了解更多

如何提高 SERP API 响应速度？

使用 "data_format": "parsed_light" 可获取 前 10 条结果更快，或联系 [e-mail] 了解 sub-1 秒高级路由。