抖音 — 热点榜分类
SpiderHubs OpenAPI 文档：抖音 — 热点榜分类，分类 抖音。接口 GET /openapi/v1/contentcreator/douyin/billboard/fetch_hot_category_list。获取热点榜可用的分类列表（按 billboard_type 拉取，可按日期/关键词...
OpId:
dy-hot-category · 最近更新: 2026-05-23说明
获取热点榜可用的分类列表（按 billboard_type 拉取，可按日期/关键词过滤）。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/douyin/billboard/fetch_hot_category_list
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| billboard_type | string | 是 | 榜单类型，取值如 rise（上升） / city（同城） / total（总榜） |
| snapshot_time | string | 否 | 快照时间，格式 yyyyMMddHHmmss（如 20250106151500） |
| start_date | string | 否 | 开始日期，格式 yyyyMMdd |
| end_date | string | 否 | 结束日期，格式 yyyyMMdd |
| keyword | string | 否 | 关键词过滤 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码，200 表示成功 |
| request_id | string | 本次请求唯一标识，排查问题时可提供 |
| data | object | 业务数据容器，具体字段见下 |
| list / word_list | array | 榜单条目列表 |
| word / sentence | string | 热点词 / 话题 |
| hot_value / hot_score | int | 热度值 |
| position / rank | int | 排名 |
| sentence_id / query_id | string | 话题 ID（可传给「话题相关视频」接口） |
| event_time / snapshot_time | int | 上榜 / 快照时间 |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/douyin/billboard/fetch_hot_category_list?billboard_type=rise' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "6462c7c5-4e47-46bc-943f-887b091779d2",
"data": {
"code": 0,
"data": [
{
"label": "美食",
"value": [
9000
],
"num": 164
},
"... and 22 more"
],
"extra": {
"now": 1779613850000
}
}
}开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。