这是一份实用的端到端指南,讲解如何使用 Google 搜索 API:身份验证、发送查询、读取 JSON、分页、处理错误并降低成本。示例使用 serp.cheap(2026 年最便宜的选择),但这些概念适用于任何 SERP API。
1. 获取 API 密钥
在 app.serp.cheap/login 直接免费注册(100 次免费搜索,无需信用卡),然后获取你的 API 密钥。或者,你也可以通过 Apify 或 RapidAPI 注册。你会得到一个在 X-API-Key 请求头中传递的密钥。积分有效期为 12 个月。
2. 一行搞定的端点
POST https://api.serp.cheap/v1/search
| 参数 | 默认值 | 说明 |
|---|---|---|
q | 必填 | 搜索查询 |
gl | "us" | 国家/地区(例如 br、gb、de) |
hl | 国家默认值 | 界面语言覆盖 |
page | 1 | 结果页(从 1 开始索引) |
tbs | 无 | 时间过滤器:qdr:h、qdr:d、qdr:w |
完整参考:Google 搜索 API 参数。
3. 你的第一个请求
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'
import requests
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
print(item["position"], item["title"], item["link"])
特定语言指南:Python · Node.js · PHP · Go · curl。
4. 读取响应
{
"search": "best electric cars 2026",
"page": 1,
"organic": [
{
"position": 1,
"title": "Best Electric Cars of 2026",
"link": "https://example.com/best-evs",
"snippet": "We tested every major EV...",
"date": "Jan 10, 2026"
}
],
"stats": { "balance": 99994, "cost": 6, "cached": false }
}
stats.cost 以积分为单位(1 积分 = $0.0001)。一次全新抓取为 6 积分($0.0006);缓存命中为 3 积分($0.0003)。stats.cached 告诉你走的是哪条路径。
5. 分页
每一页都是单独的请求——递增 page。仅当用户确实需要时才获取第 2 页及以后。参见 获取 100 条结果。
6. 错误处理
- 401——API 密钥错误或缺失。
- 402——积分不足;请充值。
- 429——触发速率限制(免费套餐为 60 次/分钟,即 1 次/秒;按量付费(PAYG)为 600 次/分钟,即 10 次/秒;顶级套餐最高可达 60 次/秒);请退避后重试。
- 5xx——临时性错误;使用指数退避重试。
请始终用针对 429/5xx 的退避重试来包装调用。
7. 保持低成本
- 缓存命中是半价——不要对重复查询强制全新抓取。
- 懒加载分页。
- 精确选择
gl以避免重复运行。
下一步
-
构建一个真实项目:Python 排名追踪器 或 面向 AI 智能体的 Google 搜索。
-
比较各服务商:2026 年最便宜的 SERP API。
-
直接免费注册并获取你的 API 密钥 →(100 次免费搜索,无需信用卡)