抖音数据分析 · 达人营销

视频洞察

传入抖音视频链接或 ID,返回每个视频的播放和互动数据、对比基准的每日表现、观众画像和评论词云。

POST/v1/douyin-analytics/videoInsight

$0.0231每条

1,000 条
≈ $23.10
每取一条最低
$0.010149

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

在控制台里试

怎么发

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

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

返回什么

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

200 OK · 取数日期 2026-11-09
{
  "data": [
    {
      "type": "videoInsight",
      "videoId": "7699060466600938792",
      "url": "https://www.douyin.com/video/76990604…",
      "title": "深圳17岁高中生,入职硅谷顶尖团队!AI…",
      "authorId": "<masked>",
      "publishedAt": "2026-10-21T10:06:48Z",
      "durationSeconds": 274.716,
      "cover": "https://p26-star-fe-sign.byteimg.com/…",
      "plays": 1306423,
      "likes": 34094,
      "comments": 1725,
      "favorites": 15310,
      "shares": 30545,
      "interactionRate": 0.0507,
      "performance": {
        "index": {
          "total": 997,
          "change": -35587,
          "daily": [
            {
              "date": "2026-11-02",
              "value": 224
            },
            {
              "date": "2026-11-03",
              "value": 188
            },
            {
              "date": "2026-11-04",
              "value": 130
            }
          ],
          "benchmarks": {
            "category": {
              "max": 1020251,
              "average": 10
            },
            "author": "<masked>",
            "duration": {
              "max": 7151360,
              "average": 35
            }
          }
        },
        "likes": {
          "total": 375,
          "change": -12311,
          "daily": [
            {
              "date": "2026-11-02",
              "value": 57
            },
            {
              "date": "2026-11-03",
              "value": 89
            },
            {
              "date": "2026-11-04",
              "value": 49
            }
          ],
          "benchmarks": {
            "category": {
              "max": 223672,
              "average": 4
            },
            "author": "<masked>",
            "duration": {
              "max": 2354462,
              "average": 14
            }
          }
        },
        "comments": {
          "total": 18,
          "change": -723,
          "daily": [
            {
              "date": "2026-11-02",
              "value": 4
            },
            {
              "date": "2026-11-03",
              "value": 5
            },
            {
              "date": "2026-11-04",
              "value": 5
            }
          ],
          "benchmarks": {
            "category": {
              "max": 32542,
              "average": 0
            },
            "author": "<masked>",
            "duration": {
              "max": 228267,
              "average": 1
            }
          }
        },
        "shares": {
          "total": 322,
          "change": -11375,
          "daily": [
            {
              "date": "2026-11-02",
              "value": 82
            },
            {
              "date": "2026-11-03",
              "value": 58
            },
            {
              "date": "2026-11-04",
              "value": 34
            }
          ],
          "benchmarks": {
            "category": {
              "max": 430393,
              "average": 1
            },
            "author": "<masked>",
            "duration": {
              "max": 3145016,
              "average": 7
            }
          }
        }
      },
      "audience": {
        "age": [
          {
            "name": "18-23",
            "share": 0.2477,
            "index": 194.21725887826508
          },
          {
            "name": "24-30",
            "share": 0.1968,
            "index": 107.58465871343508
          },
          {
            "name": "31-40",
            "share": 0.302,
            "index": 102.68884804808813
          }
        ],
        "gender": "<masked>",
        "province": [
          {
            "name": "北京",
            "share": 0.0307,
            "index": 156.39453078809862
          },
          {
            "name": "天津",
            "share": 0.0141,
            "index": 128.73660790294613
          },
          {
            "name": "河北",
            "share": 0.0249,
            "index": 55.44710711224481
          }
        ],
        "city": [
          {
            "name": "深圳",
            "share": 0.1176,
            "index": 667.181164572352
          },
          {
            "name": "上海",
            "share": 0.0406,
            "index": 190.97627339146825
          },
          {
            "name": "北京",
            "share": 0.0307,
            "index": 157.12755454914736
          }
        ],
        "yuntu_city_level": [
          {
            "name": "一线城市",
            "share": 0.2143439282803586,
            "index": 267.4056720124235
          },
          {
            "name": "新一线城市",
            "share": 0.21026894865525672,
            "index": 114.58054396862434
          },
          {
            "name": "二线城市",
            "share": 0.17603911980440098,
            "index": 96.70659906681311
          }
        ],
        "douyin_interest_category": [
          {
            "name": "时尚",
            "share": 0.13202933985330073,
            "index": 155.08578345282768
          },
          {
            "name": "美食",
            "share": 0.08475957620211899,
            "index": 130.9202109647606
          },
          {
            "name": "文化教育",
            "share": 0.05297473512632437,
            "index": 139.29237659299562
          }
        ],
        "province_city": [
          {
            "name": "上海",
            "share": 1,
            "index": 100
          },
          {
            "name": "北京",
            "share": 1,
            "index": 100
          },
          {
            "name": "重庆",
            "share": 1,
            "index": 100
          }
        ]
      },
      "interpretation": {
        "video": {
          "plays": 218,
          "interactions": 708,
          "followerGrowth": 70
        },
        "category": {
          "plays": 38,
          "interactions": 27,
          "followerGrowth": 7
        },
        "rank": {
          "plays": {
            "score": 218,
            "percentile": 98.5885,
            "level": 0
          },
          "interactions": {
            "score": 708,
            "percentile": 99.6499,
            "level": 0
          },
          "followerGrowth": {
            "score": 70,
            "percentile": 98.9538,
            "level": 0
          }
        }
      },
      "likesTrendHourly": [
        {
          "time": "2026-10-21T18:00:00+08:00",
          "likes": 14
        },
        {
          "time": "2026-10-21T19:00:00+08:00",
          "likes": 37
        },
        {
          "time": "2026-10-21T20:00:00+08:00",
          "likes": 57
        }
      ],
      "likerProvinces": [
        {
          "name": "<masked>",
          "share": 0.26621160409556316,
          "index": 237.60407363045624
        },
        {
          "name": "<masked>",
          "share": 0.06783276450511945,
          "index": 106.28762849438961
        },
        {
          "name": "<masked>",
          "share": 0.060580204778156996,
          "index": 84.0574507814028
        }
      ],
      "commentWords": [
        {
          "word": "普通人",
          "weight": 11
        },
        {
          "word": "家庭",
          "weight": 10
        },
        {
          "word": "贝赛思",
          "weight": 10
        }
      ]
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.023100",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 20

字段类型示例值
typestringvideoInsight
videoIdstring7699060466600938792
urlstringhttps://www.douyin.com/video/7699060466600938792
titlestring深圳17岁高中生,入职硅谷顶尖团队!AI公司疯抢00、10后 #陈广宇 #Kimi月之暗面 #AI智能 #AI行业…
authorIdstring<masked>
publishedAtstring2026-10-21T10:06:48Z
durationSecondsnumber274.716
coverstringhttps://p26-star-fe-sign.byteimg.com/tos-cn-i-dy/7474f5366e2…
playsnumber1306423
likesnumber34094
commentsnumber1725
favoritesnumber15310
sharesnumber30545
interactionRatenumber0.0507
performanceobject{"index":{"total":997,"change":-35587,"daily":[{"date":"2026…
audienceobject{"age":[{"name":"18-23","share":0.2477,"index":194.217258878…
interpretationobject{"video":{"plays":218,"interactions":708,"followerGrowth":70…
likesTrendHourlyarray[{"time":"2026-10-21T18:00:00+08:00","likes":14},{"time":"20…
likerProvincesarray[{"name":"<masked>","share":0.26621160409556316,"index":237.…
commentWordsarray[{"word":"普通人","weight":11},{"word":"家庭","weight":10},{"word…

参数 2

参数名类型必填说明示例
limitinteger否返回多少条记录,1 到 100。一次请求返回的条数不会超过这个数。5
videosarray是抖音视频链接(https://www.douyin.com/video/...)或视频 ID(长数字)。不支持分享短链。近几周内受到关注的视频效果最好;过旧或未知的视频返回空。["7699060466600938792"]

翻页

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

一次请求花多少

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

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

  • 1 条:最多 $0.0231
  • 20 条:最多 $0.462
  • 100 条:最多 $2.31

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

常见问题

「视频洞察」要传哪些参数?

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

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

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

能接着往后取吗?

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

怎么收费?

每条 分析记录 $0.0231。每页最低收费 $0.010149:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $2.31。

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

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