WellbyteWellbyte

POST /v1/douyin/billboard/fetch_hot_total_topic_list

获取话题热榜

stable · 2 credits / 次（成功才计）

获取话题榜；page: 页码；page_size: 每页数量；date_window: 时间窗口(小时)，可选 1/24/72/168，代表近1小时/近1天/近3天/近7天，默认24；keyword: 搜索关键词，对榜单按关键词过滤，空为全部；tags: 垂类标签筛选，空则为全部，标签id从 fetch_content_tag 接口获取；请求示例；```json；{；"page": 1,；"page_size": 10,；"date_window": 24,；"keyword": "",；"tags": [；{"value": 628, "children": [{"value": 62808}, {"value": 62804}]}；]；}；```；话题榜

注册即送 500 credits，用自己的 Key 试调。 免费注册

请求

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/billboard/fetch_hot_total_topic_list' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"page":null,"tags":"demo","keyword":"咖啡","page_size":null,"date_window":null}'
免费注册

响应

示例采集于 2026-08-25

data{
code:0
data{
objs[ 2 items ]
page{ 3 items }
}
meta{
endpoint:"douyin.billboard.fetch_hot_total_topic_list"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

请求历史

打开完整日志

还没有调用记录。先跑通一次，再换成你的数据。

    请求参数

    参数类型位置必填说明示例
    pageintegerbody否页码demo
    tagsarraybody否垂类标签筛选，空则为全部，标签id从 fetch_content_tag 接口获取demo
    keywordstringbody否搜索关键词，对榜单按关键词过滤，空为全部咖啡
    page_sizeintegerbody否每页数量demo
    date_windowintegerbody否时间窗口(小时)，可选 1demo

    响应字段

    字段字典待补 —— 右侧可执行区可直接看到真实结构。

    错误码

    codeHTTP含义是否计费
    40001400参数缺失或格式错误否
    40102401API Key 无效或已吊销否
    40201402余额不足，请充值否
    40402404目标资源不存在否
    42201422质量门槛未通过否
    42901429超出速率限制否
    50401504上游超时否
    50201502上游返回异常否

    计费

    成功扣 2 credits；任何失败（含上游 200 但未过质量门槛）扣 0。

    搜索

    搜索端点与文档