Skip to main content

几分钟内发送您的第一个请求

使用此现成代码示例,可在几分钟内测试 SERP API。

Node.js 示例

Python 示例

Bright Data 提供两种访问 SERP API 的方法,两者提供 相同 结果,同时适应不同客户的工作流程:

直接 API 访问(推荐)

纯 REST API 方法,便于访问并实现直接集成。

基于代理的本地访问

适用于依赖代理路由的工作流程。

直接 API 访问(推荐)

一种简单、RESTful 的方式与 Bright Data 的 SERP API 交互。直接 API 访问抽象了代理管理,让您通过单一端点发送请求,确保使用简单且易于集成 REST API。

最适合:

  • 集中端点:通过单一 RESTful 端点访问 SERP API。
  • 简化直接集成:无需管理代理或路由。
  • 单一 API key 认证:安全易用,替代用户名密码管理。

发送您的第一个请求

设置 SERP API zone 后,您将在 zone 的 Overview 标签页中找到工作请求示例和 API key:
SERP API Overview 标签页
以下是简单 SERP API cURL 请求示例:
Direct API access - cURL

请求说明

  1. API 端点: https://api.brightdata.com/request
  2. Authorization Header: Authorization: Bearer [INSERT YOUR API key]
    • API key 可在 SERP API zone 中找到
  3. Payload:
    • zone:您的 SERP API zone 名称
    • url:完整 SERP 目标 URL(包含查询参数)
    • format:定义响应格式,使用 raw 可获取目标站点的原始响应

生成 Bright Data API key

Bright Data API key 是通过直接 API 访问 SERP API 的安全认证令牌。创建新的 SERP API zone 时,API key 会自动生成,可在 zone 的 Overview 标签页中找到:
SERP API key
生成新的 API key:
  • 前往 账户设置
  • 向下滚动并点击 “Add API key”
  • 按屏幕提示完成流程
强烈建议为 API key 设置过期时间以提高安全性
API key 仅在屏幕上显示一次,请确保复制并安全存储

基于代理的本地访问

访问 SERP API 时,需要提供以下凭据:
  1. Customer ID
  2. SERP API zone 名称
  3. SERP API 密码
  4. Bright Data SSL 证书

Customer ID

Customer ID 可在欢迎邮件中找到,或点击控制面板右上角账户首字母查看,或点击此处:账户设置

Zone 名称和密码

在控制面板 Web Unlocker API zone 的 Overview 标签页中找到 zone 名称和密码

Bright Data SSL 证书

设置 Bright Data SSL 证书以防止 SSL 错误
SSL 证书可在 zone Overview 顶部菜单的 “SSL certificate” 向导中下载。更多说明见:SSL 证书 或者,可以选择 忽略 SSL 错误

SERP API:HTTPS 代理示例代码

获取 API 凭据后,使用以下代码发送第一个请求:

发送您的第一个异步请求

异步请求会提交任务并立即返回 response_id,稍后再收取结果。当您不需要在同一次 HTTP 响应中拿到结果时,请使用异步方式。

启用异步请求

在您的 SERP API zone 中打开 Advanced settings,启用 Asynchronous requests
启用异步请求

提交任务

您应会收到一个 response_id
请保存该 ID,收取结果时需要用到。

查询状态并收取结果

任务仍在处理时,API 返回 HTTP 202"Request is pending"。任务完成后,收取结果:
results.json 中保存的是结构化的 SERP 响应。完整的字段说明见解析后的 JSON 结果

Bright Data 能把响应推送到我指定的地址吗?

SERP API 的异步端点不支持。请使用 response_id 轮询收取结果。如果需要 Bright Data 将数据投递到您自己的端点,请改用支持 webhook 投递的 Google Scraper API 关于 webhook 配置、异步与同步的对比以及完整参数列表,见异步请求