douyin/creator-v2/item-danmaku-analysis

Fetch item bullet analysis

Purpose:

• Get Douyin item bullet (danmaku) analysis data
• Understand audience bullet interaction at various video time points
• Help creators identify hot segments and audience reactions
• 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: Returns item bullet analysis data, including:

• bullet_distribution: Bullet distribution data
  • time_point: Time point (seconds)
  • count: Number of bullets at this time point
  • percentage: Percentage of bullets at this time point
• hot_words: Popular bullet words
  • word: Bullet word
  • count: Occurrence count
  • sentiment: Sentiment orientation (positive/negative/neutral)
• total_count: Total bullet count
• peak_time: Peak time point for bullets

Note: If empty data or zero bullets returned, it means there is currently no bullet data for this item, possible reasons:

• Item was just published and no viewers have sent bullets yet
• Item type is not suitable for bullet interaction
• Bullet feature is not enabled

Data Value:

• Hot Spot Identification: Identify video segments with highest audience interest
• Sentiment Analysis: Understand audience emotional reactions to content
• Interaction Optimization: Optimize content presentation in high-bullet areas
• Content Improvement: Adjust future content based on bullet feedback

Application Scenarios:

1. Content Optimization: Find favorite segments and reinforce similar content
2. Pacing Adjustment: Dense bullet areas indicate engaging content, extend similar segments
3. Emotion Control: Understand genuine audience reactions through bullet sentiment
4. Interaction Design: Design interactive elements at bullet peaks to boost engagement

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

{
    "bullet_distribution": [
        {
            "time_point": 5,
            "count": 328,
            "percentage": 15.2
        },
        {
            "time_point": 12,
            "count": 562,
            "percentage": 26.1
        },
        {
            "time_point": 18,
            "count": 445,
            "percentage": 20.6
        }
    ],
    "hot_words": [
        {
            "count": 156,
            "sentiment": "positive"
        },
        {
            "count": 98,
            "sentiment": "positive"
        },
        {
            "count": 76,
            "sentiment": "positive"
        }
    ],
    "total_count": 2156,
    "peak_time": 12,
    "status_code": 0,
    "status_msg": ""
}

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