Start building

Douyin DOU+ Video Ranking

https://api.sandbase.ai/v1/api/douyin/douplus/video-ranking

Retrieves DOU+ video leaderboard metrics filterable by category, ranking dimension, and time range. Returns video titles, author details, and engagement statistics.

Try this APIGet API key
Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
0 required · 4 optional
Production route

Try the model

Playground

Open playground
Input
Advertiser id, optional
Ranking dimension, default 5. 1=low-fan hits, 2=high completion, 3=high like-rate, 4=high follower-growth, 5=hotness index
Category id, default 634 (Entertainment). Full map: 601 Plot, 602 Star, 606 Music, 607 ACGN,
Time range, 1 / 2 / 3, default 2
OutputExample
Responseoutputs · 56.2 KB · 1,023 lines
[
  {
    "data": {
      "code": 0,
      "data": [
        {
          "author": {
            "followerCount": 464,
            "nickname": "DT&T"
          },
          "cover": "https://p11-sign.douyinpic.com/tos-cn-p-0015/oYA5sFEgDsAFIEbtpj9MfZfywbDFABCItCtqyl~noop.jpeg?x-expires=1786111200&x-signature=2xyILRaWzcPgHQQO1PHHer3wW7s%3D&from=3751895876",
          "createTime": "1785050841",
          "isPhoto": false,
          "itemId": "7666734984943053430",
          "photos": [],
          "playAddr": "https://v13-cold.douyinvod.com/74c7ae52d1bd3e9b3965c75da5d84dd8/6a75a3aa/video/tos/cn/tos-cn-ve-15/oQFIztauQlfBGgyCYlSGeBQ72LALgf2AD0YUIl/?a=1128&br=2033&bt=2033&btag=c0010e00088000&cd=0%7C0%7C0%7C0&ch=0&cquery=101y&cr=0&cs=0&cv=1&dr=0&ds=3&dy_q=1786090899&dy_va_biz_cert=&er=0&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&ft=r5QvG77JWH6BMlpJyJr0PD1IN&l=20260807162138FCE2747C65904F9F6ECE&lr=default&mime_type=video_mp4&qs=0&rc=aTNmZDVpOWg4aDM4Mzs4O0BpM2Y5Znk5cmt1PDMzNGkzM0AzXmFhMy8uXjAxYWMuNjNgYSMxbmttMmRjYWZhLS1kLTBzcw%3D%3D",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.4088438432628168,
            "IndexCnt": "95752",
            "LikeCnt": "0",
            "LikeRate": 0.017288315721151335,
            "NewFansCnt": "522",
            "NewFansRate": 0.0001041212465986062,
            "NewLikeCnt": "86673",
            "NewPlayCnt": "5013386",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "恒隆屋顶漏雨了 #大雨"
        },
        {
          "author": {
            "followerCount": 4609,
            "nickname": "小米之家文山话事人"
          },
          "cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/o0EAki1FmBCuA9BUIfYFtNCgi0xIcM3JkdLAej~noop.jpeg?x-expires=1786111200&x-signature=RRZG29wn0LRmZO5GYOrYo3Qbb7A%3D&from=3751895876",
          "createTime": "1784989238",
          "isPhoto": false,
          "itemId": "7666470398279667539",
          "photos": [],
          "playAddr": "https://v26-cold.douyinvod.com/2105b437b2feb8d287f8e5f97fffd885/6a75a3b8/video/tos/cn/tos-cn-ve-15/oYulemcV1INDAaA3GBMi95LiE9BQFuAkJgfzTI/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=1281&bt=1281&cs=0&ds=6&ft=r5QvG77JWH6BMlpJyJr0PD1IN&mime_type=video_mp4&qs=0&rc=NTVpaGU1ZzgzZjc0aGQ1Z0BpM2hwbHE5cjdmPDMzNGkzM0AwMTI2YjIxNTExNC9gMWFjYSNiNjQvMmRzX2ZhLS1kLWFzcw%3D%3D&btag=c0010e00097000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.40804553494075607,
            "IndexCnt": "81905",
            "LikeCnt": "0",
            "LikeRate": 0.07472019943765844,
            "NewFansCnt": "1762",
            "NewFansRate": 0.0002072378952251307,
            "NewLikeCnt": "635294",
            "NewPlayCnt": "8502306",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "大狗大狗请叫叫！#小米之家 #家电 #商场"
        },
        {
          "author": {
            "followerCount": 2428405,
            "nickname": "豆子姐姐"
          },
          "cover": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/okfEiBqQL40DABXQwHoTafEdFAA9bEZ7FQTciI~noop.jpeg?x-expires=1786111200&x-signature=Pno0qtJ24e2%2B6ihYo6U7qa%2F4Lg4%3D&from=3751895876",
          "createTime": "1785045145",
          "isPhoto": false,
          "itemId": "7666710519680707813",
          "photos": [],
          "playAddr": "https://v26-cold.douyinvod.com/fa96a0c73d2cefc54cba0942af5dd3c8/6a75a3b3/video/tos/cn/tos-cn-ve-15c000-ce/ooZLot1uBEFzIl9AApiQoSej6Bfg1DEIiiwcAM/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=1677&bt=1677&cs=0&ds=6&ft=r5QvG77JWH6BMlpJyJr0PD1IN&mime_type=video_mp4&qs=0&rc=ZWRlOjxnNzhmMzc3Ojg3aEBpM3RoOnc5cmt0PDMzbGkzNUA2XzI1YGBfNjIxYTY0MTE1YSMxZy5rMmRzLWZhLS1kLTVzcw%3D%3D&btag=c0010e00097000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.48216753300400295,
            "IndexCnt": "72638",
            "LikeCnt": "0",
            "LikeRate": 0.0334214873790522,
            "NewFansCnt": "8421",
            "NewFansRate": 0.0006077158917741783,
            "NewLikeCnt": "463115",
            "NewPlayCnt": "13856804",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": ""
        },
        {
          "author": {
            "followerCount": 2299911,
            "nickname": "大豆iuuu"
          },
          "cover": "https://p11-sign.douyinpic.com/tos-cn-i-0813c001/owlTG2XiAneoAI3ElCi1AaBBgdDvAAu4fbKAtz~noop.jpeg?x-expires=1786111200&x-signature=MuP8waYksjAFeelB9haU0JXQEwA%3D&from=3751895876",
          "createTime": "1783851919",
          "isPhoto": false,
          "itemId": "7661585651226012506",
          "photos": [],
          "playAddr": "https://v11-cold1.douyinvod.com/88437548a538bbeeed3030ddc93a30b2/6a75a3d3/video/tos/cn/tos-cn-ve-15/ow6Af1anAaPBtWGU7gVCBKe56IE4IQLT1NEpeG/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=812&bt=812&cs=0&ds=3&ft=r5QvG77JWH6BMlpJyJr0PD1IN&mime_type=video_mp4&qs=0&rc=Z2RoOjo1OGdmPDY2ZzNnNkBpam9yZW85cnZwPDMzNGkzM0BjL19jMzZfNV4xMTA2NTU2YSNeaXNnMmRzZzZhLS1kLTBzcw%3D%3D&btag=c0010e000a5000&cquery=101y&dy_q=1786090899&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.07029501618528793,
            "IndexCnt": "68332",
            "LikeCnt": "0",
            "LikeRate": 0.03886356795006241,
            "NewFansCnt": "2196",
            "NewFansRate": 0.0007402455956903953,
            "NewLikeCnt": "115292",
            "NewPlayCnt": "2966583",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "鸡王争霸赛！ #沙雕日常  #总决赛之夜 #ktv这样拍 #线下live"
        },
        {
          "author": {
            "followerCount": 2014,
            "nickname": "离婚的美丽"
          },
          "cover": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/oAPktMZadAhB5GtBVoPGEjotatOJnmBiCIcAi~noop.jpeg?x-expires=1786111200&x-signature=lamrBwWblTjs3OagN28YRbE4RmM%3D&from=3751895876",
          "createTime": "1784907483",
          "isPhoto": false,
          "itemId": "7666119264278351865",
          "photos": [],
          "playAddr": "https://v11-whb.douyinvod.com/1036f1f2a18227f096ec077a97bd8056/6a75a3ba/video/tos/cn/tos-cn-ve-15c000-ce/oMvGPt2tGBtBwAH51ZjjPLIQiAmiaE2oaMOJd/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=2684&bt=2684&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmotLk0k_vjVQWw&mime_type=video_mp4&qs=0&rc=OjplaDU3aTtlMzQ3OzszZUBpamc5OnM5cjtyPDMzbGkzNUBjXy9jNS9jNV8xLTQ1LV5iYSNqb18wMmQ0YWVhLS1kLTVzcw%3D%3D&btag=c0010e00095000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.29633730216349646,
            "IndexCnt": "52379",
            "LikeCnt": "0",
            "LikeRate": 0.01253947655002178,
            "NewFansCnt": "324",
            "NewFansRate": 0.00024502686220415277,
            "NewLikeCnt": "16581",
            "NewPlayCnt": "1322304",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": ""
        },
        {
          "author": {
            "followerCount": 5175,
            "nickname": "昭乌达演出中心服务号"
          },
          "cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/83b7a5090d374594b876982c69556de1~noop.jpeg?x-expires=1786111200&x-signature=b7Y7qnn44dyktkQWZQ7fdb9Aar0%3D&from=3751895876",
          "createTime": "1784985071",
          "isPhoto": false,
          "itemId": "7666452454124408118",
          "photos": [],
          "playAddr": "https://v11-cold1.douyinvod.com/28f4d13be654849f36204b4bac75fe77/6a75a3e0/video/tos/cn/tos-cn-ve-15/ogxkyaiPlVz1IVAzhQ1IARTrHQmSEFwdiBBvv/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=1022&bt=1022&cs=0&ds=6&ft=r5QvG77JWH6BMlpJyJr0PD1IN&mime_type=video_mp4&qs=0&rc=OzhpOjNkPDg3NTYzNjc8NUBpamt4Zm85cm9lPDMzNGkzM0A2YDJfMDYwNi4xLTU2X2JhYSM1NnFsMmRrXmZhLS1kLWFzcw%3D%3D&btag=c0010e000ad000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.17452862227475352,
            "IndexCnt": "48688",
            "LikeCnt": "0",
            "LikeRate": 0.01032899504488484,
            "NewFansCnt": "500",
            "NewFansRate": 0.0002674104241931559,
            "NewLikeCnt": "19313",
            "NewPlayCnt": "1869785",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "工作日也能看大戏，昭乌达日日正常营业演出！\n#同城夜间游玩 #台上一分钟台下十年功 #ive小品  #昭乌达演出中心"
        },
        {
          "author": {
            "followerCount": 19422,
            "nickname": "鹿屿专营店金桔"
          },
          "cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015c000-ce/oIHn9F0AEINEwKYNxjfytyaA9PfyqDnKEBhKBK~noop.jpeg?x-expires=1786111200&x-signature=oLfUNVQWm99bgnhmBHrFWkPNI7I%3D&from=3751895876",
          "createTime": "1784880301",
          "isPhoto": false,
          "itemId": "7666002521018500017",
          "photos": [],
          "playAddr": "https://v26-wha.douyinvod.com/b59c4fc610e7a8b43e5d9d54f0ef6053/6a75a3aa/video/tos/cn/tos-cn-ve-15c000-ce/osI7kOUAjcepD1aGGJQb7xLbJEgDUgePIzBqe3/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=2513&bt=2513&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmotLk0k_vjVQWw&mime_type=video_mp4&qs=0&rc=Z2hkZTVkZjY8PGg1OWVpZEBpanc7Om05cjlrPDMzbGkzNUBeXl4wNmM2NWMxXy5gYy42YSNqb21xMmRrbWVhLS1kLTRzcw%3D%3D&btag=c0010e0008f000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.5650841160466316,
            "IndexCnt": "36983",
            "LikeCnt": "0",
            "LikeRate": 0.033115704641312985,
            "NewFansCnt": "8484",
            "NewFansRate": 0.001386261598543935,
            "NewLikeCnt": "202670",
            "NewPlayCnt": "6120057",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "#内向"
        },
        {
          "author": {
            "followerCount": 1618,
            "nickname": "嗨"
          },
          "cover": "https://p5-sign.douyinpic.com/tos-cn-p-0015c000-ce/ow4ATfjkPw5eBssID5ziA3CeaEMiEcvt18WNVt~noop.jpeg?x-expires=1786111200&x-signature=HSR%2B4Ox%2FeBiEx887H4%2B3k8chGOg%3D&from=3751895876",
          "createTime": "1784966031",
          "isPhoto": false,
          "itemId": "7666370726571618405",
          "photos": [],
          "playAddr": "https://v5-ex-wha.douyinvod.com/20ef73df0da3058e6129bb6eef74ab43/6a75a3ae/video/tos/cn/tos-cn-ve-15c000-ce/oU1WIeiB1NfEPz5Qx1jkA8TElCihteAM53CkAw/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=2101&bt=2101&cs=0&ds=6&ft=vwbdHCJrBBkq8ZmotLk0k_vjVQWw&mime_type=video_mp4&qs=0&rc=ODg5N2Y7M2ZoMzNnPDw1NkBpanY3dW05cnU5PDMzbGkzNEAzLjIvYjFhNTAxMTRjMDBhYSM2c2MzMmRzamZhLS1kLWJzcw%3D%3D&btag=c0010e00088200&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.5750724055504309,
            "IndexCnt": "36266",
            "LikeCnt": "0",
            "LikeRate": 0.01284826573828865,
            "NewFansCnt": "1109",
            "NewFansRate": 0.00027499231310937203,
            "NewLikeCnt": "51815",
            "NewPlayCnt": "4032840",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "香槟洗脚了解一下#酒搭子的氛围 #酒搭子的快乐 #酒局社交 #酒吧 #氛围感拉满的夜晚"
        },
        {
          "author": {
            "followerCount": 1475,
            "nickname": "蒙二"
          },
          "cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/oMYyGeGPBI1EgKTvlBUALCtSQf7SAzBQ2BeXUM~noop.jpeg?x-expires=1786111200&x-signature=FjsMjkwcaNkHY7BD%2FZIXTS0pnC4%3D&from=3751895876",
          "createTime": "1784976172",
          "isPhoto": false,
          "itemId": "7666414281164994154",
          "photos": [],
          "playAddr": "https://v26-cold.douyinvod.com/60ba549045d0e7fc566b9293fc681842/6a75a3ab/video/tos/cn/tos-cn-ve-15/okEemC1AkompFD0kBAIAbMixUTHBVgfxikAObz/?a=1128&br=416&bt=416&btag=c0010e0008f000&cd=0%7C0%7C0%7C0&ch=0&cquery=101y&cr=0&cs=0&cv=1&dr=0&ds=1&dy_q=1786090899&dy_va_biz_cert=&er=0&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&ft=r5QvG77JWH6BMlpJyJr0PD1IN&l=20260807162138FCE2747C65904F9F6ECE&lr=default&mime_type=video_mp4&qs=0&rc=ZDw5ZGg5NWc4PDszOmdpNkBpM3VucGs5cjQ8PDMzNGkzM0AtXzZiYzZfNi4xMmMyLTQzYSNuLW5oMmRzM2ZhLS1kLS9zcw%3D%3D",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.4706241314506664,
            "IndexCnt": "24982",
            "LikeCnt": "0",
            "LikeRate": 0.0085936881214853,
            "NewFansCnt": "46",
            "NewFansRate": 0.00008280470330714785,
            "NewLikeCnt": "4774",
            "NewPlayCnt": "555524",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "ip正确✔️ #酒吧玩家 #成都 #这里是成都"
        },
        {
          "author": {
            "followerCount": 7600355,
            "nickname": "我是王炸姐"
          },
          "cover": "https://p9-sign.douyinpic.com/tos-cn-i-dy/6fb95a69383045e2a301296ca9d29545~noop.jpeg?x-expires=1786111200&x-signature=nNsNw96Ezcn5M6L5x1yiCeO0m50%3D&from=3751895876",
          "createTime": "1785070607",
          "isPhoto": false,
          "itemId": "7666819829919255860",
          "photos": [],
          "playAddr": "https://v11-whb.douyinvod.com/760ed00912dfca1e6bb399789c43ac16/6a75a3f4/video/tos/cn/tos-cn-ve-15/owqcNNm3vBZIgAF9lAfEPBFQDZAdgcfhIOtDEs/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=345&bt=345&cs=0&ds=2&ft=vwbdHCJrBBkq8ZmotLk0k_vjVQWw&mime_type=video_mp4&qs=4&rc=ZzhoNDkzZTtlZ2c6aGVnZkBpM3N1c2w5cmUzPDMzNGkzM0BgYjFgYy8uXzQxMy00Yy8uYSNqcnFxMmRzNGdhLS1kLWFzcw%3D%3D&btag=c0010e000ad000&cquery=101y&dy_q=1786090899&feature_id=fa11f550cd70094bc4921e3078f61f4c&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.1693478437325795,
            "IndexCnt": "23261",
            "LikeCnt": "0",
            "LikeRate": 0.030416562409228947,
            "NewFansCnt": "186",
            "NewFansRate": 0.00012477351259575193,
            "NewLikeCnt": "45342",
            "NewPlayCnt": "1490701",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "在这看特效大片一定很爽吧#imax #电影"
        },
        {
          "author": {
            "followerCount": 12522,
            "nickname": "sooyaa_"
          },
          "cover": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/osesvMn8AAQPstGBqJxQiuYeIh07g5WmUeDKo8~noop.jpeg?x-expires=1786111200&x-signature=Ll%2BGLdJilNS6WBSIqTpxM9Frp0s%3D&from=3751895876",
          "createTime": "1783587811",
          "isPhoto": false,
          "itemId": "7660451312072971385",
          "photos": [],
          "playAddr": "https://v26-cold.douyinvod.com/fa3efae9ff24a736b0d37a14328a7a60/6a75a3b3/video/tos/cn/tos-cn-ve-15c000-ce/ogRGUnAVKTPsBD0WfSYJJXTAIEQlfWKgFgeL7z/?a=1128&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&cv=1&br=1301&bt=1301&cs=0&ds=6&ft=r5QvG77JWH6BMlpJyJr0PD1IN&mime_type=video_mp4&qs=0&rc=ZGQ8N2llOGVmNTw3NDg4NUBpam9tcm85cjRwPDMzbGkzNUAzYl5jLjItNjExMl5jMTNjYSNqX15eMmRzMzRhLS1kLTVzcw%3D%3D&btag=c0010e00097000&cquery=101y&dy_q=1786090899&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260807162138FCE2747C65904F9F6ECE",
          "statistics": {
            "CommentCnt": "0",
            "FinishPlayRate": 0.51456484147031,
            "IndexCnt": "23135",
            "LikeCnt": "0",
            "LikeRate": 0.04871626128448281,
            "NewFansCnt": "663",
            "NewFansRate": 0.00029540939152348817,
            "NewLikeCnt": "109336",
            "NewPlayCnt": "2244343",
            "ShareCnt": "0",
            "ViewCnt": "0"
          },
          "title": "缩骨功#澳门水舞间"
        },
        {
          "author": {
            "followerCount": 1658,
            "nickname": "薛你脑袋瓜"
          },
          "cover": "https://p11-sign.douyinpic.com/tos-cn-p-0015/oIIQQGFeuufIYPB7RcvUtHLUyQsGLyABAn4VfC~noop.jpeg?x-expires=1786111200&x-signature=rsn%2B%2Bd9iYSYZmwAghd0DQogvs2Y%3D&from=3751895876",
          "createTime": "1784640230",
          "isPhoto": false,
          "itemId": "7664971423357899263",

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

adv_id
any · optional
dim_type
any · optional
tag_id
any · optional
time_range
any · optional

Access

Provider
Douyin
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/douyin/douplus/video-ranking
Authentication
Bearer API key

API README

Douyin DOU+ Video Ranking API

Queries the DOU+ video leaderboard using optional filters such as dim_type, tag_id, and time_range. It returns video engagement metrics, author follower counts, and post titles.

Use cases

  • Track top-performing DOU+ promotional videos across specific content categories.
  • Compare video completion rates, like ratios, and follower growth across leaderboard metrics.
  • Identify trending Douyin short videos ranked by the platform hotness index.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/douplus/video-ranking" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

NameTypeRequiredDescription
adv_idstringNoAdvertiser id, optional
tag_idstringNoCategory id, default 634 (Entertainment).
dim_typestringNoRanking dimension, default 5. 1=low-fan hits, 2=high completion, 3=high like-rate, 4=high follower-growth, 5=hotness index
time_rangestringNoTime range, 1 / 2 / 3, default 2

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "data": [
    {
      "createTime": "1790162085",
      "title": "我宣布这是新的上海落地签#无畏契约 #巴黎世家 #上海 #网吧  #万万没想到",
      "author": {
        "followerCount": 3525257,
        "nickname": "<user>"
      },
      "statistics": {
        "FinishPlayRate": 0.19741609101658283,
        "LikeRate": 0.04709622998026867,
        "NewFansRate": 0.0001355522866117548
      }
    }
  ]
}

Notes

  • dim_type sets the ranking dimension: 1 for low-fan hits, 2 for high completion, 3 for like rate, 4 for follower growth, and 5 for hotness index.
  • tag_id filters by category ID, defaulting to 634 (Entertainment) with options such as 601 (Plot), 602 (Star), 606 (Music), and 607 (ACGN).
  • time_range specifies the period using values 1, 2, or 3, with 2 as the default.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/douyin/douplus/video-ranking
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/douyin/douplus/video-ranking" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "dim_type": 5,
  "time_range": 2
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Douyin DOU+ Video RankingThis API
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin DOU+ Promotable Items
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin DOU+ User Search
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin DOU+ Talent Categories
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin DOU+ Talents by Category
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin Douplus User Posts
Douyin		$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Douyin DOU+ Video Ranking API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/douplus/video-ranking 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 DOU+ 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 DOU+ Video Ranking API accept?

No parameters are required. Optional: adv_id (any), dim_type (any), tag_id (any) and time_range (any). The Parameters table and the Playground on this page list every field.

What does the Douyin DOU+ 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 DOU+ 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.