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

[中文]

用途:

• 获取抖音作品的流量来源统计数据
• 流量来源统计了作品从不同途径播放的占比
• 若暂时没有看到某个渠道，说明对应渠道暂时没有播放
• 作品刚发布推荐页流量占比可能偏低，请等待系统推流
• 此接口需要用户提供有效的抖音创作者平台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: 其他（其他途径）

Cookie 获取方式:

1. 登录抖音创作者平台 (https://creator.douyin.com)
2. 打开浏览器开发者工具（F12）
3. 切换到 Network 标签
4. 刷新页面或进行操作
5. 找到任意请求，复制 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)

How to get Cookie:

1. Login to Douyin Creator Platform (https://creator.douyin.com)
2. Open browser developer tools (F12)
3. Switch to Network tab
4. Refresh page or perform operations
5. 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 占比高说明作品搜索热度高

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.