[中文]

用途:

获取抖音创作者账号的诊断数据和优化建议

自动分析最近一周（从当天起往前7天）的账号表现

提供完播率、互动指数等关键指标的评估和改进建议

帮助创作者了解账号健康度，优化内容策略

此接口需要用户提供有效的抖音创作者平台Cookie

使用 POST 方法，Cookie 在请求体中传输，更安全

无需指定时间范围，系统自动获取最近7天数据

请求体参数:

cookie: 用户的抖音创作者平台Cookie（必填，在请求体中传输）

数据更新时间:

更新周期: 次日12点更新昨日作品数据

示例: 2025年10月10日的作品数据会在2025年10月11日12点更新

时间范围: 自动获取最近一周的数据（从当天起往前7天）

首次使用: 获取权限后次日起生产数据

数据指标含义:

名词定义:

同类创作者: 具有相似创作领域或粉丝量级的创作者

时间粒度: 时间粒度是数据更新计算的周期

抖音精选: 包含精选APP+抖音电脑端+抖音APP_精选Tab的数据表现

账号诊断类指标:

投稿数: 根据统计周期内发布的作品个数得出

互动指数: 作品的观看、点赞、评论、转发的综合得分

视频播放量: 作品被观看的次数

视频完播率: 作品完整播放次数的占比

每日完播率：当日完播浏览量与总浏览量的比值

每十分钟级完播率：累计完播浏览量与累计浏览量的比值

粉丝净增量: 账号净增粉丝数，通过涨粉数减去掉粉数得出

返回数据说明:

返回账号诊断数据，包括以下五个核心维度：

1. 互动指数 (Interact):

OwnValue: 账号自身的互动指数值（观看、点赞、评论、转发的综合得分）

SimilarCount: 同类创作者总数

AuthorRank: 账号在自身历史数据中的排名百分位（0-1之间，越大表示当前表现越好）

SimilarRank: 账号在同类创作者中的排名百分位（0-1之间，越大表示排名越靠前）

SimilarValue: 同类创作者的平均互动指数值

解读: AuthorRank=0.26表示当前互动指数超过了自己历史26%的时期

解读: SimilarRank=0.52表示在同类创作者中排名超过52%

2. 粉丝净增量 (NewFans):

OwnValue: 统计周期内账号净增粉丝数（涨粉数 - 掉粉数）

SimilarCount: 同类创作者总数

AuthorRank: 账号在自身历史涨粉数据中的排名百分位

SimilarRank: 账号在同类创作者中的涨粉排名百分位

SimilarValue: 同类创作者的平均粉丝净增量

解读: OwnValue=2表示本周期净增2个粉丝

3. 视频播放量 (PlayCnt):

OwnValue: 统计周期内作品被观看的总次数

SimilarCount: 同类创作者总数

AuthorRank: 账号在自身历史播放量中的排名百分位

SimilarRank: 账号在同类创作者中的播放量排名百分位

SimilarValue: 同类创作者的平均播放量

解读: OwnValue=192表示本周期总播放量为192次

4. 视频完播率 (PlayFinishRatio):

OwnValue: 作品完整播放次数的占比（0-1之间的小数）

SimilarCount: 同类创作者总数

AuthorRank: 账号在自身历史完播率中的排名百分位

SimilarRank: 账号在同类创作者中的完播率排名百分位

SimilarValue: 同类创作者的平均完播率

解读: OwnValue=0.15表示完播率为15%

提升建议: "想要作品吸引人，前3秒钟是关键，可以多分析同行业热门作品的人设、镜头技巧和音乐"

5. 投稿活跃度 (PublishActivation):

OwnValue: 统计周期内发布的作品个数

SimilarCount: 同类创作者总数

AuthorRank: 账号在自身历史投稿数据中的排名百分位

SimilarRank: 账号在同类创作者中的投稿活跃度排名百分位

SimilarValue: 同类创作者的平均投稿数

解读: OwnValue=2表示本周期发布了2个作品

返回数据结构示例:

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

数据解读技巧:

OwnValue: 查看实际数值，了解账号当前表现

AuthorRank: 与自己过去比较，数值越高说明当前状态越好

SimilarRank: 与同行比较，数值越高说明在同类创作者中排名越靠前

建议: AuthorRank和SimilarRank都低于0.5时需要重点优化该项指标

登录抖音创作者平台 (https://creator.douyin.com)

打开浏览器开发者工具（F12）

切换到 Network 标签

刷新页面或进行操作

找到任意请求，复制 Cookie 请求头的值

[English]

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

Open browser developer tools (F12)

Switch to Network tab

Refresh page or perform operations

Copy the Cookie header value

[示例/Example]

{
    "cookie": "Your_Cookie_Here"
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取创作者账号诊断/Fetch author diagnosis

[中文]#

用途:#

请求体参数:#

数据更新时间:#

数据指标含义:#

返回数据说明:#

返回数据结构示例:#

数据解读技巧:#

Cookie 获取方式:#

[English]#

Purpose:#

Request Body Parameters:#

Data Update Time:#

Data Metrics Definition:#

Return Data Description:#

Return Data Structure Example:#

Data Interpretation Tips:#

How to get Cookie:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

请求体参数:

数据更新时间:

数据指标含义:

返回数据说明:

返回数据结构示例:

数据解读技巧:

Cookie 获取方式:

[English]

Purpose:

Request Body Parameters:

Data Update Time:

Data Metrics Definition:

Return Data Description:

Return Data Structure Example:

Data Interpretation Tips:

How to get Cookie:

[示例/Example]