几分钟内发送您的第一个请求
使用此现成代码示例,可在几分钟内测试 SERP API。Node.js 示例
Python 示例
直接 API 访问(推荐)
纯 REST API 方法,便于访问并实现直接集成。
基于代理的本地访问
适用于依赖代理路由的工作流程。
直接 API 访问(推荐)
一种简单、RESTful 的方式与 Bright Data 的 SERP API 交互。直接 API 访问抽象了代理管理,让您通过单一端点发送请求,确保使用简单且易于集成 REST API。最适合:
- 集中端点:通过单一 RESTful 端点访问 SERP API。
- 简化直接集成:无需管理代理或路由。
- 单一 API key 认证:安全易用,替代用户名密码管理。
发送您的第一个请求
在 设置 SERP API zone 后,您将在 zone 的 Overview 标签页中找到工作请求示例和 API key:
Direct API access - cURL
请求说明
-
API 端点:
https://api.brightdata.com/request -
Authorization Header:
Authorization: Bearer [INSERT YOUR API key]- API key 可在 SERP API zone 中找到
-
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 标签页中找到:
- 前往 账户设置
- 向下滚动并点击 “Add API key”
- 按屏幕提示完成流程
基于代理的本地访问
访问 SERP API 时,需要提供以下凭据:- Customer ID
- SERP API zone 名称
- SERP API 密码
- Bright Data SSL 证书
Customer ID
Customer ID 可在欢迎邮件中找到,或点击控制面板右上角账户首字母查看,或点击此处:账户设置Zone 名称和密码
在控制面板 Web Unlocker API zone 的 Overview 标签页中找到 zone 名称和密码Bright Data SSL 证书
SSL 证书可在 zone Overview 顶部菜单的 “SSL certificate” 向导中下载。更多说明见:SSL 证书 或者,可以选择 忽略 SSL 错误SERP API:HTTPS 代理示例代码
获取 API 凭据后,使用以下代码发送第一个请求:发送您的第一个异步请求
异步请求会提交任务并立即返回response_id,稍后再收取结果。当您不需要在同一次 HTTP 响应中拿到结果时,请使用异步方式。
启用异步请求
在您的 SERP API zone 中打开 Advanced settings,启用 Asynchronous requests。
提交任务
response_id:
查询状态并收取结果
任务仍在处理时,API 返回 HTTP202 与 "Request is pending"。任务完成后,收取结果:
results.json 中保存的是结构化的 SERP 响应。完整的字段说明见解析后的 JSON 结果。
Bright Data 能把响应推送到我指定的地址吗?
SERP API 的异步端点不支持。请使用response_id 轮询收取结果。如果需要 Bright Data 将数据投递到您自己的端点,请改用支持 webhook 投递的 Google Scraper API。
关于 webhook 配置、异步与同步的对比以及完整参数列表,见异步请求。