Google 搜索 API

了解 POST /search 的请求参数、响应字段与页面快照。

本页目录

地址与鉴权

HTTP

POST https://serpcheap.com/search
X-API-KEY: YOUR_API_KEY
Content-Type: application/json

X-API-KEY 必填。每次成功请求扣 1 积分，包括重复查询。

请求参数

字段	必填／默认	说明
q	必填	查询词，最多 2000 个 UTF-8 字节。
gl	us	国家代码，例如 us、de。
hl	en	搜索语言，例如 en、de。

当前支持 Google 网页搜索第一页，不接受分页、自定义结果数量及未知参数。

响应结构

下方是响应格式示例。保留结果原始排名，不保证固定条数；可选模块仅在有数据时返回。

JSON

{
  "search_metadata": {"request_time_ms": 1480.320, "parse_time_ms": 12.480},
  "searchParameters": {"q": "Nike", "gl": "us", "hl": "en"},
  "organic": [{
    "title": "Nike",
    "link": "https://www.nike.com/",
    "snippet": "Illustrative result, not a live search.",
    "position": 1
  }],
  "peopleAlsoAsk": [],
  "relatedSearches": [],
  "credits": 1
}

search_metadata.request_time_ms 与 parse_time_ms 为 JSON 数值，单位毫秒，输出保留三位小数。数值可能包含模拟耗时及服务端等待，不能始终视为上游网络或解析 CPU 时间的实测值。端到端响应耗时还包含鉴权、数据库结算及网络传输。

字段	含义
searchParameters	q / gl / hl
organic / ads	普通结果和广告：title、link、snippet、position；来源、展示网址、图标、子链接和高亮词按实际数据返回。
peopleAlsoAsk / relatedSearches	相关问题与相关搜索。
knowledgeGraph / answerBox	实际存在的知识图谱与直接答案。
ai_overview / inline_images / search_information / pagination	实际存在的其他页面模块。
credits	成功请求扣 1 积分。

HTML 页面快照

响应中的 search_metadata.html_url 在有快照时提供浏览器预览地址。无需登录或 API Key，持有链接即可查看。预览不执行脚本或自动跳转。快照 24 小时后过期；快照不存在或已过期时返回 404。

CURL

curl 'https://serpcheap.com/searches/YOUR_REQUEST_ID/html'

请求追踪

请保留响应头 X-Request-ID。无法解析的链接可能保留 Google /goto 原网址；仅解析普通结果和广告主链接，其他模块保留原始链接。

OpenAPI JSON

示例仅说明接口合同，不会执行搜索。联系支持时请勿提供 API Key。