抖音 — 热点总榜
SpiderHubs OpenAPI 文档：抖音 — 热点总榜，分类 抖音。接口 GET /openapi/v1/contentcreator/douyin/billboard/fetch_hot_total_list。获取抖音热点总榜（综合榜单），支持按时间窗口拉取历史快照。
OpId:
dy-hot-total · 最近更新: 2026-05-23说明
获取抖音热点总榜（综合榜单），支持按时间窗口拉取历史快照。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/douyin/billboard/fetch_hot_total_list
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | string | 是 | 页码，从 1 开始 |
| page_size | string | 是 | 单页条数 |
| type | string | 是 | 榜单子类型 |
| snapshot_time | string | 否 | 快照时间戳 |
| start_date | string | 否 | 开始日期 YYYY-MM-DD |
| end_date | string | 否 | 结束日期 YYYY-MM-DD |
| sentence_tag | string | 否 | 句子标签过滤 |
| 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_total_list?page=1&page_size=10&type=0' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "68b25003-0d8a-435d-a762-3bdbe99a7a6f",
"data": {
"code": 0,
"data": {
"page": {
"page": 0,
"page_size": 0,
"total": 0
},
"objs": [],
"last_update_time": ""
},
"extra": {
"now": 1779613857000
}
}
}开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。