星图(抖音) · 达人营销

视频报告

传入抖音视频 ID 或链接,返回每个视频的报告,含播放量、互动数据、每日趋势、留存曲线和热门评论。

POST/v1/xingtu/videoReport

$0.0368每条

1,000 条
≈ $36.80
每取一条最低
$0.016429

只能用充值余额一次返回,没有 cursor

在控制台里试

怎么发

用 POST 带 JSON 请求体,或者用 GET 把同样的参数放进查询串。key 放在 Authorization 头里。

curl -X POST "https://api.silklinedata.com/v1/xingtu/videoReport" \
  -H "Authorization: Bearer $SILKLINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":5,"videos":["7695225845299957035"]}'

返回什么

这是 2026-11-21 一次真实请求返回的记录。普通用户的名字、头像和主页链接显示为 <masked>;长文字只在这里截短,接口里是完整的。

200 OK · 取数日期 2026-11-21
{
  "data": [
    {
      "type": "videoReport",
      "videoId": "7695225845299957035",
      "url": "https://www.douyin.com/video/76952258…",
      "title": "史上最固执大爷-珍爱生命,远离牌桌6.0 …",
      "publishedAt": "2026-10-11T10:00:00Z",
      "durationSeconds": 774.34,
      "plays": 28711162,
      "likes": 636105,
      "comments": 19060,
      "shares": 296531,
      "collects": 56982,
      "interactions": 951696,
      "interactionRate": 0.0331,
      "completionRate": 0.1000405475,
      "musicTitle": "@你***",
      "authorId": "<masked>",
      "authorNickname": "<masked>",
      "authorFollowers": "<masked>",
      "dailyTrend": [
        {
          "date": "2026-10-11",
          "plays": 2427651,
          "validPlays": 2105533,
          "likes": 29766,
          "comments": 2489,
          "shares": 17987,
          "collects": 2609,
          "interactions": 50242,
          "hotScore": 4381740,
          "interactionRate": 0.0206,
          "completionRate": 0.0791
        },
        {
          "date": "2026-10-12",
          "plays": 5002888,
          "validPlays": 4038300,
          "likes": 93798,
          "comments": 4835,
          "shares": 58187,
          "collects": 9932,
          "interactions": 156820,
          "hotScore": 9109001,
          "interactionRate": 0.0313,
          "completionRate": 0.1058
        },
        {
          "date": "2026-10-13",
          "plays": 1757724,
          "validPlays": 1270690,
          "likes": 40489,
          "comments": 1572,
          "shares": 20783,
          "collects": 3565,
          "interactions": 62844,
          "hotScore": 3067391,
          "interactionRate": 0.0357,
          "completionRate": 0.1084
        }
      ],
      "retentionCurve": [
        {
          "second": 0,
          "likes": 90834,
          "playsLost": 15650242
        },
        {
          "second": 7,
          "likes": 18831,
          "playsLost": 2471028
        },
        {
          "second": 14,
          "likes": 14193,
          "playsLost": 1251639
        }
      ],
      "topComments": [
        {
          "commentId": "7695389686109766449",
          "text": "还是旺季每月百万流水的农家乐",
          "likes": 9433,
          "replies": 0
        },
        {
          "commentId": "7695387515986199353",
          "text": "开始还以为是演员最后那个眼神真的是心…",
          "likes": 9069,
          "replies": 139
        },
        {
          "commentId": "7695398374313181952",
          "text": "大爷本来输得心甘情愿,明白真相以后手…",
          "likes": 75774,
          "replies": 292
        }
      ]
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.036800",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 21

字段类型示例值
typestringvideoReport
videoIdstring7695225845299957035
urlstringhttps://www.douyin.com/video/7695225845299957035
titlestring史上最固执大爷-珍爱生命,远离牌桌6.0 #街头魔术 #魔术 #智斗 #反赌反诈
publishedAtstring2026-10-11T10:00:00Z
durationSecondsnumber774.34
playsnumber28711162
likesnumber636105
commentsnumber19060
sharesnumber296531
collectsnumber56982
interactionsnumber951696
interactionRatenumber0.0331
completionRatenumber0.1000405475
musicTitlestring@你***
authorIdstring<masked>
authorNicknamestring<masked>
authorFollowersstring<masked>
dailyTrendarray[{"date":"2026-10-11","plays":2427651,"validPlays":2105533,"…
retentionCurvearray[{"second":0,"likes":90834,"playsLost":15650242},{"second":7…
topCommentsarray[{"commentId":"7695389686109766449","text":"还是旺季每月百万流水的农家乐",…

参数 2

参数名类型必填说明示例
limitinteger否返回的记录条数,1 到 100。一次请求返回的条数不会超过这个数。5
videosarray是抖音视频 ID 或视频链接,例如 https://www.douyin.com/video/7695225845299957035。不支持 v.douyin.com 短链接。["7695225845299957035"]

翻页

这个接口一次请求就返回全部:要更多条就把 limit 调大(最多 100)。cursor 一直是 null。

一次请求花多少

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。

这个接口每条单独取,每取一条的最低收费是 $0.016429。

  • 1 条:最多 $0.0368
  • 20 条:最多 $0.736
  • 100 条:最多 $3.68

返回的 meta 里写着这次扣了多少(charged_usd)和还剩多少(balance_usd)。我们这边出错不收费。

常见问题

「视频报告」要传哪些参数?

必填:videos。另外都可以传 limit(1 到 100)。

一次请求最多返回多少条?

每次请求最多 100 条(limit 1 到 100)。每页最多 1 条,要 100 条时一次请求取 100 页。

能接着往后取吗?

不能。这个接口一次请求就把结果全部返回,回答里的 cursor 是 null。

怎么收费?

每条 详情记录 $0.0368。每页最低收费 $0.016429:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $3.68。

请求失败或者没有结果时怎么收费?

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。回答里的 meta 写着这次收了多少、余额还剩多少。