Google 网页搜索

用 Google 搜索 API 获取实时网页结果

通过 HTTP 检索 Google，以结构化 JSON 拿到标题、链接和摘要，并可选择在同一次请求中返回页面正文。

接口
POST https://api.search1api.com/search
Google 搜索结果包含什么

结果的 JSON 结构与其他引擎一致，一套解析逻辑覆盖全部引擎。

1
页面标题与链接

标题干净，没有抓站常见的解析残缺。

2
摘要

结果描述，有时会带一个日期前缀。

3
可选的页面正文

设置 crawl_results 后，前几条结果返回 markdown。

适用于

AI 回答 / RAG / 研究调研

默认引擎，也是其他引擎的基准

Google 是默认的 `search_service`，不带这个参数的请求就是搜 Google。接口地址、鉴权方式和响应结构与全部其他引擎共用 —— 正因如此，换一个数据源只是改一个字段。

搜索和正文一次拿到

`crawl_results` 会抓取前 N 条结果并各自返回 markdown，一个回答不需要为了读来源再跑一趟。

域名与时间过滤

`include_sites` 和 `exclude_sites` 可以限定或排除特定域名，`time_range` 可以限定在天、周、月、年。

一次请求批量查询

接口接受查询对象的数组，逐条计费，失败的条目不计费。

一套契约，17 个引擎

把查询从 Google 换到 Reddit、GitHub 或中文引擎，是改一个字段，不是接一套新系统。

什么是 Google 搜索 API？

Google 搜索 API 是一种 HTTP 接口，把 Google 的网页结果作为结构化数据返回。Google 自己并没有把通用网页搜索做成一个简单的开发者 API —— Custom Search JSON API 的范围和配额都受限，Gemini grounding 返回的是答案而不是结果列表 —— 所以需要实时网页结果排序列表的应用，都会在它前面放一层搜索 API。Search1API 以 JSON 返回标题、链接和摘要，并可在同一个响应里带上前几条结果的页面正文，请求和响应结构与另外 16 个引擎完全相同。对 agent 来说，这个一致性才是关键：通用网页搜索、社区来源和中文互联网走的是同一条代码路径。

接入路径

典型流程

通过 HTTP 检索 Google，以结构化 JSON 拿到标题、链接和摘要，并可选择在同一次请求中返回页面正文。

1

发送查询，可选地把 `search_service` 设为 `google`。

2

读取由标题、链接和摘要组成的结构化结果列表。

3

当回答需要页面正文而不只是链接时，设置 `crawl_results`。

一次请求，结果连同正文

一次调用即可检索 Google，配合 `crawl_results` 还会以 markdown 返回前几条结果的正文，一个有依据的回答只要一个来回，不是三个。

bash
curl -X POST https://api.search1api.com/search \
  -H "Authorization: Bearer $SEARCH1API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI agent",
    "search_service": "google",
    "max_results": 5
  }'

适合场景

回答前需要实时网页证据的 AI 助手。

检索和阅读一步完成的 RAG 管道。

需要排序列表而不是摘要的调研与监控工具。

把通用网页搜索和垂类来源结合起来的应用。

下一步链接

一个接口支持 17 个搜索引擎

Bing 搜索 API
DuckDuckGo 搜索 API
维基百科搜索 API
搜索 API
查看 API 文档
查看定价

常见问题

Google 有官方的搜索 API 吗？

Google 提供 Custom Search JSON API，但它限定在你配置的搜索引擎范围内且免费配额很低；Gemini grounding 返回的是合成后的答案而不是排序结果列表。两者都不是通用网页搜索 API，这也是应用会在 Google 前面加一层搜索 API 的原因。

需要 Google 的 API key 吗？

不需要。鉴权用的是 Search1API 的 key。请求是向 https://api.search1api.com/search 发 POST，`google` 是 `search_service` 的默认值。

可以连页面正文一起拿到吗？

可以。把 `crawl_results` 设为需要抓取的结果数量，成功抓取的页面会包含 `content` 字段，内容是 markdown 格式的正文。抓取失败的页面不返回 `content`，也不计费。

Google 搜索的费用是多少？

每次搜索消耗 1 积分，通过 `crawl_results` 每成功抓取一个页面追加 1 积分。按 $1 = 1,000 积分的充值基础价计算，1,000 次搜索为 $1。注册即送 100 个免费积分，无需信用卡，充值积分永不过期。

可以按域名或日期过滤吗？

可以。`include_sites` 和 `exclude_sites` 接受域名列表，`time_range` 接受 day、week、month、year。

还支持哪些引擎？

同一个 Search 接口还支持 `duckduckgo`，以及 `reddit`、`x`、`github`、`arxiv`、`youtube`、`wikipedia`、`imdb` 等垂类来源，和 `baidu`、`360`、`quark`、`wechat`、`bilibili` 等中文引擎 —— 一套契约共 17 个。