SERPens

RapidAPI2026-09-08 更新2026-09-09 收录

搜索结果分析

AI概览品牌监测

数据链接：

https://rapidapi.com/starnikovoleg/api/serpens 数据链接链接失效反馈

官方服务：

资源简介：

Google search results with the AI Overview and the brands it names, in one call. Serper-compatible response — migrate by changing the base URL.

创建时间：

2026-09-08

原始信息汇总

数据集概述：SERPens — Google Search & SERP API

简介
SERPens 是一款基于纯 REST 调用提供结构化 Google 搜索结果的数据 API，覆盖自然搜索结果、Google 渲染的相关问题，以及独立端点提供的 AI Overview（含 Google 提及的品牌）。其响应格式与 Serper 逐字段兼容，便于用户无缝迁移。提供免费层级，无需绑定信用卡。

核心功能与特点

1. Serper 兼容响应

响应体与 Serper 逐字段一致，迁移时仅需更换基础 URL，无需重写解析逻辑。
额外提供 organic[].source、has_next_page/has_previous_page 及独立 aiOverview 端点等增量字段，不影响原有客户端使用。

2. AI Overview 支持

通过专属端点 /api/v1/search_ai_overview 获取 AI Overview、相关富文本块（如 sitelinks、knowledge panel、People Also Ask、related searches）及自然搜索结果。
当 Google 未渲染 AI Overview 时，aiOverview 键不会出现在响应中；其他可选块在 Google 无内容时也直接省略，不返回 null 或空数组，便于使用 aiOverview in body 进行判断。

3. Markdown 输出

添加 format=markdown 参数后，结果直接以 Markdown 文本返回（含标题、链接、摘要、sitelinks、People Also Ask、Related Searches 及 AI Overview），省去 JSON 解析与格式化步骤，适合 LLM 与 RAG 流程。
错误信息始终以 JSON 格式返回（不受 format 影响），便于统一错误处理。

4. MCP 端点

提供 POST /mcp 作为 Model Context Protocol 服务器，采用无状态 JSON-RPC，无 SSE、无 session id。
暴露两个工具：google_search 和 google_ai_overview，支持与 REST 端点相同的参数（包括 format），可让 Claude、Cursor、n8n 等代理直接使用，无需 HTTP 客户端。

公共测量报告

公开数据：此 API 每周在固定查询语料（数千条）上运行，并发布聚合统计数据于 serpensapi.org（例如 AI Overview 出现频率、品牌与自然排名的差异等）。可下载 CSV 格式的聚合数据。
关键发现（基于 4,170 条开发者与营销查询，2026-W36 周美国地区测量）：
- AI Overview 出现于 18.4% 查询；People Also Ask 为 78.2%；Related searches 为 93.2%。
- 38.6% 在 AI Overview 中被提及的品牌未出现在同一查询的自然搜索结果中。
- 93.3% 的 AI Overview 至少提及一个品牌（平均 2.1 个）。

API 端点与参数

端点	功能	主要参数
`GET /api/v1/search`	返回查询的自然搜索结果	`q`（必填，1–2048字符）；`gl`（国家代码，默认 `us`）；`hl`（语言，默认 `en`）；`page`（≥1，无上限）；`tbs`（Google 时间/过滤 token，≤200字符）；`autocorrect`（布尔，默认 `true`）；`format`（`json`/`markdown`，默认 `json`）
`GET /api/v1/search_ai_overview`	返回查询的 AI Overview、相关富文本块及自然搜索结果	与上述相同（`q` 为必填）
`POST /mcp`	MCP 服务器，提供 `google_search` 和 `google_ai_overview` 工具	标准 JSON-RPC 请求

gl 和 hl 仅校验格式，合法代码会原样传给 Google，支持新增地区。
tbs 不做解析，仅限制字符长度。
page 无上界，可深度分页；提供 has_next_page/has_previous_page 标志帮助分页循环。

错误处理与计量

错误结构：所有错误均使用嵌套 JSON 格式，含 error.code 和 error.message，建议分支处理 error.code 而非错误文本。
错误码（HTTP 状态对应）：
- 400：参数错误（如 query_required、invalid_gl 等）
- 500：upstream_error（意外失败）
- 502：upstream_error/upstream_unreachable（Google 不可达）
- 503：capacity_unavailable（含 Retry-After）
- 504：upstream_timeout（超时）
附加信息：每次响应（含错误）均有 X-Trace-Id，可用于支持排查。
计量注意：/health 和 /mcp 均为计费路径，健康检查与 MCP 初始化（如 initialize、tools/list）会计入请求数；建议缓存工具列表或使用本地 stdio 包装减少调用。