Serper
Google 搜索结果,速度快:网页、图片、新闻、视频、地点、购物、学术,参数与返回与 Serper 官方一致(organic、knowledgeGraph、peopleAlsoAsk、relatedSearches …)。
https://jusouai.cn/v1/serper/search,参数照官方写法billing.summary 一句话说清本次扣分和剩余积分/v1/serper/search 网页搜索POST /v1/serper/images 图片搜索POST /v1/serper/news 新闻搜索POST /v1/serper/videos 视频搜索POST /v1/serper/places 地点搜索POST /v1/serper/shopping 购物搜索POST /v1/serper/scholar 学术搜索POST /v1/serper/searchSerper 网页搜索
Google 网页搜索结果,参数名与返回结构与 Serper 官方 /search 一致(q / gl / hl / num / page …;鉴权用你的聚搜 Key,不用 X-API-KEY)。返回 organic(title / link / snippet / date / position / sitelinks),有时还有 knowledgeGraph(知识面板)、answerBox(精选摘要)、peopleAlsoAsk(相关问题)、relatedSearches、topStories。
官方地址 https://google.serper.dev/search → 换成 https://jusouai.cn/v1/serper/search,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。
第一次调用
已帮你填好 Key 和 Serper 的地址,复制就能跑。
curl https://jusouai.cn/v1/serper/search \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"q": "固态电池 量产 2026", "num": 5, "gl": "cn", "hl": "zh-cn"}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/search",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "固态电池 量产 2026",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/search", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "固态电池 量产 2026",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 网页搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/search
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "固态电池 量产 2026", "num": 5, "gl": "cn", "hl": "zh-cn"}
- 返回:结构与 Serper 官方一致(searchParameters, organic, relatedSearches),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 一周 |
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"searchParameters": {
"q": "固态电池 量产 2026",
"num": 5,
"gl": "cn",
"hl": "zh-cn",
"type": "search",
"engine": "google"
},
"organic": [
{
"title": "…",
"link": "https://example.com/a",
"snippet": "…",
"date": "2026-10-01",
"position": 1
}
],
"relatedSearches": [
{
"query": "…"
}
],
"billing": {
"points": 1,
"balance": 999,
"summary": "本次:Serper -1 积分,剩余 999"
}
}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 的地址,复制就能跑。
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"}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/images",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "埃菲尔铁塔 夜景",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/images", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "埃菲尔铁塔 夜景",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 图片搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/images
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "埃菲尔铁塔 夜景", "num": 5, "gl": "cn", "hl": "zh-cn"}
- 返回:结构与 Serper 官方一致(searchParameters, images),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 一周 |
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 的地址,复制就能跑。
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"}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/news",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "固态电池",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/news", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "固态电池",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 新闻搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/news
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "固态电池", "num": 5, "gl": "cn", "hl": "zh-cn"}
- 返回:结构与 Serper 官方一致(searchParameters, news),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 条);该类型目前忽略 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 一周 |
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 的地址,复制就能跑。
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"}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/videos",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "Python 入门教程",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/videos", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "Python 入门教程",
"num": 5,
"gl": "cn",
"hl": "zh-cn"
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 视频搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/videos
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "Python 入门教程", "num": 5, "gl": "cn", "hl": "zh-cn"}
- 返回:结构与 Serper 官方一致(searchParameters, videos),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 条);该类型目前忽略 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 一周 |
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 的地址,复制就能跑。
curl https://jusouai.cn/v1/serper/places \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"q": "咖啡馆 上海 静安", "num": 5}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/places",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "咖啡馆 上海 静安",
"num": 5
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/places", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "咖啡馆 上海 静安",
"num": 5
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 地点搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/places
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "咖啡馆 上海 静安", "num": 5}
- 返回:结构与 Serper 官方一致(searchParameters, places),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5 | 可选 | 5 |
pageinteger | 页码,从 1 开始(1-100)例:2 = 第 2 页 | 可选 | 2 = 第 2 页 |
展开其余 1 个参数(autocorrect)
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 的地址,复制就能跑。
curl https://jusouai.cn/v1/serper/shopping \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"q": "降噪耳机", "num": 5}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/shopping",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "降噪耳机",
"num": 5
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/shopping", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "降噪耳机",
"num": 5
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 购物搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/shopping
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, location, num, page
- 例子:{"q": "降噪耳机", "num": 5}
- 返回:结构与 Serper 官方一致(searchParameters, shopping),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5 | 可选 | 5 |
pageinteger | 页码,从 1 开始(1-100)例:2 = 第 2 页 | 可选 | 2 = 第 2 页 |
展开其余 1 个参数(autocorrect)
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 的地址,复制就能跑。
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}'import requests
r = requests.post(
"https://jusouai.cn/v1/serper/scholar",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "large language model evaluation",
"num": 5
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/serper/scholar", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "large language model evaluation",
"num": 5
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Serper 学术搜索」接口:
- 地址:POST https://jusouai.cn/v1/serper/scholar
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Serper 官方写法一致。必填:q;常用:q, gl, hl, num, page, autocorrect
- 例子:{"q": "large language model evaluation", "num": 5}
- 返回:结构与 Serper 官方一致(searchParameters, organic),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/serper参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
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 |
numinteger | 1-10(最多 10 条);该类型目前忽略 num、固定返回一页(11-03 实测:news / videos / places / scholar 约 10 条,shopping 约 40 条),统一接口不涉及;扣分与条数无关例:5 | 可选 | 5 |
pageinteger | 页码,从 1 开始(1-100)例:2 = 第 2 页 | 可选 | 2 = 第 2 页 |
autocorrectboolean | false = 不要自动纠错后的结果(默认 true)例:false | 可选 | false |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"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 换一家,本次未扣积分 |
价格
| 接口 | 档位 | 触发条件 | 积分/次 |
|---|---|---|---|
/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 |