怎么发
用 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"]}'import os, requests
response = requests.post(
"https://api.silklinedata.com/v1/douyin-analytics/videoInsight",
headers={"Authorization": "Bearer " + os.environ["SILKLINE_KEY"]},
json={
"limit": 5,
"videos": ["7699060466600938792"],
},
)
answer = response.json()
print(answer["data"], answer["meta"]["charged_usd"])const response = await fetch("https://api.silklinedata.com/v1/douyin-analytics/videoInsight", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SILKLINE_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"limit": 5,
"videos": [
"7699060466600938792"
]
}),
});
const { data, cursor, meta } = await response.json();
console.log(data, meta.charged_usd);返回什么
这是 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
| 字段 | 类型 | 示例值 |
|---|---|---|
| type | string | videoInsight |
| videoId | string | 7699060466600938792 |
| url | string | https://www.douyin.com/video/7699060466600938792 |
| title | string | 深圳17岁高中生,入职硅谷顶尖团队!AI公司疯抢00、10后 #陈广宇 #Kimi月之暗面 #AI智能 #AI行业… |
| authorId | string | <masked> |
| publishedAt | string | 2026-10-21T10:06:48Z |
| durationSeconds | number | 274.716 |
| cover | string | https://p26-star-fe-sign.byteimg.com/tos-cn-i-dy/7474f5366e2… |
| plays | number | 1306423 |
| likes | number | 34094 |
| comments | number | 1725 |
| favorites | number | 15310 |
| shares | number | 30545 |
| interactionRate | number | 0.0507 |
| performance | object | {"index":{"total":997,"change":-35587,"daily":[{"date":"2026… |
| audience | object | {"age":[{"name":"18-23","share":0.2477,"index":194.217258878… |
| interpretation | object | {"video":{"plays":218,"interactions":708,"followerGrowth":70… |
| likesTrendHourly | array | [{"time":"2026-10-21T18:00:00+08:00","likes":14},{"time":"20… |
| likerProvinces | array | [{"name":"<masked>","share":0.26621160409556316,"index":237.… |
| commentWords | array | [{"word":"普通人","weight":11},{"word":"家庭","weight":10},{"word… |
参数 2
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| limit | integer | 否 | 返回多少条记录,1 到 100。一次请求返回的条数不会超过这个数。 | 5 |
| videos | array | 是 | 抖音视频链接(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 写着这次收了多少、余额还剩多少。