[中文]

用途:

获取投稿作品的表现数据，包括播放量、点赞量、评论量、分享量等指标

分析不同体裁和垂类的内容表现

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

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

建议先调用 fetch_item_analysis_involved_vertical 接口获取垂类标签

请求体参数:

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

start_date: 开始日期，格式YYYYMMDD（必填）

end_date: 结束日期，格式YYYYMMDD（必填）

genres: 体裁类型列表（可选，默认包含所有体裁）

1: 1分钟以内视频

2: 1-3分钟视频

3: 3-5分钟视频

4: 5分钟以上视频

5: 图文

8: 长图文

primary_verticals: 垂类标签列表（必填，从 fetch_item_analysis_involved_vertical 接口获取）

metric_type: 指标类型（可选，默认为1）

1: 播放量 (Views)

2: 点赞量 (Likes)

3: 评论量 (Comments)

4: 分享量 (Shares)

注意：日期范围最多90天

返回数据说明:

包含所选指标在不同体裁和垂类下的表现数据

趋势分析、对比数据等

帮助了解内容在各个维度的表现

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

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

切换到 Network 标签

刷新页面或进行操作

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

[English]

Purpose:

Get performance data for submitted items, including views, likes, comments, shares, etc.

Analyze content performance across different genres and verticals

This API requires users to provide valid Douyin Creator Platform Cookie

Use POST method, Cookie is transmitted in request body, more secure

Recommend calling fetch_item_analysis_involved_vertical first to get vertical tags

Request Body Parameters:

cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)

start_date: Start date in YYYYMMDD format (required)

end_date: End date in YYYYMMDD format (required)

genres: Genre type list (optional, defaults to all genres)

1: Videos under 1 minute

2: 1-3 minute videos

3: 3-5 minute videos

4: Videos over 5 minutes

5: Photo posts

8: Long photo posts

primary_verticals: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)

metric_type: Metric type (optional, defaults to 1)

1: Views

2: Likes

3: Comments

4: Shares

Note: Date range maximum 90 days

Return Data Description:

Contains performance data for selected metrics across different genres and verticals

Trend analysis and comparison data

Helps understand content performance across various dimensions

Open browser developer tools (F12)

Switch to Network tab

Refresh page or perform operations

Find any request and copy the Cookie header value

[示例/Example]

{
    "cookie": "Your_Cookie_Here",
    "start_date": "20250713",
    "end_date": "20251011",
    "genres": [2, 3, 4, 5, 8],
    "primary_verticals": ["动物"],
    "metric_type": 1
}

指标类型说明/Metric Type Description:

metric_type=1 (播放量/Views): 查看作品的播放量表现

metric_type=2 (点赞量/Likes): 查看作品的点赞量表现

metric_type=3 (评论量/Comments): 查看作品的评论量表现

metric_type=4 (分享量/Shares): 查看作品的分享量表现

体裁类型说明/Genre Type Description:

1: 1分钟以内视频（短视频）- 快速吸引注意力

2: 1-3分钟视频（中短视频）- 平衡内容与时长

3: 3-5分钟视频（中视频）- 深度内容展示

4: 5分钟以上视频（长视频）- 完整故事叙述

5: 图文（图片+文字）- 静态内容展示

8: 长图文（多图片+长文字）- 深度图文内容

使用流程/Usage Flow:

先调用 fetch_item_analysis_involved_vertical 获取垂类标签

使用返回的 primary_verticals 作为参数

选择需要分析的指标类型 (metric_type)

调用本接口获取投稿表现数据

分析不同体裁和垂类的表现差异

数据解读/Data Interpretation:

播放量 (metric_type=1): 反映内容的曝光度和吸引力

点赞量 (metric_type=2): 反映内容的质量和受欢迎程度

评论量 (metric_type=3): 反映内容的互动性和话题性

分享量 (metric_type=4): 反映内容的传播力和价值

优化建议/Optimization Suggestions:

播放量优化:

优化标题和封面，提高点击率

选择合适的发布时间

利用热门话题和标签

点赞量优化:

提升内容质量，引发共鸣

在视频中引导点赞

创作有价值、有趣的内容

评论量优化:

设置互动话题，引导评论

在评论区积极回复

创作有争议或讨论性的内容

分享量优化:

创作有价值、实用的内容

制作有趣、有共鸣的内容

适当加入情感元素

体裁选择:

根据不同指标表现选择合适的体裁

短视频适合快速传播

中长视频适合深度内容

图文适合知识分享

垂类聚焦:

专注于表现好的垂类

分析垂类特点和受众偏好

持续优化内容方向

注意事项/Notes:

日期格式必须为YYYYMMDD（8位数字）

时间跨度不能超过90天

primary_verticals参数必须从 fetch_item_analysis_involved_vertical 接口获取

如果时间范围内无投稿，可能返回空数据

genres参数可以自由组合，按需筛选体裁

不同metric_type展示不同维度的表现数据

建议结合多个指标综合分析内容表现

数据分析建议至少有7天以上的投稿数据

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "cookie": "Your_Cookie_Here",
    "start_date": "20250713",
    "end_date": "20251011",
    "genres": [
        2,
        3,
        4,
        5,
        8
    ],
    "primary_verticals": [
        "动物"
    ],
    "metric_type": 1
}

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 item analysis item performance

[中文]#

用途:#

请求体参数:#

返回数据说明:#

Cookie 获取方式:#

[English]#

Purpose:#

Request Body Parameters:#

Return Data Description:#

How to get Cookie:#

[示例/Example]#

指标类型说明/Metric Type Description:#

体裁类型说明/Genre Type Description:#

使用流程/Usage Flow:#

数据解读/Data Interpretation:#

优化建议/Optimization Suggestions:#

注意事项/Notes:#