Start building

Douyin Xingtu Batch Video Stats

https://api.sandbase.ai/v1/api/douyin/xingtu-v2/multi-get-item-stats

Returns batch performance statistics and details for up to 20 videos, including play counts, engagement metrics, and watch durations.

Try this APIGet API key
Price
$0.06USD / call
Method
POST
Response
JSON
Parameters
1 required · 2 optional
Production route

Try the model

Playground

Open playground
Input
Video (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup
Whether to return cover URL, default true
Platform source, default 1
OutputExample
Responseoutputs · 23.6 KB · 420 lines
[
  {
    "data": {
      "base_resp": {
        "status_code": 0,
        "status_message": ""
      },
      "items": [
        {
          "author_id": "2096083966377147",
          "cover_uri": "tos-cn-i-0813c000-ce/o8TxeAAapEEI7tPVC0FEwPDpAiA9LkAQIifKnu",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c000-ce/o8TxeAAapEEI7tPVC0FEwPDpAiA9LkAQIifKnu~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=hAK7MBew4s67%2BUUrl%2BBTWTHT6Kk%3D",
          "create_time": "1770709994",
          "duration": 43.467,
          "id": "7605141504243990257",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "546",
            "favorite_cnt": "148",
            "interact_rate": 0.0191,
            "like_cnt": "529",
            "share_cnt": "621",
            "watch_cnt": "88772"
          },
          "status": 102,
          "title": "那些你自以为冷门的院校，其实热度都比较高，报考难度远超你的想象。安徽单招这六所学校，今年一定要慎重报考。安徽交通职业技术学院，230分左右，学长学姐口碑加持，热度一路上涨。芜湖职业技术大学，260分，宠物医疗专业高分扎堆。铜陵职业技术学院，210分，咨询量暴涨，专业全覆盖几乎没有冷门。安徽新闻出版职业学院，220分，今年热度飙升，两百左右慎报。安徽第二医学院，260分，医药类院校分数一环套一环，绝对不低。安徽工业经济职业学院，220分，千万别当保底，热门专业竞争尤其激烈。想低分上岸公办，把你的分数打在评论区，我来帮你分析。#安徽单招 #单招 #高考 #教育 #高考",
          "topic_ids": [
            "1767586207449160",
            "1767586186090510",
            "1666292875985923",
            "1617646322895876"
          ],
          "url": "https://www.iesdouyin.com/share/video/7605141504243990257/?region=CN&mid=7533062627972876338&u_code=24dh3cm6d40d&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=EiX31eL0N95ISq1ozhtI9kAH8kKEd80Eq_lvLNgGpy4-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v2700fgi0000d65e77nog65uch1hobig"
        },
        {
          "author_id": "7645971568649520165",
          "cover_uri": "tos-cn-i-0813c000-ce/okapXlAIIEdKKeAE8iqA3D9EmQicekAfwA3FE9",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c000-ce/okapXlAIIEdKKeAE8iqA3D9EmQicekAfwA3FE9~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=r3zevsbl3zu3K7Ntb%2BpScBjrYBw%3D",
          "create_time": "1788528928",
          "duration": 1476.114,
          "id": "7681673254012674789",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "1",
            "favorite_cnt": "19",
            "interact_rate": 0.02,
            "like_cnt": "25",
            "share_cnt": "8",
            "watch_cnt": "1695"
          },
          "status": 102,
          "title": "#安徽单招备考 #真题解析 #安徽单招试卷 2023年安徽普通高校分类考试招生和对口招生文化素质测试英语试题详细讲解",
          "topic_ids": [
            "1613210804315208",
            "1730330105234448",
            "1729627036724227"
          ],
          "url": "https://www.iesdouyin.com/share/video/7681673254012674789/?region=CN&mid=7681673211377519395&u_code=f3kf2dfdkm88hk&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=vbZLWujrDnyZ48p.0SDtWHAQMZUGHoV08FrcQeC0bYM-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v1e00fgi0000dadch97og65oi1sl6vpg"
        },
        {
          "author_id": "7548277053888595004",
          "cover_uri": "tos-cn-i-0813c000-ce/os7JaAAc1CEBHK1tE0iiwLBRAVAeTOAIE8fUep",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c000-ce/os7JaAAc1CEBHK1tE0iiwLBRAVAeTOAIE8fUep~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=k8oo4DPg3eYzuInuAw206%2FoDDsY%3D",
          "create_time": "1789732261",
          "duration": 2741.115,
          "id": "7686841529931612005",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "26",
            "favorite_cnt": "856",
            "interact_rate": 0.0585,
            "like_cnt": "1148",
            "share_cnt": "522",
            "watch_cnt": "28944"
          },
          "status": 102,
          "title": "2026年安徽省普通高校分类考试招生和对口招生文化素质测试卷精细讲解#2026年安徽省普通高校分类考试招生和对口招生文化素质测试卷精细讲解 #数学 #高职单招 #职教高考 #单招小帅💫",
          "topic_ids": [
            "7565367114019407906",
            "1565460180830209",
            "1597639187883085",
            "1657041526807559"
          ],
          "url": "https://www.iesdouyin.com/share/video/7686841529931612005/?region=CN&mid=7686841735376358182&u_code=ema2jdh5gc90il&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=U5kIAtZPt_Gm8AgosYWpydaa.0W3QieJ2MkOtkQwffo-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v1e00fgi0000dami3qfog65tpoijimf0"
        },
        {
          "author_id": "1554043912335548",
          "cover_uri": "tos-cn-p-0015c000-ce/oMsaf5gLMEK7QDuVAwDZQrIJfeBtZDJO4D57SF",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-p-0015c000-ce/oMsaf5gLMEK7QDuVAwDZQrIJfeBtZDJO4D57SF~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=6aciaj7fbFSDM%2F%2Be%2BEBgcRYquAI%3D",
          "create_time": "1789188095",
          "duration": 237.307,
          "id": "7684504353231549617",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "75",
            "favorite_cnt": "177",
            "interact_rate": 0.0238,
            "like_cnt": "164",
            "share_cnt": "97",
            "watch_cnt": "14096"
          },
          "status": 102,
          "title": "单招报考备考流程 #单招流程 #单招全流程 #单招#安徽单招",
          "topic_ids": [
            "1665127934943236",
            "1784253888485449",
            "1617646322895876",
            "1666292875985923"
          ],
          "url": "https://www.iesdouyin.com/share/video/7684504353231549617/?region=CN&mid=7684504294603262739&u_code=1ebibm1eg22g&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=iVFUMvOxzjG2_XvUPu.KJPNc2tza9xdSqAkZwqQ8PnQ-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v2700fgi0000daidfb7og65sk5oppsc0"
        },
        {
          "author_id": "7682972496518628410",
          "cover_uri": "tos-cn-p-0015c000-ce/oAErIAEP98IqAmBqXiijfDgqahzAxitwe7fPCO",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-p-0015c000-ce/oAErIAEP98IqAmBqXiijfDgqahzAxitwe7fPCO~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=vNGgcGekeu8thwYIsCJi0nsEgZw%3D",
          "create_time": "1789653242",
          "duration": 19.767,
          "id": "7686502146531783675",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "32",
            "favorite_cnt": "21",
            "interact_rate": 0.0181,
            "like_cnt": "47",
            "share_cnt": "12",
            "watch_cnt": "5012"
          },
          "status": 102,
          "title": "高职生们安徽27年单招考试就这么多内容，不要焦虑能考上心怡的学校#抖音官方给予流量 #安徽单招 #单招自学 #高职单招 #高职分类考试",
          "topic_ids": [
            "1597639187883085",
            "1667075306670088",
            "1727183449224206",
            "1666292875985923",
            "1746179657593863"
          ],
          "url": "https://www.iesdouyin.com/share/video/7686502146531783675/?region=CN&mid=7032497286391417613&u_code=f5db6bh43hj850&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=LXh5W_CwqUkrptoBlmCPSU1MM4OOBx3.dm6v70ru.rw-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v1e00fgi0000dalv1ovog65jbqh3m3d0"
        },
        {
          "author_id": "3788231789775864",
          "cover_uri": "tos-cn-i-dy/17a919ff7e3548e8a759ae0fcb3293c2",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-dy/17a919ff7e3548e8a759ae0fcb3293c2~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=mias3aCGwAan0A%2BcHPKWaJ0bFhE%3D",
          "create_time": "1784516640",
          "duration": 222.748,
          "id": "7664189446983601444",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "88",
            "favorite_cnt": "2128",
            "interact_rate": 0.0423,
            "like_cnt": "2629",
            "share_cnt": "1268",
            "watch_cnt": "94064"
          },
          "status": 102,
          "title": "安徽单招到底考什么？ #2027安徽单招  #安徽分类招生 #安徽小高考 #安徽春招#安徽升学上了么",
          "topic_ids": [
            "7628451956167706674",
            "1694391657232388",
            "1783460329663626",
            "1725712307050500",
            "7654510841357846578"
          ],
          "url": "https://www.iesdouyin.com/share/video/7664189446983601444/?region=CN&mid=7664189499647281961&u_code=3ma54h8191am&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=VZORGbwdxSxxdb0xmSLIF3kA9UjjjDIaJwjaV_NbvA8-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v0d00fg10000d9eag3vog65vqjd76mug"
        },
        {
          "author_id": "1942164708798864",
          "cover_uri": "tos-cn-p-0015c000-ce/okmEcHMAPia5BzigKqAX9Is4CxraZFPo2Aubq",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-p-0015c000-ce/okmEcHMAPia5BzigKqAX9Is4CxraZFPo2Aubq~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=K6%2F6wflFUTdFvREeYlK7BWDkHWI%3D",
          "create_time": "1789790921",
          "duration": 62.834,
          "id": "7687093469244621938",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "0",
            "favorite_cnt": "0",
            "interact_rate": 0,
            "like_cnt": "0",
            "share_cnt": "0",
            "watch_cnt": "7"
          },
          "status": 102,
          "title": "安徽单招校考刷题 安徽单招每日一练#安徽单招 #单招#安徽单招校考刷题",
          "topic_ids": [
            "1617646322895876",
            "1666292875985923"
          ],
          "url": "https://www.iesdouyin.com/share/video/7687093469244621938/?region=CN&mid=7362980521259943987&u_code=20k6f82f7al4&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=z_ueTT7JcrxZrdqNs7dVOiNlDVn7otQ0HT6vitoyyjI-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v2700fgi0000dan0lb7og65p2lou1jl0"
        },
        {
          "author_id": "3931451706847096",
          "cover_uri": "tos-cn-p-0015c000-ce/oIMijcwkfAIJMlceDD9qr8CysEEeFAZBoVYQnz",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-p-0015c000-ce/oIMijcwkfAIJMlceDD9qr8CysEEeFAZBoVYQnz~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=sPimqbMBbXUAo29%2F8CW462ubuIw%3D",
          "create_time": "1787910626",
          "duration": 165.034,
          "id": "7679017665726767333",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "43",
            "favorite_cnt": "24",
            "interact_rate": 0.0231,
            "like_cnt": "40",
            "share_cnt": "26",
            "watch_cnt": "4699"
          },
          "status": 102,
          "title": "会考不过 还能走单招和高考吗 最近安徽会考补考发布考试报名时间，很多家长和同学特别焦虑，会考也就是学业水平合格考没有考过，还能不能参加2027年的高考，还能不能走单招呢？今天结合安徽省官方政策，把哪些学生要考会考、会考报名时间以及高考、单招限制全部讲透。#安徽高考 #安徽会考 #安徽单招 #会考补考 #安徽升学规划马老师",
          "topic_ids": [
            "1604038425499662",
            "1637041044225037",
            "1666292875985923",
            "1677131619162125",
            "7405063541390067751"
          ],
          "url": "https://www.iesdouyin.com/share/video/7679017665726767333/?region=CN&mid=7679017651649514294&u_code=42kh1cka06lb&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=e.V9XYGY7fspDMpDS.kpGQ3EJ6VtJfOqAklxsavrN6U-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v1e00fgi0000da8liovog65pq5co1ecg"
        },
        {
          "author_id": "97841532102",
          "cover_uri": "tos-cn-i-0813c000-ce/oIfqnY9FAvDrMZwETfFy0IALEkAJQwC1P5Ao1A",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c000-ce/oIfqnY9FAvDrMZwETfFy0IALEkAJQwC1P5Ao1A~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=eBidbFldOuNyMKxAxEFZkFPR86c%3D",
          "create_time": "1789721782",
          "duration": 27.352,
          "id": "7686796523062249137",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "238",
            "favorite_cnt": "661",
            "interact_rate": 0.0381,
            "like_cnt": "1620",
            "share_cnt": "1694",
            "watch_cnt": "93031"
          },
          "status": 102,
          "title": "27年安徽单招院校分数参考（预测版） #安徽单招 #安徽单招院校分数 #安徽单招院校分数 #单招院校分数 #高三家长必看",
          "topic_ids": [
            "7545405485910853684",
            "1724999138841604",
            "1643619307483143",
            "1666292875985923"
          ],
          "url": "https://www.iesdouyin.com/share/video/7686796523062249137/?region=CN&mid=7543083831579822107&u_code=15gl9da5e&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=ghk10swjlAKGv5HcraSSBI7YoKyksNQGTR5iEmyAX0k-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v2800fgi0000damfmsnog65p9oggboog"
        },
        {
          "author_id": "7419375557656183867",
          "cover_uri": "tos-cn-p-0015c000-ce/oc58oEwPfAEXYMcmBD9qgzBS5EEoFA6yzOWI2e",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-p-0015c000-ce/oc58oEwPfAEXYMcmBD9qgzBS5EEoFA6yzOWI2e~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=SSbo6FucYAG4kCq%2BlCFRCQ1S%2F2s%3D",
          "create_time": "1782376246",
          "duration": 57.005,
          "id": "7655247684618425946",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "350",
            "favorite_cnt": "114",
            "interact_rate": 0.0224,
            "like_cnt": "379",
            "share_cnt": "264",
            "watch_cnt": "44146"
          },
          "status": 102,
          "title": "关于合职的快问快答#安徽大专宿舍 #高考 #志愿填报 #专科",
          "topic_ids": [
            "1767586186090510",
            "1767586817785870",
            "1583237620457486",
            "1724528976012295"
          ],
          "url": "https://www.iesdouyin.com/share/video/7655247684618425946/?region=CN&mid=7655247647804066569&u_code=egcj6b31jd394b&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=Xjz7dilPRZrFiZ_pEo2In6e2yEA4UL9UB4raLvZcMDY-&share_version=260800&ts=1789806295&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
          "video_id": "v2800fgi0000d8ue6a7og65upo774490"
        },
        {
          "author_id": "1768431208630398",
          "cover_uri": "tos-cn-i-0813c000-ce/oEcbhEAwQImW2LAJvfVBeGCEPgUb8MAegAkLJ7",
          "cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c000-ce/oEcbhEAwQImW2LAJvfVBeGCEPgUb8MAegAkLJ7~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2105166295&x-signature=2uZJ9aD%2BTFB4DGm5lvR4J79G6aA%3D",
          "create_time": "1788836911",
          "duration": 303.6,
          "id": "7682996027443604389",
          "stats": {
            "avg_watch_dura": "0",
            "comment_cnt": "64",
            "favorite_cnt": "785",
            "interact_rate": 0.0417,
            "like_cnt": "888",
            "share_cnt": "496",
            "watch_cnt": "34660"
          },
          "status": 102,
          "title": "【少帅精讲】90%的考生都不知道怎么备考2027年安徽单招 一条视频详细说清楚 #安徽 #2027年安徽单招全流程 #高职单招 #职教高考 #分类考试",
          "topic_ids": [
            "1597639187883085",
            "1657041526807559",
            "1599506466429960",

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.06 / run

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

item_ids
array · required
need_cover_url
boolean · optional
platform_source
integer · optional

Access

Provider
Douyin
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/douyin/xingtu-v2/multi-get-item-stats
Authentication
Bearer API key

API README

Douyin Xingtu Batch Video Stats API

Retrieves detailed metrics and engagement statistics for multiple videos using item_ids. Supports optional cover image URLs via need_cover_url and source filtering via platform_source.

Use cases

  • Track performance statistics across multiple Douyin videos simultaneously.
  • Analyze viewer interaction rates and average watch durations for video content.
  • Retrieve video details and thumbnail cover links in batch requests.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/multi-get-item-stats" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_ids": "<item_ids>"}'

Parameters

NameTypeRequiredDescription
item_idsarrayYesVideo (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup
need_cover_urlbooleanNoWhether to return cover URL, default true
platform_sourceintegerNoPlatform source, default 1

Notes

  • Accepts up to 20 IDs in item_ids per call with automatic deduplication; exceeding this limit returns an error.
  • need_cover_url defaults to true.
  • platform_source defaults to 1.

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/xingtu-v2/multi-get-item-stats
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/xingtu-v2/multi-get-item-stats" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "item_ids": [
    "7687093469244621938",
    "7686796523062249137",
    "7686841529931612005",
    "7686502146531783675",
    "7685975419837331142",
    "7685632954731224040",
    "7684504353231549617",
    "7682996027443604389",
    "7681673254012674789",
    "7679017665726767333",
    "7678315154521558291",
    "7664189446983601444",
    "7655247684618425946",
    "7615169499202358385",
    "7605141504243990257"
  ],
  "need_cover_url": true,
  "platform_source": 1
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Douyin Xingtu Batch Video StatsThis API
Douyin		$0.06 per callJSONJul 31, 2026
Douyin Xingtu Author Audience Distribution
Douyin		$0.003 per callJSONJul 31, 2026
Douyin Xingtu Author Base Info
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin Xingtu Author Business Card Info
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin Xingtu Author Content Hot Keywords
Douyin		$0.0015 per callJSONJul 31, 2026
Douyin Xingtu Author Conversion Ability
Douyin		$0.003 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Douyin Xingtu Batch Video Stats API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu-v2/multi-get-item-stats 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 Xingtu Batch Video Stats API cost?

$0.06 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Douyin Xingtu Batch Video Stats API accept?

Required: item_ids (array). Optional: need_cover_url (boolean) and platform_source (integer). The Parameters table and the Playground on this page list every field.

What does the Douyin Xingtu Batch Video Stats API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Douyin developer account or API key?

No. Douyin Xingtu Batch Video Stats 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.