Douyin Hot Video Ranking
https://api.sandbase.ai/v1/api/douyin/billboard/hot-total-video-listGet Douyin hot video rankings: overall hot videos, low-follower breakouts, high completion, follower growth and like-rate lists, with play, like and follower stats, filters by category and time window.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 0 required · 6 optional
Production route
Try the model
Playground
Input
Time window, 1 by hour 2 by day
Search keyword to filter the billboard, empty for all
Page number
Number of items per page
List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 High like rate
OutputExample
[
{
"data": {
"code": 0,
"data": {
"objs": [
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/mosaic-legacy_313180009a2088d4cd19c.jpeg?from=2956013662",
"fans_cnt": 36229536,
"favorite_id": 0,
"follow_cnt": 8327,
"follow_rate": 0.00062,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p26-sign.douyinpic.com/tos-cn-i-0813/okzRsP3I4kuAiBDAoEwAaA4PgyAIIhRBi9aTH~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=16ZQYQP80oMeQUaYht7zW4S%2FHYQ%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 260800,
"item_id": "7692701792556425715",
"item_title": "一展歌猴 @二烟 导演@小包老师😇 摄像@迪锥美羊羊 道具@战神7 狼人@仙女味的廉静 好人",
"item_url": "https://v11-cold.douyinvod.com/6d705d3c7b8934b5a331b80ca92cecf7/6ac5c846/video/tos/cn/tos-cn-ve-15/oMGcyNPGiIosAAkSv67xiQuIQCYHAENIwaBxz/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1548&bt=1548&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=NWg5Njc8ZjY3ZDRmMzU0NUBpMzdtNm05cmd5ZTMzNGkzM0AwNjIuLjU1NjQxMjIzLTMuYSMtaV9rMmRrLy1hLS1kLTBzcw%3D%3D&btag=c0010e000b5000&cquery=103R_103S_100b_105O_103Q&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 436943,
"like_rate": 0.032184,
"media_type": 4,
"nick_name": "脱缰凯✨",
"play_cnt": 13576423,
"publish_time": 1791104400,
"score": 193300
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_o0AyY7EgNKAeSDZmBt9xCWbVAtn3ACAIfA3lRZ.jpeg?from=2956013662",
"fans_cnt": 222,
"favorite_id": 0,
"follow_cnt": 76,
"follow_rate": 0.000064,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p11-sign.douyinpic.com/tos-cn-p-0015c000-ce/o0z8JXzUAQW7zMWegInJlW7AejQBhVf8gBCEQN~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=XnlMSrZ%2Fpswp1SCPBpSFRisQrZg%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 9000,
"item_id": "7692797453477357221",
"item_title": "真人版派大星",
"item_url": "https://v5-ex-wha.douyinvod.com/3ab6c20b8a0bb57dd98a939319a7013c/6ac5c74b/video/tos/cn/tos-cn-ve-15c000-ce/oYQEyvwwfAQYC52egD9qjRCEnEEeFA8FlkCI81/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1342&bt=1342&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmoESfqk_vjVQWw&mime_type=video_mp4&qs=0&rc=Z2lkNztkODdnaWc2Njs1ZEBpM3EzZnQ5cnY3ZTMzbGkzNEAwMjVeXzI2XmIxYV9gYzY2YSNlMmFtMmRrcC5hLS1kLWJzcw%3D%3D&btag=c0010e00088200&cquery=103R_103S_100b_105O_103Q&dy_q=1791342898&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 9170,
"like_rate": 0.007989,
"media_type": 4,
"nick_name": "隔壁老王！！",
"play_cnt": 1147868,
"publish_time": 1791118983,
"score": 193286
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_8071113cdbb90b269df86935bd416948.jpeg?from=2956013662",
"fans_cnt": 414,
"favorite_id": 0,
"follow_cnt": 131,
"follow_rate": 0.00031,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p26-sign.douyinpic.com/tos-cn-p-0015c000-ce/owS2KFnDqB35Qa6FE92dnAIPAEABfwtwa9Qdf4~tplv-dy-resize-walign-adapt-aq:720:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=t0cjPiZo1b%2B1siDpFhc6%2B%2FOo7C4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 39209,
"item_id": "7692673596078405818",
"item_title": "听完整个人都通透了#雨爱 #全开麦live",
"item_url": "https://v5-ex-wha.douyinvod.com/86cf1c3622a730c4aafb642b9643665a/6ac5c769/video/tos/cn/tos-cn-ve-15c000-ce/oof9QA2PS54fGDaDQlBZIjA5wgF4EqAdw6DnFE/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=321&bt=321&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmoESfqk_vjVQWw&mime_type=video_mp4&qs=0&rc=OWczNzNnOjg2M2Y0O2c3M0Bpajs0dXY5cmh3ZTMzbGkzNUBeYTJgYjNjXzExNV9hYy8vYSMxbjVnMmQ0by1hLS1kLTRzcw%3D%3D&btag=c0010e00098200&cquery=103Q_103R_103S_100b_105O&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 35907,
"like_rate": 0.083519,
"media_type": 4,
"nick_name": "𝒍𝒛𝒊𝒐𝒑𝒏❄️",
"play_cnt": 429925,
"publish_time": 1791090146,
"score": 193230
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_967386b48e1849c3df2025ea45206947.jpeg?from=2956013662",
"fans_cnt": 30,
"favorite_id": 0,
"follow_cnt": 2089,
"follow_rate": 0.000384,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p26-sign.douyinpic.com/tos-cn-i-0813/ogI2LSgfSL0nA0GFIAe4LrAMAvQDfALlC2fqaD~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=0SwGjZvcoKsQSpP6s15gNfFsmBs%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 34234,
"item_id": "7692066750174655846",
"item_title": "去鸡龙等自担表演 在调镜头看后台站着谁 结果陌生小糊豆以为我是他粉丝 就一直偷偷跟我们打招呼… #atbo #ATBO #郑胜换",
"item_url": "https://v11-cold.douyinvod.com/df9fc3d339234571c15a69a8de4dfa22/6ac5c764/video/tos/cn/tos-cn-ve-15/ogMfSqi5EVR7AFZNYgDQPgA7GZKvBuDgAIDf9A/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1224&bt=1224&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=Zjw5OmdoOWQ5NGhoMzlmN0BpajNyZmo5cjl1ZDMzNGkzM0BgYjQ0Xi9gNmAxNC0xLTM1YSNfbDViMmRjNnNhLS1kLTBzcw%3D%3D&btag=c0010e0009d000&cquery=100b_105O_103Q_103R_103S&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 699405,
"like_rate": 0.135027,
"media_type": 4,
"nick_name": "小烦",
"play_cnt": 5179758,
"publish_time": 1790948853,
"score": 192881
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_osD9e2QiVA3dAVnsCgb885ANApIpnAn5AXEmeA.jpeg?from=2956013662",
"fans_cnt": 591,
"favorite_id": 0,
"follow_cnt": 170,
"follow_rate": 0.000136,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015c000-ce/ocDgfEsDQQxwRF0AuosfnZ1uh6lUB9wKAqIMAE~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=uAwKq3mx9m6abnXk2T0bPwOVwfE%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 17900,
"item_id": "7692366883895556965",
"item_title": "",
"item_url": "https://v5-coldp.douyinvod.com/fe91be4e3ffc674a7521f4ca5b4ddb5f/6ac5c753/video/tos/cn/tos-cn-ve-15c000-ce/ogTAxEUDwuEBZQ6Ff9q9EgAsQKDgCwItMRCmfo/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1135&bt=1135&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=OGlkNTc4NzxoO2RnOGdlZkBpM3FtbnA5cjdmZTMzbGkzNUA2YTYvL19jNl4xYi4wLWJfYSMybi4vMmRjNS1hLS1kLTVzcw%3D%3D&btag=c0010e00095000&cquery=103S_100b_105O_103Q_103R&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 39600,
"like_rate": 0.032607,
"media_type": 4,
"nick_name": "陌上花中归",
"play_cnt": 1214467,
"publish_time": 1791018733,
"score": 192874
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/douyin-user-private-image_lilanxin.369_d52b51cfd28cc8f1c29475433710b182405f5202bf22519b9d07b717065fcc32.jpeg?from=2956013662",
"fans_cnt": 88718297,
"favorite_id": 0,
"follow_cnt": 339,
"follow_rate": 0.000046,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p11-sign.douyinpic.com/tos-cn-i-dy/d6b6263d61a143c4ad41f2b5d7e02da6~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=ZSjU%2BZ0mZMxS8UkB6f88%2Fi%2F10BM%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 11917,
"item_id": "7693002645090454847",
"item_title": "萌娃第一次尝到玉米甜味，不自觉发出惊喜声音，宝宝：世界上怎么会有如此美味的东西！#媒体原创",
"item_url": "https://v26-cold.douyinvod.com/1a76796185324a0d661cf152bcc5d4dd/6ac5c74d/video/tos/cn/tos-cn-ve-15/ooE9oYEDirqAAGDOBgfZFGANQkIfTBMWAwwqCA/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=694&bt=694&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=OTY5OWY0N2VoOGhmNGRnPEBpanlqams5cjhqZTMzNGkzM0A0XzUwLjIyNTAxMF5hXy1iYSNgYi8uMmRrZi5hLS1kLWFzcw%3D%3D&btag=c0010e0008f000&cquery=103Y_100b_105O_103Q_103W&dy_q=1791342898&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 109065,
"like_rate": 0.014974,
"media_type": 4,
"nick_name": "新华社",
"play_cnt": 7283741,
"publish_time": 1791166765,
"score": 192856
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_a5db55a32f0b8ea2af44779f84334445.jpeg?from=2956013662",
"fans_cnt": 207794,
"favorite_id": 0,
"follow_cnt": 846,
"follow_rate": 0.000374,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/e1ebd695722b4212b7d7c0ae4c09fd46~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=CJpSQ%2FArgZImSfxWnBYNcvmf0j4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 165606,
"item_id": "7692784701945335094",
"item_title": "当00后成为随礼主流，我在现场，是真的#00后 #结婚 #婚礼 #抖音ai创作大赛 #ai创作浪潮计划",
"item_url": "https://v26-cold.douyinvod.com/d23649b309e66bc7e924d399e5f23b3b/6ac5c7e7/video/tos/cn/tos-cn-ve-15/ogjIgEug9IuQqASfCf6wvkq2oIcDABFIN5dAcp/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=890&bt=890&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=aGRmNTc5aDhmPGg2OGdoZUBpajd3Z3E5cjU3ZTMzNGkzM0BiMS01MDZhXjUxYzUvMi8wYSNiNi9iMmQ0MS5hLS1kLWFzcw%3D%3D&btag=c0010e000af000&cquery=103Y_100b_105O_103Q_103W&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 173297,
"like_rate": 0.071564,
"media_type": 4,
"nick_name": "小黄油美式",
"play_cnt": 2421554,
"publish_time": 1791116023,
"score": 192850
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_3689232578e3b8838bcccfa472ba5b82.jpeg?from=2956013662",
"fans_cnt": 115,
"favorite_id": 0,
"follow_cnt": 190,
"follow_rate": 0.000074,
"image_cnt": 1,
"is_favorite": false,
"item_cover_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-0813c000-ce/ogfQIyfnwCEimTcEAITA8AA9xIDwPqyPBA9DiD~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=Z%2B7C1KEy9C1Dkh2TV39sr0A3ZNI%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_images&l=2026100711145796875C55CB7C7966405F",
"item_duration": 0,
"item_id": "7693028932757314810",
"item_title": "快点快点快点，快点分手吧，你的男朋友可真丑呀",
"item_url": "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/83eef67dfc6b46eb8ae117e440540f12",
"like_cnt": 326244,
"like_rate": 0.145021,
"media_type": 2,
"nick_name": "你自己可以的吧",
"play_cnt": 2249637,
"publish_time": 1791172879,
"score": 192676
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_a8546170a01476c370458b000732b5ea.jpeg?from=2956013662",
"fans_cnt": 2010,
"favorite_id": 0,
"follow_cnt": 307,
"follow_rate": 0.000158,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015c000-ce/ow1gAefDAjqBPR8V7rUCJVwIZIQ9IELAF2HgeG~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=%2FeO6mQJZF5F8xvC%2FYWgOlNYUEQ8%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 15033,
"item_id": "7692286281620291685",
"item_title": "能让我佩服的五体投地的只有我们家狗#笨狗开笼迷惑行为 #害人精",
"item_url": "https://v11-cold.douyinvod.com/220f8b6d1c053b0988ddee8bea504d38/6ac5c751/video/tos/cn/tos-cn-ve-15c000-ce/oAVegA8BAGIbVgELofVCeLaRqJ8YDRAj7PgwDA/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1509&bt=1509&cs=0&ds=3&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=ZDQ2OjdmZmQ5OWk7NWVoN0BpM3lqZm45cmo6ZTMzbGkzNEA1NjMyXzMwX2AxMjZiYjQvYSMyXi5gMmRjbi1hLS1kLWJzcw%3D%3D&btag=c0010e00095000&cquery=100b_105O_103Q_103R_103S&dy_q=1791342898&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 103085,
"like_rate": 0.047522,
"media_type": 4,
"nick_name": "老杨养狗（省钱版）",
"play_cnt": 2169226,
"publish_time": 1790999966,
"score": 192595
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_ocIAAIIaA3PQqEiuk5GtgvtC8Aih7BZA47j1O.jpeg?from=2956013662",
"fans_cnt": 1189,
"favorite_id": 0,
"follow_cnt": 93,
"follow_rate": 0.000048,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p11-sign.douyinpic.com/tos-cn-p-0015/os0BfBeI0AhPVjUEgQCG7LAjobIHLTB9GEfEIC~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=rQ1q2VB5xyw9FnnkBRHiZAqBJlU%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 5620,
"item_id": "7692747336803471723",
"item_title": "关于我网购了一包魔芋爽",
"item_url": "https://v5-coldm.douyinvod.com/b804b598c58b461f916e3ab68d9f7993/6ac5c747/video/tos/cn/tos-cn-ve-15/o8IGVhdEPTjEBCUgXFGBoLeAIvEpDflQbAeL7N/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1348&bt=1348&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=ZTtlMzs3Z2c5NjU7OTY4ZEBpM3ltNGs5cm41ZTMzNGkzM0AtYC5iMzU0NmMxLTIzLy9eYSNpMmoxMmRjLi5hLS1kLS9zcw%3D%3D&btag=c0010e0008d000&cquery=100b_105O_103Q_103R_103S&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 66853,
"like_rate": 0.031908,
"media_type": 4,
"nick_name": "火小火",
"play_cnt": 2095178,
"publish_time": 1791107314,
"score": 192531
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c000-ce_osAfQFsnAgm9tD0YQ8FEFaAQFUEApqfewAEKIq.jpeg?from=2956013662",
"fans_cnt": 424,
"favorite_id": 0,
"follow_cnt": 90,
"follow_rate": 0.000141,
"image_cnt": 1,
"is_favorite": false,
"item_cover_url": "https://p26-sign.douyinpic.com/tos-cn-i-0813c000-ce/oAQBXGFgiIDvorAAlqAgfCEQVDQg7WmJOAWfeF~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=4g%2FQaJMjIw8F3vE%2FZrUP1N2MPAw%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_images&l=2026100711145796875C55CB7C7966405F",
"item_duration": 0,
"item_id": "7692703871194424059",
"item_title": "发布了内容",
"item_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7061847831656565535.mp3",
"like_cnt": 48968,
"like_rate": 0.087336,
"media_type": 2,
"nick_name": "八宝览（宁芙奖投约瑟夫）",
"play_cnt": 560682,
"publish_time": 1791097194,
"score": 192325
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_1785a6b84822df8194892dc6e691858d.jpeg?from=2956013662",
"fans_cnt": 478905,
"favorite_id": 0,
"follow_cnt": 489,
"follow_rate": 0.000512,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p26-sign.douyinpic.com/tos-cn-i-0813c000-ce/okE8AObYYiDACAZAE1iBzIfLIA0uwxAJEeDGKe~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=CxP0F3wBRnvvc1Q8vD1AwW3HRME%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 34202,
"item_id": "7693016038002811386",
"item_title": "布林公子拍肖像（纯笑版） #段公子 #肖像摄影 #女性魅力 #搞笑",
"item_url": "https://v13-cold.douyinvod.com/2b9077ee75ca1a99305833c56b7962b2/6ac5c764/video/tos/cn/tos-cn-ve-15c000-ce/o8DsDZfUQkKxqFDAQ2eCAHeCEwEEFIZw9B3RwX/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=785&bt=785&cs=0&ds=6&ft=r5QvG77JWH6BMGdQWJr0PD1IN&mime_type=video_mp4&qs=0&rc=OzM1OTk2O2k2ODw5OGg2OkBpM2RqOXg5cjRrZTMzbGkzNEAtMTViLjE2NTAxLzNjMF4uYSMuL2BqMmRzXi5hLS1kLWJzcw%3D%3D&btag=c0010e0009f000&cquery=103Q_103R_103S_100b_105O&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 68490,
"like_rate": 0.066644,
"media_type": 4,
"nick_name": "哥也是布林",
"play_cnt": 1027706,
"publish_time": 1791169876,
"score": 192286
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_e05ff0bd788110246ebf304554b3edfa.jpeg?from=2956013662",
"fans_cnt": 5018,
"favorite_id": 0,
"follow_cnt": 131,
"follow_rate": 0.000048,
"image_cnt": 0,
"is_favorite": false,
"item_cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/f3dce0cd770245d1a6c7885c66e422e6~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=OdctCuGAYqUjJD8POKzDdf50QN0%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=2026100711145796875C55CB7C7966405F",
"item_duration": 17174,
"item_id": "7693058626528775434",
"item_title": "假期接近尾声，准备掉头…… #搞笑 #导航",
"item_url": "https://v5-ex-wha.douyinvod.com/b8a9e7540eaea191e65117aaa04175ed/6ac5c753/video/tos/cn/tos-cn-ve-15/oAAZDqzB8wuiA5i9MvEQuRAN9ygf3f2DnbwIbB/?a=1128&ch=10&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1724&bt=1724&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmoESfqk_vjVQWw&mime_type=video_mp4&qs=0&rc=PDM6aDg3Nmk7ZjU0PDhmN0BpamlxOXA5cmltZTMzNGkzM0BgMzUvYC40Xy0xYTI0NS8xYSNvLmNyMmRzay5hLS1kLWFzcw%3D%3D&btag=c0010e00090200&cquery=103Y_100b_105O_103Q_103W&dy_q=1791342898&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=2026100711145796875C55CB7C7966405F",
"like_cnt": 16593,
"like_rate": 0.005313,
"media_type": 4,
"nick_name": "嘻嘻剧好看",
"play_cnt": 3123192,
"publish_time": 1791179797,
"score": 192275
},
{
"avatar_url": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c000-ce_oYu0JDeG8QUN7jUB8Vn4G3dq9EfAeIvALAA7gg.jpeg?from=2956013662",
"fans_cnt": 129,
"favorite_id": 0,
"follow_cnt": 151,
"follow_rate": 0.00007,
"image_cnt": 2,
"is_favorite": false,
"item_cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-0813c000-ce/ogiH7PnvohuiCBMA0LFDAApiAaMIAIs8ES3dG~tplv-dy-resize-walign-adapt-aq:720:q75.jpeg?lk3s=138a59ce&x-expires=1792551600&x-signature=m61cNaKA2f5Fgl2BsuIWcGmfnk4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_images&l=2026100711145796875C55CB7C7966405F",
"item_duration": 0,
"item_id": "7692763116220882938",
"item_title": "",
"item_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7661806450376821514.mp3",
"like_cnt": 37068,
"like_rate": 0.015342,
"media_type": 2,
"nick_name": "い波妞重度依赖の❤️",
"play_cnt": 2416150,
"publish_time": 1791110988,
"score": 192037
},Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- date_window
- integer · optional
- keyword
- string · optional
- page
- integer · optional
- page_size
- integer · optional
- sub_type
- integer · optional
- tags
- array · optional
Access
- Provider
- Douyin
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/douyin/billboard/hot-total-video-list
- Authentication
- Bearer API key
API README
Douyin Hot Video Ranking API
Fetch the Douyin (Juliang Suanshu) hot video billboard. Choose a list type with sub_type, filter by keyword or vertical tags, and get ranked videos with play, like and follower metrics.
Use cases
- Spot trending videos and formats before they peak.
- Find low-follower creators with breakout videos.
- Benchmark like rate and completion for a category.
Request
curl -X POST "https://api.sandbase.ai/v1/api/douyin/billboard/hot-total-video-list" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number |
tags | array | No | Sub-level vertical category tag, empty for all, multiple tags need to be passed in |
keyword | string | No | Search keyword to filter the billboard, empty for all |
sub_type | integer | No | List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 Hi… |
page_size | integer | No | Number of items per page |
date_window | integer | No | Time window, 1 by hour 2 by day |
Example response
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"code": 0,
"data": {
"page": {
"page": 1,
"page_size": 10,
"total": 1000
},
"objs": [
{
"item_id": "7692681489309628406",
"publish_time": 1791091983,
"item_duration": 13652,
"play_cnt": 13545023,
"like_cnt": 1218230,
"like_rate": 0.089939,
"follow_rate": 0.00029,
"fans_cnt": 6604,
"score": 1215906,
"item_title": "谁能翻译下😅#猫咪 #喵语 #猫咪的迷惑行为",
"nick_name": "<user>"
}
]
}
}
Notes
sub_type: 1001 overall, 1002 low-follower breakouts, 1003 high completion, 1004 follower growth, 1005 like rate.date_window: 1 = by hour, 2 = by day (default 24).
Related APIs
- Fetch Chinese city list: Get city list.
- Fetch vertical content tags: Get vertical content tags.
- Fetch fan interest author 20 users: Get the fan interest author 20 users.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/billboard/hot-total-video-list" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"page": 20,
"keyword": "",
"sub_type": 1001,
"page_size": 50,
"date_window": 24,
"tags": []
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
Douyin Hot Video RankingThis API Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the Douyin Hot Video Ranking API?
Send a POST request to https://api.sandbase.ai/v1/api/douyin/billboard/hot-total-video-list with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Douyin Hot Video Ranking API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the Douyin Hot Video Ranking API accept?
No parameters are required. Optional: date_window (integer), keyword (string), page (integer), page_size (integer), sub_type (integer) and tags (array). The Parameters table and the Playground on this page list every field.
What does the Douyin Hot Video Ranking API return?
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
Do I need a Douyin developer account or API key?
No. Douyin Hot Video Ranking runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.