网页上看到的,接口里都有
热度与平台分布
一个词在六大 AI 平台的搜索热度指数、份额与环比涨跌,直接回答「该先攻哪个平台」。
GET /v1/heat · /v1/platforms趋势与延伸热词
近 7 / 30 / 90 天逐日趋势与上期对比,加上搜完这个词的人接着还会搜的 18 个延伸问法。
GET /v1/trend · /v1/related语义词与内容清单
四类场景 40 条语义词、按真实搜索量排序的 12 条内容建议,拉下来就能交给 WorkBuddy 结合知识库执行。
GET /v1/semantic · /v1/topics三步,把数据拉进你的代码
开通 VIP,生成 API Key
VIP 会员在「个人中心 → API 管理」一键生成 Key,每月 5,000 次调用额度,随时可重置。
Authorization: Bearer zs_live_••••
带上 Key,请求一个词
所有接口都是 GET + Query 参数,返回 UTF-8 JSON。关键词记得做 URL 编码。
curl "https://api.zhishu.example/v1/heat?kw=新能源汽车"
批量拉词,喂给内容系统
把选题清单接进你的看板或 WorkBuddy 知识库流水线,每天 06:00 数据更新后自动跑一轮。
topics → WorkBuddy → 初稿 → 发布
一个 Key,额度透明
Bearer Token 鉴权
每个请求在 Header 里带上 Authorization: Bearer <你的 Key>。Key 与账号绑定,请只放在服务端,不要写进前端代码或公开仓库。
调用限额
不用写代码,先看看返回长什么样
六个接口,覆盖整份报告
关键词的搜索热度总览:热度指数、环比涨跌、周期内峰值与延伸热词数量。适合做看板首屏与批量词的快速筛选。
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| kw | string | 必填 | — | 关键词,需 URL 编码,如 %E6%96%B0%E8%83%BD%E6%BA%90%E6%B1%BD%E8%BD%A6 |
| days | int | 可选 | 30 | 统计周期,可选 7 / 30 / 90 |
请求示例
curl -s "https://api.zhishu.example/v1/heat?kw=新能源汽车&days=30" \ -H "Authorization: Bearer zs_live_你的Key"
响应示例
{
"code": 0,
"updated_at": "2026-11-12T06:00:00+08:00",
"data": {
"keyword": "新能源汽车",
"days": 30,
"total_index": 730520,
"delta_pct": 8.2,
"peak": { "date": "11-12", "index": 28417 },
"related_count": 18
}
}六大 AI 平台各自的搜索热度指数与份额,按热度降序。回答「内容预算该往哪个平台倾斜」。
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| kw | string | 必填 | — | 关键词,需 URL 编码 |
| days | int | 可选 | 30 | 统计周期,可选 7 / 30 / 90 |
响应示例
{
"code": 0,
"data": {
"keyword": "新能源汽车",
"total_index": 730520,
"platforms": [
{ "platform": "豆包", "index": 236993, "share_pct": 32.4 },
{ "platform": "DeepSeek", "index": 162630, "share_pct": 22.3 },
{ "platform": "Kimi", "index": 106920, "share_pct": 14.6 }
// … 通义千问 / 腾讯元宝 / 文心一言,共 6 项
]
}
}逐日热度趋势,含上期同期对照,可直接画折线图。判断一个词是在升温还是退潮。
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| kw | string | 必填 | — | 关键词,需 URL 编码 |
| days | int | 可选 | 30 | 统计周期,可选 7 / 30 / 90 |
响应示例
{
"code": 0,
"data": {
"keyword": "新能源汽车",
"days": 30,
"series": [
{ "date": "10-14", "index": 21240, "prev_index": 18930 },
{ "date": "10-15", "index": 22015, "prev_index": 19410 }
// … 共 days 条,按日期升序
],
"avg_index": 24351,
"vs_prev_pct": 8.2
}
}用户搜这个词究竟想解决什么:四类场景(选购对比 / 使用教程 / 价格预算 / 口碑评测)共 40 条语义词,含意图标签与搜索热度。
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| kw | string | 必填 | — | 关键词,需 URL 编码 |
| scene | string | 可选 | all | 指定场景:选购对比 / 使用教程 / 价格预算 / 口碑评测,默认全部 |
响应示例
{
"code": 0,
"data": {
"keyword": "新能源汽车",
"scenes": {
"选购对比": [
{ "keyword": "新能源车", "intent": "选购决策", "semantic": "新能源车推荐", "heat": 9820 }
// … 每场景 10 条,共 40 条
]
}
}
}哪些内容值得做:按真实搜索量排序的 12 条内容建议,含优先级、场景、意图与核心词六个字段。返回的清单可直接交给 WorkBuddy 结合知识库执行。
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| kw | string | 必填 | — | 关键词,需 URL 编码 |
| days | int | 可选 | 30 | 统计周期,可选 7 / 30 / 90 |
响应示例
{
"code": 0,
"data": {
"keyword": "新能源汽车",
"topics": [
{
"priority": 1, "level": "优先做",
"topic": "10万以内电车推荐", "heat": 9625,
"scene": "价格预算", "intent": "预算筛选", "core_keyword": "10万电车"
}
// … 共 12 条,按热度降序
],
"handoff": "可直接交给 WorkBuddy 结合知识库执行"
}
}所有响应都带 code 字段:0 为成功,非 0 时 message 给出原因。HTTP 状态码与 code 对应,便于网关层统一处理。
| HTTP | code | 含义 | 处理建议 |
|---|---|---|---|
| 400 | 1001 | 参数错误(kw 缺失 / days 非法) | 检查关键词编码与 days 取值(7/30/90) |
| 401 | 1002 | Key 无效或缺失 | 检查 Authorization Header,必要时重置 Key |
| 403 | 1003 | 非 VIP 或额度已用尽 | 开通 / 续订 VIP,或联系企业定制额度 |
| 429 | 1004 | 超过 10 次/秒频率限制 | 按响应头 Retry-After 退避后重试 |
| 500 | 1005 | 服务内部错误 | 稍后重试;持续出现请联系 support |
错误响应示例
{
"code": 1004,
"message": "rate limit exceeded, retry after 1s",
"retry_after": 1
}开通 VIP,每月 5,000 次调用即刻生效
一个 Key 拉全六个接口,口径与网页端一致。把选题清单接进 WorkBuddy 知识库流水线,让内容生产跟着真实搜索量走。原价 99 元/月,年底限时 19.9 元/月。