[ PROMPT_NODE_27848 ]
serp-api
[ SKILL_DOCUMENTATION ]
# SERP API 参考
## 目录
- [概述](#概述)
- [身份验证](#身份验证)
- [REST API (推荐)](#rest-api-推荐)
- [代理接口](#代理接口)
- [请求参数](#请求参数)
- [Google 搜索参数](#google-搜索参数)
- [Bing 搜索参数](#bing-搜索参数)
- [解析后的 JSON 输出](#解析后的-json-输出)
- [异步请求](#异步请求)
- [计费模式](#计费模式)
- [最佳实践](#最佳实践)
---
## 概述
Bright Data SERP API 从 Google、Bing、Yandex 和 DuckDuckGo 提取结构化搜索引擎结果。它自动处理代理管理、验证码求解,并在 5 秒内交付结果。
**返回内容:**
- 自然搜索结果(标题、描述、链接、排名)
- 付费广告(顶部、底部、产品列表、高级)
- 本地商家列表 (snack pack)
- 购物结果
- 相关搜索和“人们也在问”
- 知识面板
- 专业 SERP 功能(地图、趋势、评论、镜头、酒店、航班)
---
## 身份验证
bash
export BRIGHTDATA_API_KEY="your-api-key"
export BRIGHTDATA_SERP_ZONE="your-serp-zone-name"
创建 SERP API 区域时会自动生成 API 密钥。可以在账户设置中生成额外密钥。建议为密钥设置过期日期以确保安全。
---
## REST API (推荐)
**端点:** `POST https://api.brightdata.com/request`
**标头:** `Authorization: Bearer YOUR_API_KEY`
### Google 搜索
python
import requests
response = requests.post(
"https://api.brightdata.com/request",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"zone": "YOUR_SERP_ZONE",
"url": "https://www.google.com/search?q=python+web+scraping",
"format": "raw"
}
)
html = response.text
### 带解析 JSON 的 Google 搜索
python
response = requests.post(
"https://api.brightdata.com/request",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"zone": "YOUR_SERP_ZONE",
"url": "https://www.google.com/search?q=python+web+scraping&brd_json=1",
"format": "raw"
}
)
data = response.json()
for result in data.get("organic", []):
print(result["title"], result["link"])
javascript
const response = await fetch("https://api.brightdata.com/request", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
zone