douyin/creator-v2/author-diagnosis

Fetch author diagnosis

Purpose:

• Get Douyin creator account diagnosis data and optimization suggestions
• Automatically analyze account performance for the past 7 days
• Provide assessment and improvement suggestions for key metrics
• Help creators understand account health and optimize content strategy
• This API requires valid Douyin Creator Platform Cookie
• Use POST method, Cookie transmitted in request body, more secure
• No need to specify time range, system automatically fetches data for past 7 days

Request Body Parameters:

• cookie: User's Douyin Creator Platform Cookie (required)

Data Update Time:

• Update Cycle: Yesterday's video data is updated at 12:00 noon the next day
• Example: Video data from October 10, 2025 will be updated at 12:00 on October 11, 2025
• Time Range: Automatically fetches data for the past 7 days
• First Use: Data generation starts from the next day after obtaining permission

Data Metrics Definition:

Term Definitions:

• Similar Creators: Creators with similar creation fields or fan levels
• Time Granularity: The period for data update calculations
• Douyin Featured: Data performance including Featured APP + Douyin Desktop + Douyin APP Featured Tab

Account Diagnosis Metrics:

• Submission Count: Number of works published during the statistical period
• Engagement Index: Comprehensive score of views, likes, comments, and shares
• Video Views: Number of times the work has been viewed
• Video Completion Rate: Proportion of complete playbacks
  • Daily completion rate: Ratio of daily complete views to total views
  • 10-minute completion rate: Ratio of cumulative complete views to cumulative views
• Net Fan Growth: Net increase in account followers (new followers minus unfollowers)

Return Data Description: Account diagnosis data including five core dimensions:

1. Engagement Index (Interact):

• OwnValue: Account's own engagement index value (comprehensive score of views, likes, comments, shares)
• SimilarCount: Total number of similar creators
• AuthorRank: Ranking percentile in account's historical data (0-1, higher means better current performance)
• SimilarRank: Ranking percentile among similar creators (0-1, higher means better ranking)
• SimilarValue: Average engagement index value of similar creators
• Interpretation: AuthorRank=0.26 means current engagement exceeds 26% of own history
• Interpretation: SimilarRank=0.52 means ranking exceeds 52% of similar creators

2. Net Fan Growth (NewFans):

• OwnValue: Net increase in followers during the period (new followers - unfollowers)
• SimilarCount: Total number of similar creators
• AuthorRank: Ranking percentile in account's historical fan growth data
• SimilarRank: Fan growth ranking percentile among similar creators
• SimilarValue: Average net fan growth of similar creators
• Interpretation: OwnValue=2 means net gain of 2 followers in this period

3. Video Views (PlayCnt):

• OwnValue: Total number of times works were viewed during the period
• SimilarCount: Total number of similar creators
• AuthorRank: Ranking percentile in account's historical view count
• SimilarRank: View count ranking percentile among similar creators
• SimilarValue: Average view count of similar creators
• Interpretation: OwnValue=192 means total views of 192 in this period

4. Video Completion Rate (PlayFinishRatio):

• OwnValue: Proportion of complete playbacks (decimal between 0-1)
• SimilarCount: Total number of similar creators
• AuthorRank: Ranking percentile in account's historical completion rate
• SimilarRank: Completion rate ranking percentile among similar creators
• SimilarValue: Average completion rate of similar creators
• Interpretation: OwnValue=0.15 means 15% completion rate
• Tip: Focus on first 3 seconds to improve retention

5. Publishing Activity (PublishActivation):

• OwnValue: Number of works published during the period
• SimilarCount: Total number of similar creators
• AuthorRank: Ranking percentile in account's historical publishing data
• SimilarRank: Publishing activity ranking percentile among similar creators
• SimilarValue: Average number of submissions by similar creators
• Interpretation: OwnValue=2 means published 2 works in this period

Return Data Structure Example:

{
    "code": 0,
    "data": {
        "Interact": {
            "OwnValue": 0.0052,
            "SimilarCount": 1494654282,
            "AuthorRank": 0.2633,
            "SimilarRank": 0.5169,
            "SimilarValue": 0.0909
        },
        "NewFans": {
            "OwnValue": 2,
            "AuthorRank": 0.7924,
            "SimilarRank": 0.6343
        },
        "PlayCnt": {
            "OwnValue": 192,
            "AuthorRank": 0.8427,
            "SimilarRank": 0.5132
        },
        "PlayFinishRatio": {
            "OwnValue": 0.1545,
            "AuthorRank": 0.3851,
            "SimilarRank": 0.5086
        },
        "PublishActivation": {
            "OwnValue": 2,
            "AuthorRank": 0.7345,
            "SimilarRank": 0.5675
        }
    }
}

Data Interpretation Tips:

• OwnValue: Check actual values to understand current account performance
• AuthorRank: Compare with own past, higher value means better current status
• SimilarRank: Compare with peers, higher value means better ranking among similar creators
• Recommendation: Focus on optimizing metrics when both AuthorRank and SimilarRank are below 0.5

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. Copy the Cookie header value

[Example]

{
    "cookie": "Your_Cookie_Here"
}

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