douyin/creator-v2/item-play-source

Fetch item play source statistics

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"
}

{
    "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": ""
}

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