douyin/creator-v2/item-watch-trend

Fetch item watch trend analysis

Purpose:

• Get Douyin item watch trend analysis data
• Understand user behavior patterns while watching the item
• Help creators optimize video content structure and pacing
• 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)
• analysis_type: Analysis type (optional, default is 1)
  • 1: Retention Analysis - Shows user retention at each time point
  • 2: Like Analysis - Shows user like behavior at each time point
  • 7: Bounce Analysis - Shows user bounce rate at each time point

Analysis Type Description:

• Retention Analysis (analysis_type=1):

  • Shows viewer retention rate at various video time points
  • Higher retention means more engaging content at that moment
  • Note: Data is more accurate when views exceed 200
  • Good for: Identifying which segments keep viewers watching

• Like Analysis (analysis_type=2):

  • Shows viewer like rate at various video time points
  • Higher like rate indicates particularly popular segments
  • Good for: Identifying segments that drive user engagement

• Bounce Analysis (analysis_type=7):

  • Shows viewer bounce rate at various video time points
  • High bounce rate indicates potential content issues
  • Good for: Identifying segments that cause viewers to leave

Return Data Description:

• analysis_trend: Trend analysis data
  • current_item: Data points for current item
    • key: Time point (format: mm:ss, e.g., "00:05" for 5 seconds)
    • value: Proportion at this time point (decimal between 0-1)
  • similar_author: Average data from similar authors (for comparison)
    • key: Time point
    • value: Average proportion at this time point

Data Value:

• Content Optimization: Identify key drop-off points
• Pacing Adjustment: Optimize video rhythm and flow
• Comparative Analysis: Compare with similar creators to find gaps
• A/B Testing: Test different content versions

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",
    "analysis_type": 1
}

{
    "analysis_trend": {
        "current_item": [
            {
                "key": "00:00",
                "value": 0.2653
            },
            {
                "key": "00:01",
                "value": 0.2653
            },
            {
                "key": "00:05",
                "value": 0.0272
            },
            {
                "key": "00:10",
                "value": 0.1429
            }
        ],
        "similar_author": [
            {
                "key": "00:00",
                "value": 0.1594
            },
            {
                "key": "00:01",
                "value": 0.2229
            }
        ]
    },
    "status_code": 0,
    "status_msg": ""
}

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