← 返回博客

2026 年如何使用 Google 搜索 API:完整指南

端到端学习使用 Google 搜索 API——身份验证、参数、解析、分页与成本控制——附带可复制粘贴的 Python、Node.js 和 curl 代码。

1 分钟阅读

这是一份实用的端到端指南,讲解如何使用 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国家默认值界面语言覆盖
page1结果页(从 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. 保持低成本

  1. 缓存命中是半价——不要对重复查询强制全新抓取。
  2. 懒加载分页。
  3. 精确选择 gl 以避免重复运行。

下一步

Frequently asked questions

如何调用 Google 搜索 API?+

发送一个带有你的查询的已验证 POST 请求。使用 serp.cheap:POST https://api.serp.cheap/v1/search,请求头 X-API-Key,JSON 请求体形如 {"q": "...", "gl": "us"}。响应是包含 organic[] 结果数组的 JSON。

我可以从浏览器调用 Google 搜索 API 吗?+

不可以——绝不要在客户端代码中暴露你的 API 密钥。请始终通过你自己的后端代理请求,以使密钥保持机密。

如何降低 Google 搜索 API 的成本?+

充分利用缓存(在 serp.cheap 上重复查询以半价提供),仅在需要时获取额外页面,并追踪每次调用的 stats.cost。

获取你的 API 密钥

直接购买最便宜, 用银行卡或加密货币支付,无需 KYC。或通过市场。