API 文档

SERPJET 是实时 SERP API：一个关键词进，结构化 JSON 出。所有接口走标准 HTTPS，基础地址 https://api.serpjet.io。

认证

每个请求带上你的 API Key（sj_ 开头），放在 X-API-KEY 请求头里：

curl -H "X-API-KEY: sj_你的密钥" "https://api.serpjet.io/v1/search?q=..."

没有 key？注册领每月 1,000 次免费额度 →

搜索接口

GET/v1/search

实时抓取 Google 搜索结果，解析为 JSON 返回。

请求参数

参数	必填	说明
`q`	是	搜索关键词，URL 编码。例：`q=iphone+15+price`
`engine`	否	搜索引擎，当前支持 `google`（默认）。Shopping / Bing / Amazon 在路线图上。
`gl`	否	结果国家（两位代码），如 `us`、`jp`、`de`。做跨境监控时指定目标市场。
`hl`	否	界面语言，如 `en`、`zh-cn`、`ja`。
`num`	否	返回结果条数，默认 10，最大 100。
`page`	否	页码，从 1 开始。

响应示例

# GET /v1/search?q=iphone+15+price&gl=us&hl=en
{
  "searchParameters": { "q": "iphone 15 price", "gl": "us", "hl": "en", "engine": "google" },
  "organic": [
    {
      "position": 1,
      "title": "Buy iPhone 15 - Apple",
      "link": "https://www.apple.com/shop/buy-iphone/iphone-15",
      "snippet": "From $699 or $29.12/mo. for 24 mo. ..."
    }
  ],
  "relatedSearches": [ { "query": "iphone 15 pro price" } ]
}

响应头

头	说明
`X-Credits-Remaining`	本次扣费后的剩余搜索次数。

计费规则：只有成功返回结果（HTTP 200）的搜索才扣 1 次额度。上游失败、参数错误、认证失败都不扣费。余额永不过期。

用量查询

GET/v1/me

查询当前 key 的额度与用量：

# GET /v1/me
{ "name": "my-project", "credits": 10000, "used": 4213, "remaining": 5787, "created": "2026-07-07T09:00:00+00:00" }

错误码

HTTP 状态	含义	是否扣费
`400`	参数缺失或不合法（如缺 `q`）。	否
`401`	缺少或无效的 API Key。	否
`402`	额度用尽，请充值。	否
`502`	上游抓取失败，可重试。	否

错误响应统一为 {"error": "说明文字"}。

支持

接入问题、加引擎需求、大客户定价：support@serpjet.io，通常 24 小时内回复。