[中文]

用途:

获取抖音作品的流量来源统计数据

流量来源统计了作品从不同途径播放的占比

若暂时没有看到某个渠道，说明对应渠道暂时没有播放

作品刚发布推荐页流量占比可能偏低，请等待系统推流

此接口需要用户提供有效的抖音创作者平台Cookie

使用 POST 方法，Cookie 在请求体中传输，更安全

请求体参数:

cookie: 用户的抖音创作者平台Cookie（必填，在请求体中传输）

item_id: 作品ID（必填）

返回数据说明:

play_source: 流量来源列表，包含各渠道的播放占比

key: 流量来源渠道标识

value: 当前占比（0-1之间的小数，如0.85表示85%）

history_difference: 与历史数据的差异

app_id: 应用ID

流量来源渠道说明:

homepage_hot: 推荐页（系统推荐流量）

familiar: 朋友页（关注的人、好友推荐）

search: 搜索（用户主动搜索）

homepage: 个人主页（访问主页观看）

message: 消息页（通过消息入口）

other: 其他（其他途径）

登录抖音创作者平台 (https://creator.douyin.com)

打开浏览器开发者工具（F12）

切换到 Network 标签

刷新页面或进行操作

找到任意请求，复制 Cookie 请求头的值

[English]

Purpose:

Get Douyin item play source statistics

Statistics of the proportion of item views from different sources

If a channel is not shown, it means there are no views from that channel yet

For newly published items, the recommended page traffic may be low initially, please wait for system distribution

This API requires users to provide valid Douyin Creator Platform Cookie

Use POST method, Cookie is transmitted in request body, more secure

Request Body Parameters:

cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)

item_id: Item ID (required)

Return Data Description:

play_source: List of traffic sources with play proportion for each channel

key: Traffic source channel identifier

value: Current proportion (decimal between 0-1, e.g., 0.85 means 85%)

history_difference: Difference from historical data

app_id: Application ID

Traffic Source Channel Description:

homepage_hot: Recommended page (system recommendation traffic)

familiar: Friends page (followed people, friend recommendations)

search: Search (user active search)

homepage: Personal homepage (views from homepage visits)

message: Message page (through message entry)

other: Other (other sources)

Open browser developer tools (F12)

Switch to Network tab

Refresh page or perform operations

Find any request and copy the Cookie header value

[示例/Example]

{
    "cookie": "Your_Cookie_Here",
    "item_id": "7559536212910853422"
}

返回数据示例/Response Example:

{
    "play_source": [
        {
            "app_id": 1128,
            "history_difference": 0.8543689320388349,
            "key": "homepage_hot",
            "value": 0.8543689320388349
        },
        {
            "app_id": 1128,
            "history_difference": 0.05825242718446602,
            "key": "familiar",
            "value": 0.05825242718446602
        },
        {
            "app_id": 1128,
            "history_difference": 0.04854368932038835,
            "key": "search",
            "value": 0.04854368932038835
        }
    ],
    "status_code": 0,
    "status_msg": ""
}

数据解读/Data Interpretation:

value 值表示该渠道的流量占比，例如 0.85 表示 85% 的流量来自该渠道

homepage_hot 占比高说明作品获得了较好的系统推荐

familiar 占比高说明作品在关注用户中传播较好

search 占比高说明作品搜索热度高

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "cookie": "Your_Cookie_Here",
    "item_id": "7559536212910853422"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取作品流量来源统计/Fetch item play source statistics

[中文]

用途:

请求体参数:

返回数据说明:

流量来源渠道说明:

[English]

Purpose:

Request Body Parameters:

Return Data Description:

Traffic Source Channel Description:

[示例/Example]

返回数据示例/Response Example:

数据解读/Data Interpretation:

Request

Request Code Samples

Responses

获取作品流量来源统计/Fetch item play source statistics

[中文]#

用途:#

请求体参数:#

返回数据说明:#

流量来源渠道说明:#

Cookie 获取方式:#

[English]#

Purpose:#

Request Body Parameters:#

Return Data Description:#

Traffic Source Channel Description:#

How to get Cookie:#

[示例/Example]#

返回数据示例/Response Example:#

数据解读/Data Interpretation:#

Request

Request Code Samples

Responses

[中文]

用途:

请求体参数:

返回数据说明:

流量来源渠道说明:

Cookie 获取方式:

[English]

Purpose:

Request Body Parameters:

Return Data Description:

Traffic Source Channel Description:

How to get Cookie:

[示例/Example]

返回数据示例/Response Example:

数据解读/Data Interpretation: