API 文档v0.9.11 Base URL https://jusouai.cnBearer 鉴权1–4 积分/次,Exa 部分参数另加 MarkdownOpenAPISKILL.md
开发文档 / 引擎 / Serper
Se

Serper

Google 搜索结果,速度快:网页、图片、新闻、视频、地点、购物、学术,参数与返回与 Serper 官方一致(organic、knowledgeGraph、peopleAlsoAsk、relatedSearches …)。

参数与官方写法一致1–2 积分/次失败不扣分每次最多 10 条
我的 Key登录或兑换后,这里显示你的 Key,代码里自动填好去兑换登录控制台
1复制 Key没有就先兑换卡密,自动开户
2换个地址请求发到 https://jusouai.cn/v1/serper/search,参数照官方写法
3看扣分返回里 billing.summary 一句话说清本次扣分和剩余积分

POST /v1/serper/imagesSerper 图片搜索

Google 图片搜索结果,参数名与返回结构与 Serper 官方 /images 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 images(title / imageUrl / imageWidth / imageHeight / thumbnailUrl / source / domain / link / position)。

官方地址 https://google.serper.dev/images → 换成 https://jusouai.cn/v1/serper/images,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/images
curl https://jusouai.cn/v1/serper/images \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "埃菲尔铁塔 夜景", "num": 5, "gl": "cn", "hl": "zh-cn"}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
locationstring搜索发起地(城市级最准),如 Shanghai, China / Austin, Texas, United States例:Shanghai, China可选Shanghai, China
numinteger返回条数 1-10(最多 10 条),默认 10例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
展开其余 2 个参数(tbs、autocorrect)
参数说明必填例子
tbsstring时间范围:qdr:h(1 小时)/ qdr:d(24 小时)/ qdr:w / qdr:m / qdr:y例:qdr:d 一天 / qdr:w 一周可选qdr:d 一天 / qdr:w 一周
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "埃菲尔铁塔 夜景",
    "num": 5,
    "gl": "cn",
    "hl": "zh-cn",
    "type": "images",
    "engine": "google"
  },
  "images": [
    {
      "title": "…",
      "imageUrl": "https://example.com/a.jpg",
      "source": "Example",
      "link": "https://example.com/a",
      "position": 1
    }
  ],
  "billing": {
    "points": 1,
    "balance": 999,
    "summary": "本次:Serper -1 积分,剩余 999"
  }
}

POST /v1/serper/newsSerper 新闻搜索

Google 新闻搜索结果,参数名与返回结构与 Serper 官方 /news 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 news(title / link / snippet / date / source / imageUrl / position)。

官方地址 https://google.serper.dev/news → 换成 https://jusouai.cn/v1/serper/news,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/news
curl https://jusouai.cn/v1/serper/news \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "固态电池", "num": 5, "gl": "cn", "hl": "zh-cn"}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
locationstring搜索发起地(城市级最准),如 Shanghai, China / Austin, Texas, United States例:Shanghai, China可选Shanghai, China
numinteger1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
展开其余 2 个参数(tbs、autocorrect)
参数说明必填例子
tbsstring时间范围:qdr:h(1 小时)/ qdr:d(24 小时)/ qdr:w / qdr:m / qdr:y例:qdr:d 一天 / qdr:w 一周可选qdr:d 一天 / qdr:w 一周
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "固态电池",
    "num": 5,
    "gl": "cn",
    "hl": "zh-cn",
    "type": "news",
    "engine": "google"
  },
  "news": [
    {
      "title": "…",
      "link": "https://example.com/news/1",
      "snippet": "…",
      "date": "3 小时前",
      "source": "Example"
    }
  ],
  "billing": {
    "points": 1,
    "balance": 999,
    "summary": "本次:Serper -1 积分,剩余 999"
  }
}

POST /v1/serper/videosSerper 视频搜索

Google 视频搜索结果,参数名与返回结构与 Serper 官方 /videos 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 videos(title / link / snippet / imageUrl / duration / source / channel / date / position)。

官方地址 https://google.serper.dev/videos → 换成 https://jusouai.cn/v1/serper/videos,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/videos
curl https://jusouai.cn/v1/serper/videos \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "Python 入门教程", "num": 5, "gl": "cn", "hl": "zh-cn"}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
locationstring搜索发起地(城市级最准),如 Shanghai, China / Austin, Texas, United States例:Shanghai, China可选Shanghai, China
numinteger1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
展开其余 2 个参数(tbs、autocorrect)
参数说明必填例子
tbsstring时间范围:qdr:h(1 小时)/ qdr:d(24 小时)/ qdr:w / qdr:m / qdr:y例:qdr:d 一天 / qdr:w 一周可选qdr:d 一天 / qdr:w 一周
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "Python 入门教程",
    "num": 5,
    "gl": "cn",
    "hl": "zh-cn",
    "type": "videos",
    "engine": "google"
  },
  "videos": [
    {
      "title": "…",
      "link": "https://www.youtube.com/watch?v=x",
      "duration": "3:21",
      "source": "YouTube",
      "channel": "…",
      "position": 1
    }
  ],
  "billing": {
    "points": 1,
    "balance": 999,
    "summary": "本次:Serper -1 积分,剩余 999"
  }
}

POST /v1/serper/placesSerper 地点搜索

Google 地点搜索结果,参数名与返回结构与 Serper 官方 /places 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 places(title / address / latitude / longitude / rating / ratingCount / category / phoneNumber / website / cid)。

官方地址 https://google.serper.dev/places → 换成 https://jusouai.cn/v1/serper/places,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/places
curl https://jusouai.cn/v1/serper/places \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "咖啡馆 上海 静安", "num": 5}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
locationstring搜索发起地(城市级最准),如 Shanghai, China / Austin, Texas, United States例:Shanghai, China可选Shanghai, China
numinteger1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
展开其余 1 个参数(autocorrect)
参数说明必填例子
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "咖啡馆 上海 静安",
    "num": 5,
    "type": "places",
    "engine": "google"
  },
  "places": [
    {
      "position": 1,
      "title": "…",
      "address": "…",
      "latitude": 31.23,
      "longitude": 121.47,
      "rating": 4.5
    }
  ],
  "billing": {
    "points": 1,
    "balance": 999,
    "summary": "本次:Serper -1 积分,剩余 999"
  }
}

POST /v1/serper/shoppingSerper 购物搜索

Google 购物搜索结果,参数名与返回结构与 Serper 官方 /shopping 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 shopping(title / source / link / price / imageUrl / rating / ratingCount / productId / position)。

官方地址 https://google.serper.dev/shopping → 换成 https://jusouai.cn/v1/serper/shopping,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/shopping
curl https://jusouai.cn/v1/serper/shopping \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "降噪耳机", "num": 5}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
locationstring搜索发起地(城市级最准),如 Shanghai, China / Austin, Texas, United States例:Shanghai, China可选Shanghai, China
numinteger1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
展开其余 1 个参数(autocorrect)
参数说明必填例子
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "降噪耳机",
    "num": 5,
    "type": "shopping",
    "engine": "google"
  },
  "shopping": [
    {
      "title": "…",
      "source": "Example Store",
      "link": "https://example.com/p/1",
      "price": "$99.00",
      "position": 1
    }
  ],
  "billing": {
    "points": 2,
    "balance": 998,
    "summary": "本次:Serper -2 积分,剩余 998"
  }
}

POST /v1/serper/scholarSerper 学术搜索

Google 学术搜索结果,参数名与返回结构与 Serper 官方 /scholar 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 organic(title / link / publicationInfo / snippet / year / citedBy / pdfUrl / id)。

官方地址 https://google.serper.dev/scholar → 换成 https://jusouai.cn/v1/serper/scholar,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。

第一次调用

已帮你填好 Key 和 Serper 的地址,复制就能跑。

POST /v1/serper/scholar
curl https://jusouai.cn/v1/serper/scholar \
  -H "Authorization: Bearer jsk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"q": "large language model evaluation", "num": 5}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring搜索词,支持 site: / intitle: / filetype: 等 Google 搜索语法例:固态电池 site:zhihu.com必填固态电池 site:zhihu.com
glstring搜索所在国家,两位代码如 us / cn / jp / hk例:cn / us / jp可选cn / us / jp
hlstring结果语言,如 zh-cn / zh-tw / en / ja例:zh-cn / en / ja可选zh-cn / en / ja
numinteger1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5可选5
pageinteger页码,从 1 开始(1-100)例:2 = 第 2 页可选2 = 第 2 页
autocorrectbooleanfalse = 不要自动纠错后的结果(默认 true)例:false可选false
不支持:批量查询(请求体为数组)、maps / reviews / lens / patents / autocomplete / 网页抓取等其它类型,以及 apiKey;num 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "searchParameters": {
    "q": "large language model evaluation",
    "num": 5,
    "type": "scholar",
    "engine": "google"
  },
  "organic": [
    {
      "title": "…",
      "link": "https://example.org/paper",
      "publicationInfo": "…",
      "year": 2025,
      "citedBy": 120
    }
  ],
  "billing": {
    "points": 1,
    "balance": 999,
    "summary": "本次:Serper -1 积分,剩余 999"
  }
}

出错怎么办

错误响应里的 error.hint 就是下面这句「怎么办」。所有失败都不扣分。

错误怎么办(error.hint)
401 Key 不对检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制
402 积分不够兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分
400 参数不对看 message 里说的是哪个参数,改好再试;本次未扣积分
429 太快了稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐
503 暂不可用稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分
502 引擎异常稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分

价格

1–2 积分/次
轻量卡 1000 积分 ≈ 1000 次(按最低档)
失败都不扣。积分所有引擎通用,一张卡密什么引擎都能用。
接口档位触发条件积分/次
/v1/serper/search 网页搜索standard 默认任意参数1
/v1/serper/images 图片搜索standard 默认任意参数1
/v1/serper/news 新闻搜索standard 默认任意参数1
/v1/serper/videos 视频搜索standard 默认任意参数1
/v1/serper/places 地点搜索standard 默认任意参数1
/v1/serper/shopping 购物搜索standard 默认任意参数2
/v1/serper/scholar 学术搜索standard 默认任意参数1
想同时用几家? 用统一接口 /v1/search,一次请求对比 Serper、Exa、SerpApi 的结果 →