抖音热榜(v5)

状态码	说明
-1	failed
0	success
400	参数错误
1001	账户余额不足
1002	邮箱/手机号或密码错误
1003	请求频率超过上限
1004	邮箱或手机号已注册
1005	无效的 API Key
1006	用户不存在
1007	登录凭证无效
1008	缺少 API Key
1009	手机或邮箱已存在
1010	需要管理员授权
1011	原密码错误
1012	新密码不能与原密码相同
1013	手机号和uid不能都为空
1014	请填写验证码
1015	验证码错误或已过期
1016	登录失败次数过多，请输入验证码
1017	请填写手机号
1018	请填写邮箱
1019	接口不存在，请检查
5000	服务暂时不可用，请稍后重试
5003	网络连接失败，请稍后重试
6001	修改密码失败，请稍后重试

JSON 关键字段说明

热榜主数据字段说明

字段路径	示例值	说明
`data.data.active_time`	`"2026-10-16 11:21:16"`	活跃时间
`data.data.display_style`	`0`	展示样式
`data.data.trending_desc`	`"实时上升热点"`	热榜描述
`data.data.share_info.share_title`	`"我在看抖音热榜，发现最火的内容，赶快来看！"`	分享标题
`data.data.share_info.share_url`	`"https://www.iesdouyin.com/share/billboard/?id=0"`	分享链接
`data.data.share_info.share_link_desc`	`"我在看抖音热榜，发现最火的内容，赶快来看！戳这里>>"`	分享文案

实时上升热点字段说明

字段路径	示例值	说明
`data.data.trending_list[].word`	`"今年第30号台风蔷琵已生成"`	热点词
`data.data.trending_list[].group_id`	`"7695061243912754470"`	热点组 ID
`data.data.trending_list[].sentence_id`	`"2697820"`	句子 ID
`data.data.trending_list[].sentence_tag`	`22001`	句子标签
`data.data.trending_list[].event_time`	`1792115668`	事件时间戳
`data.data.trending_list[].hot_value`	`0`	热度值
`data.data.trending_list[].video_count`	`5`	视频数
`data.data.trending_list[].discuss_video_count`	`1`	讨论视频数
`data.data.trending_list[].label`	`0`	标签
`data.data.trending_list[].hotlist_param`	`"{\"board_type\":3,\"rank\":0,\"time\":1792120937}"`	热榜参数
`data.data.trending_list[].word_type`	`3`	热点词类型
`data.data.trending_list[].word_cover.uri`	`"tos-cn-p-0015/oE7A1DZGIPtQZzmPRtiIE8IPYPGCiAaggQTBB"`	热点封面 URI
`data.data.trending_list[].word_cover.url_list[]`	`["https://p9-sign.douyinpic.com/tos-cn-p-0015/..."]`	热点封面地址列表

热榜列表字段说明

字段路径	示例值	说明
`data.data.word_list[].word`	`"抖音商城双11超级补贴来啦"`	热榜词
`data.data.word_list[].position`	`1`	排名位置
`data.data.word_list[].hot_value`	`12216900`	热度值
`data.data.word_list[].max_rank`	`1`	最高排名
`data.data.word_list[].view_count`	`67456766`	浏览量
`data.data.word_list[].video_count`	`3`	视频数
`data.data.word_list[].discuss_video_count`	`1`	讨论视频数
`data.data.word_list[].group_id`	`"7695738116132902170"`	热点组 ID
`data.data.word_list[].sentence_id`	`"2696275"`	句子 ID
`data.data.word_list[].sentence_tag`	`20002`	句子标签
`data.data.word_list[].event_time`	`1792038052`	事件时间戳
`data.data.word_list[].label`	`3`	标签
`data.data.word_list[].label_url`	`"https://lf3-static.bytednsdoc.com/obj/eden-cn/vjl_avo_upfbvk/ljhwZthlaukjlkulzlp/hotspot_detail_page/3.png"`	标签图标地址
`data.data.word_list[].hotlist_param`	`"{\"board_type\":0,\"rank\":1,\"time\":1792120937}"`	热榜参数
`data.data.word_list[].word_type`	`1`	热点词类型
`data.data.word_list[].is_n1`	`true`	是否 N1
`data.data.word_list[].can_extend_detail`	`false`	是否可展开详情
`data.data.word_list[].display_style`	`0`	展示样式
`data.data.word_list[].article_detail_count`	`0`	文章详情数
`data.data.word_list[].word_cover.uri`	`"tos-cn-p-0015c000-ce/oMgugoGGegVXLuB0fOeD71ldXUVSTEB0AIJgWQ"`	热点封面 URI
`data.data.word_list[].word_cover.url_list[]`	`["https://p26-sign.douyinpic.com/tos-cn-p-0015c000-ce/..."]`	热点封面地址列表
`data.data.word_list[].word_sub_board[]`	`[3]`	子榜类型
`data.data.word_list[].post_aweme_info`	`"{\"music_id\":\"7680427393119668251\",...}"`	投稿作品信息
`data.data.word_list[].topic_info`	`{}`	话题信息

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost": 100,
        "balance": 729924,
        "banner_dark": {
            "uri": "33a57000197f34889bc27",
            "url_list": [
                "https://p26-sign.douyinpic.com/obj/33a57000197f34889bc27?lk3s=03ea9982&x-expires=1792141200&x-signature=PR%2FZ0t%2B%2FT4FBHT9jHH6nwmygJDo%3D&from=65706370",
                "https://p5-ex-gddgtc-sign.douyinpic.com/obj/33a57000197f34889bc27?lk3s=03ea9982&x-expires=1792141200&x-signature=A%2Be5XSp2yzkWZCQmdmwqrSp%2BvnA%3D&from=65706370",
                "https://p3-sign.douyinpic.com/obj/33a57000197f34889bc27?lk3s=03ea9982&x-expires=1792141200&x-signature=DBRfyimhanedSUoxLDTSbJgUeX0%3D&from=65706370"
            ]
        },
        "banner_light": {
            "uri": "33a580000cefdf44e9f76",
            "url_list": [
                "https://p3-sign.douyinpic.com/obj/33a580000cefdf44e9f76?lk3s=03ea9982&x-expires=1792141200&x-signature=rUxangKh7i%2BAdBaukt5NODg2hcI%3D&from=65706370",
                "https://p26-sign.douyinpic.com/obj/33a580000cefdf44e9f76?lk3s=03ea9982&x-expires=1792141200&x-signature=9NZ%2Fg%2FhVvyBLTvPCpkausbMfE1Q%3D&from=65706370",
                "https://p9-sign.douyinpic.com/obj/33a580000cefdf44e9f76?lk3s=03ea9982&x-expires=1792141200&x-signature=oORTAB5CKMdiR1nz8pu%2B7I1aMK4%3D&from=65706370"
            ]
        },
        "data": {
            "active_time": "2026-10-16 11:21:16",
            "banner_display": {},
            "display_style": 0,
            "share_info": {
                "share_link_desc": "我在看抖音热榜，发现最火的内容，赶快来看！戳这里>>",
                "share_title": "我在看抖音热榜，发现最火的内容，赶快来看！",
                "share_url": "https://www.iesdouyin.com/share/billboard/?id=0"
            },
            "trending_desc": "实时上升热点",
            "trending_list": [
                {
                    "discuss_video_count": 1,
                    "display_style": 0,
                    "event_time": 1792115668,
                    "group_id": "7695061243912754470",
                    "hot_value": 0,
                    "hotlist_param": "{\"board_type\":3,\"rank\":0,\"time\":1792120937}",
                    "label": 0,
                    "sentence_id": "2697820",
                    "sentence_tag": 22001,
                    "video_count": 5,
                    "word": "今年第30号台风蔷琵已生成",
                    "word_cover": {
                        "uri": "tos-cn-p-0015/oE7A1DZGIPtQZzmPRtiIE8IPYPGCiAaggQTBB",
                        "url_list": [
                            "https://p9-sign.douyinpic.com/tos-cn-p-0015/oE7A1DZGIPtQZzmPRtiIE8IPYPGCiAaggQTBB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=tza86ibVKfUIDacEKgAbfXPn5Kc%3D&from=3218412987",
                            "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/oE7A1DZGIPtQZzmPRtiIE8IPYPGCiAaggQTBB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=7wG6g1WEjJMx1y2eWkWJaZqmklk%3D&from=3218412987",
                            "https://p26-sign.douyinpic.com/tos-cn-p-0015/oE7A1DZGIPtQZzmPRtiIE8IPYPGCiAaggQTBB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=kKurrqz7Q6JpibI9hTeDHmhJOhs%3D&from=3218412987"
                        ]
                    },
                    "word_type": 3
                },
                {
                    "discuss_video_count": 1,
                    "display_style": 0,
                    "event_time": 1792110157,
                    "group_id": "7695783551501571368",
                    "hot_value": 0,
                    "hotlist_param": "{\"board_type\":3,\"rank\":0,\"time\":1792120937}",
                    "label": 0,
                    "sentence_id": "2697679",
                    "sentence_tag": 3002,
                    "video_count": 1,
                    "word": "乌拉圭中国和平统一促进会成立",
                    "word_cover": {
                        "uri": "tos-cn-p-0015/oIGgnIqBYQ1oHLlBfG0eGyegv4PEC7AciVQtAB",
                        "url_list": [
                            "https://p3-sign.douyinpic.com/tos-cn-p-0015/oIGgnIqBYQ1oHLlBfG0eGyegv4PEC7AciVQtAB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=cgpt7IH%2FtCRYhd%2FHWnTYShypAMU%3D&from=3218412987",
                            "https://p11-sign.douyinpic.com/tos-cn-p-0015/oIGgnIqBYQ1oHLlBfG0eGyegv4PEC7AciVQtAB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=V8YYB3r42aiD9%2FMantbrkDhFg5A%3D&from=3218412987",
                            "https://p26-sign.douyinpic.com/tos-cn-p-0015/oIGgnIqBYQ1oHLlBfG0eGyegv4PEC7AciVQtAB~noop.jpeg?lk3s=bfd515bb&x-expires=1792141200&x-signature=ZN6gXNCdBXDfAYD1riW%2Bs3vKcrg%3D&from=3218412987"
                        ]
                    },
                    "word_type": 3
                },
                {
                    "discuss_video_count": 1,
                    "display_style": 0,
                    "event_time": 1792107477,
                    "group_id

JSON 关键字段说明#

热榜主数据字段说明#

实时上升热点字段说明#

热榜列表字段说明#

请求参数

请求示例代码

返回响应

JSON 关键字段说明

热榜主数据字段说明

实时上升热点字段说明

热榜列表字段说明