# Google Custom Search JSON API 替代方案：2027 年 1 月 1 日之前该用什么

> Google 的 Custom Search JSON API 已对新用户关闭，并将于 2027 年 1 月 1 日终止。迁移到 US$0.30/千次搜索 提供的全网页 JSON 结果，无需 KYC，加密货币支付。

- URL: https://serpcrypto.com/zh/alternatives/google-custom-search-api/
- 最后更新: 2026-10-22
- 发布者: SerpCrypto (https://serpcrypto.com)

Google 已将其 Custom Search JSON API 对新客户关闭，并将于 2027 年 1 月 1 日对所有人终止。本页说明会有哪些变化、Google 提供了什么替代方案，以及如何在一个下午内将你的代码迁移到 SERP API。

**快速回答 — 什么可以替代 Google Custom Search JSON API？**

Google 的 Custom Search JSON API 已对新客户关闭，现有客户必须在 **2027 年 1 月 1 日** 前迁移。Google 指向 Vertex AI Search，最多支持 50 个域名；对于全网页结果，SERP API 是常见的替代方案。**SerpCrypto** 从 US$0.30/千次搜索 以 JSON 返回完整的 Google 搜索结果页，而 Custom Search 为每 1,000 次查询 $5（2026 年 10 月）。无需 KYC；加密货币支付。

## Google Custom Search JSON API：2026 年 10 月 22 日的状态

| 属性 | 值 |
| --- | --- |
| 新客户 | 已关闭：“The Custom Search JSON API is closed to new customers” |
| 服务终止 | 现有客户为 2027 年 1 月 1 日 |
| 价格 | 每天 100 次查询免费，之后每 1,000 次查询 $5，每天最多 10,000 次查询 |
| 每次请求的结果数 | 最多 10 条 |
| “Search the entire web” | 自 2026 年 1 月 20 日起，新的 Programmable Search Engine 不可用；现有引擎可继续使用至 2027 年 1 月 1 日 |
| Google 建议的替代方案 | Vertex AI Search，用于搜索最多 50 个域名 |
| Google 提供的全网页 API | Web Search Service API：仅限合作伙伴，无公开价格 |

## Google 到底在改变什么，什么时候改变？

Google 正在将其开发者搜索产品收窄为站内搜索和企业搜索。这些变化于 2026 年 1 月 20 日在 Programmable Search Engine 博客上公布。

- **2026 年 1 月 20 日：**新的 Programmable Search Engine 只能搜索一个站点列表，最多 50 个域名。“Search the entire web”选项不再向新引擎提供。
- **目前：**Custom Search JSON API 不接受新客户。现有客户每天保留 100 次免费查询，之后每 1,000 次查询支付 $5，每天最多 10,000 次。
- **2027 年 1 月 1 日：**Custom Search JSON API 对所有人停止，现有引擎失去“Search the entire web”。Google 的帮助页面补充说，该选项一旦关闭，就无法重新开启。

如果你的产品目前发送 Custom Search 请求，从本页日期算起大约还有十周时间。

## 哪种替代方案适合哪种需求？

正确的选择取决于一个问题：你是搜索自己控制的少数几个站点，还是搜索 Google 所展示的整个网页？

| 方案 | 谁可以使用它 | 搜索整个网络 | 公开价格 | 状态 |
| --- | --- | --- | --- | --- |
| SerpCrypto SERP API | 任何持有加密货币的人，无需 KYC | 是：Google 搜索结果页面以 JSON 返回 | 10,000 次 US$7.50；起价 US$0.30/千次搜索 | 可用 |
| Custom Search JSON API | 仅限现有客户 | 仅限现有的“整个网络”引擎 | 每天 100 次免费后，每 1,000 次 $5 | 2027 年 1 月 1 日结束 |
| Programmable Search Engine，新建引擎 | 任何人 | 否：最多 50 个域名 | — | 仅限要搜索的站点 |
| Vertex AI Search | Google Cloud 客户 | 否：Google 建议用于最多 50 个域名 | Google Cloud 定价 | 可用 |
| Web Search Service API | Google 与合作伙伴客户 ID 联手 | 是 | 未公布 | 仅限合作伙伴 |

*价格核对于 2026年10月22日.*

来源见页面底部。“—” 表示不适用或未公布。

## Custom Search 的参数如何对应到 SerpCrypto API？

大多数参数都有直接对应项，有两个则会消失。你不再需要 `cx`，因为无需配置搜索引擎：每次请求都会搜索整个 Google。API 密钥从 `key` 参数改为 `Authorization` 请求头，或者如果你更喜欢用查询字符串，则改为 `api_key`。

| Custom Search JSON API | SerpCrypto | 备注 |
|---|---|---|
| `q` | `q` | 查询语法相同，包括 `site:` 等运算符 |
| `key` | `Authorization: Bearer …` 或 `api_key` | |
| `cx` | — | 不需要：全网结果 |
| `num` (1–10) | — | Google 每页大约返回 10 条自然结果 |
| `start` (1, 11, 21…) | `page` (1, 2, 3…) | `page = (start - 1) / 10 + 1`；Custom Search 最多到第 100 条结果，`page=10` 也是如此 |
| `gl` | `gl` | 两字母国家代码 |
| `hl`、`lr` | `hl` | 界面语言 |
| `safe` | `safe` | `active` 或 `off` |
| `siteSearch` | `q` 中的 `site:example.com` | |
| `dateRestrict` (`d7`、`m1`…) | `period` (`h`、`d`、`w`、`m`、`y`) | 步长更粗 |

在响应方面，`items[]` 变为 `organic_results[]`，而 `title`、`link` 和 `snippet` 保留原名。`displayLink` 变为 `displayed_link`。你还能获得 Custom Search 从未返回的模块：广告、People Also Ask、AI Overview、本地商家包和头条新闻。

*Python：同一查询的前后对比*

```python
import os

import requests

# Before: Custom Search JSON API (ends 1 January 2027)
# requests.get("https://www.googleapis.com/customsearch/v1",
#              params={"key": KEY, "cx": CX, "q": "solar inverter", "gl": "de", "start": 11})

# After: SerpCrypto
resp = requests.get(
    "https://serpcrypto.com/api/v1/search",
    headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
    params={"q": "solar inverter", "gl": "de", "hl": "de", "page": 2},
    timeout=60,
)
resp.raise_for_status()
for item in resp.json().get("organic_results", []):
    print(item["position"], item["title"], item["link"], item.get("snippet", ""))

```

## 与 Custom Search 相比，迁移需要多少成本？

Custom Search 每天前 100 次查询免费，之后每 1,000 次查询收费 $5，每日上限为 10,000 次查询。截至 2026 年 10 月，SerpCrypto 每次成功搜索收取一个积分：10,000 次搜索 套餐为 US$0.75/千次搜索，100,000 次搜索 为 US$0.56/千次搜索，1,000,000 次查询 为 US$0.38/千次搜索。

以每天发送 3,000 次查询的应用为例。在 Custom Search 上，其中 2,900 次要付费，约每天 $14.50，或每月 $435。同样的每月 90,000 次搜索，用 100,000 次搜索 套餐只需 US$56.25。搜索次数不受每日配额限制，而受并发数限制，未使用的积分不会过期。

## 我会失去什么，又会得到什么？

你会失去合同上的 Google 品牌，以及每天 100 次的免费查询。SerpCrypto 没有免费额度：最小的套餐是 US$7.50 的 10,000 次搜索，需通过 US$25 充值支付。

你得到的是人们实际看到的页面。Google 自己的帮助页面说，Programmable Search Engine 只使用 Google 索引的一个子集，缺少 Google.com 的 Oneboxes 和实时结果等功能。它的 API 也从不返回 AI Overview 或地图包。使用 SERP API，你在每次请求中还能获得国家、语言、城市和设备定位，同一个密钥即可覆盖 Google News、Images、Maps、Shopping 和 Bing。

## 哪个套餐能替代我的 Custom Search 用量？

将你每天在 Custom Search 上的查询次数乘以 30。每天低于 300 次时，10,000 次搜索 能用超过一个月；每天 3,000 次时，100,000 次搜索 够用一个月。积分永不过期。

| 套餐 | 数量 | 价格 | 单价 |
| --- | --- | --- | --- |
| 测试 | 10,000 次搜索 | US$7.50 | US$0.75/千次搜索 |
| 构建 | 100,000 次搜索 | US$56.25 | US$0.56/千次搜索 |
| 规模 | 500,000 次查询 | US$281.25 | US$0.56/千次搜索 |
| 用量 | 1,000,000 次查询 | US$375 | US$0.38/千次搜索 |

所有套餐均包含: 所有引擎均为每次搜索 1 积分 · 失败的请求不计费 · 积分永不过期 · 国家、语言、城市和设备定位

**付款前须知**

- 最低充值 US$25。 使用加密货币充值一次，即可用余额购买任意套餐。
- 未使用的余额保留在您的账户中且永不过期，可用于支付搜索积分。当购买金额低于最低充值时，仅为达到最低充值而额外添加的部分，可在付款后 30 天内向客服申请退款，以 USDT 或 USDC 形式退还，前提是该部分尚未被使用。余额的其余部分不予退还，除非法律要求.
- 付款在区块链上核实后即到账。 网络确认的通常时间： BTC ≈ 20 分钟 · USDT TRC-20 ≈ 1 分钟 · USDT ERC-20 ≈ 5 分钟 · USDC ERC-20 ≈ 5 分钟 · ETH ≈ 5 分钟 · SOL ≈ 1 分钟 · LTC ≈ 15 分钟

## Custom Search API 关停：常见问题

### Google Custom Search JSON API 要关停了吗？

是的。Google 的开发者页面说，该 API 已对新客户关闭，现有客户须在 2027 年 1 月 1 日前迁移到其他解决方案。此日期之后，所有人的请求都将停止工作。

### 我还能创建一个搜索整个网络的 Programmable Search Engine 吗？

不能。自 2026 年 1 月 20 日起，新建的引擎只能搜索最多 50 个域名的列表。已经启用“Search the entire web”的引擎会保留该功能直到 2027 年 1 月 1 日，除非它们关闭该功能，而关闭后无法撤销。

### 有官方的 Google API 可以获取全网结果吗？

仅面向合作伙伴。Google 在 2026 年 9 月记录了 Web Search Service API；它需要合作伙伴 client ID，且没有公开价格。对于其他所有人，诸如 SerpCrypto 之类的 SERP API 是实际可行的选择。

### 我的站点限定搜索在 SerpCrypto 上仍然有效吗？

有效。把 `site:` 操作符放进查询中，例如 `q=return policy site:example.com`。它会搜索 Google 关于该站点的公开结果，这与站点限定引擎所做的很接近。

### 我可以在没有 Google Cloud 结算账户或银行卡的情况下付款吗？

可以。SerpCrypto 采用以 BTC, USDT, USDC, ETH, SOL, LTC 支付的预付积分，最低充值 US$25。它不要求身份证件、自拍或公司文件。

## 来源

1. [Custom Search JSON API：概览](https://developers.google.com/custom-search/v1/overview) — Google for Developers (read 2026-10-22)
2. [Programmable Search Engine：搜索整个网络](https://support.google.com/programmable-search/answer/12397162?hl=en) — Google Help (read 2026-10-22)
3. [Programmable Search Engine 与 Google.com 对比](https://support.google.com/programmable-search/answer/70392) — Google Help (read 2026-10-22)
4. [Custom Search JSON API：搜索响应参考](https://developers.google.com/custom-search/v1/reference/rest/v1/Search) — Google for Developers (read 2026-10-22)
5. [我们的 Web Search 产品与 Programmable Search Engine 能力的更新](https://programmablesearchengine.googleblog.com/2026/01/updates-to-our-web-search-products.html) — Programmable Search Engine blog (2026-01-20)
6. [Custom Search JSON API：cse.list 参考](https://developers.google.com/custom-search/v1/reference/rest/v1/cse/list) — Google for Developers (read 2026-10-22)
7. [Google 记录了仅限合作伙伴的完整网络搜索结果 API](https://www.searchenginejournal.com/google-documents-partner-only-api-for-full-web-search-results/) — Search Engine Journal (2026-09-11)

---

SerpCrypto: SerpCrypto 是面向开发者和 AI Agent 的 SERP API，可将 Google 和 Bing 搜索结果以 JSON 返回，用加密货币支付，无需上传证件。预付费搜索积分自 US$0.30/千次搜索 起永不过期。无需 KYC——无需证件、无需自拍、无需材料。加密货币支付。