开发文档 / 引擎 / 博查
博
博查 网页搜索
中文网页搜索,国内内容覆盖好,可返回长摘要。
1复制 Key没有就先兑换卡密,自动开户
2换个地址请求发到
https://jusouai.cn/v1/bocha/web-search,参数照官方写法3看扣分返回里
billing.summary 一句话说清本次扣分和剩余积分POST /v1/bocha/web-search博查 网页搜索
与博查官方 web-search 一致(Bing 兼容结构);log_id 换成我方 request_id。
官方地址 https://api.bochaai.com/v1/web-search → 换成 https://jusouai.cn/v1/bocha/web-search,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。
第一次调用
已帮你填好 Key 和 博查 的地址,复制就能跑。
POST /v1/bocha/web-search
curl https://jusouai.cn/v1/bocha/web-search \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"query": "杭州 天气", "summary": true, "count": 5}'import requests
r = requests.post(
"https://jusouai.cn/v1/bocha/web-search",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"query": "杭州 天气",
"summary": True,
"count": 5
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/bocha/web-search", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "杭州 天气",
"summary": true,
"count": 5
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「博查 网页搜索」接口:
- 地址:POST https://jusouai.cn/v1/bocha/web-search
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 博查 官方写法一致。必填:query;常用:query, freshness, summary, include, exclude, count
- 例子:{"query": "杭州 天气", "summary": true, "count": 5}
- 返回:结构与 博查 官方一致(code, log_id, msg, data),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/bocha参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
querystring | 搜索词例:杭州 天气 | 必填 | 杭州 天气 |
freshnessstring | 时间范围:noLimit / oneDay / oneWeek / oneMonth / oneYear,或 2025-01-01..2025-04-06例:— | 可选 | — |
summaryboolean | 是否返回长摘要,默认 false例:true | 可选 | true |
includestring | 只搜这些域名,多个用 | 或 , 分隔例:— | 可选 | — |
excludestring | 排除这些域名,多个用 | 或 , 分隔例:— | 可选 | — |
countinteger | 返回条数,1-50例:5 | 可选 | 5 |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
响应 200
{
"code": 200,
"log_id": "js-20261031120000-a1b2c3d4e5f6",
"msg": null,
"data": {
"webPages": {
"value": [
{
"name": "…",
"url": "https://example.cn/a",
"snippet": "…",
"summary": "…",
"siteName": "…",
"datePublished": "…"
}
]
}
},
"billing": {
"points": 1,
"balance": 999,
"summary": "本次:博查 -1 积分,剩余 999"
}
}出错怎么办
错误响应里的 error.hint 就是下面这句「怎么办」。所有失败都不扣分。
| 错误 | 怎么办(error.hint) |
|---|---|
401 Key 不对 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
402 积分不够 | 兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分 |
400 参数不对 | 看 message 里说的是哪个参数,改好再试;本次未扣积分 |
429 太快了 | 稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐 |
503 暂不可用 | 稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分 |
502 引擎异常 | 稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分 |
价格
1 积分/次
轻量卡 1000 积分 ≈ 1000 次
失败都不扣。积分所有引擎通用,一张卡密什么引擎都能用。
| 接口 | 档位 | 触发条件 | 积分/次 |
|---|---|---|---|
/v1/bocha/web-search 网页搜索 | standard 默认 | 任意参数 | 1 |