获取投稿表现数据/Fetch item analysis item performance

[中文]

用途:

• 获取投稿作品的表现数据，包括播放量、点赞量、评论量、分享量等指标
• 分析不同体裁和垂类的内容表现
• 此接口需要用户提供有效的抖音创作者平台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天

返回数据说明:

• 包含所选指标在不同体裁和垂类下的表现数据
• 趋势分析、对比数据等
• 帮助了解内容在各个维度的表现

Cookie 获取方式:

1. 登录抖音创作者平台 (https://creator.douyin.com)
2. 打开浏览器开发者工具（F12）
3. 切换到 Network 标签
4. 刷新页面或进行操作
5. 找到任意请求，复制 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

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",
    "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:

1. 先调用 fetch_item_analysis_involved_vertical 获取垂类标签
2. 使用返回的 primary_verticals 作为参数
3. 选择需要分析的指标类型 (metric_type)
4. 调用本接口获取投稿表现数据
5. 分析不同体裁和垂类的表现差异

数据解读/Data Interpretation:

• 播放量 (metric_type=1): 反映内容的曝光度和吸引力
• 点赞量 (metric_type=2): 反映内容的质量和受欢迎程度
• 评论量 (metric_type=3): 反映内容的互动性和话题性
• 分享量 (metric_type=4): 反映内容的传播力和价值

优化建议/Optimization Suggestions:

1. 播放量优化:

   • 优化标题和封面，提高点击率
   • 选择合适的发布时间
   • 利用热门话题和标签

2. 点赞量优化:

   • 提升内容质量，引发共鸣
   • 在视频中引导点赞
   • 创作有价值、有趣的内容

3. 评论量优化:

   • 设置互动话题，引导评论
   • 在评论区积极回复
   • 创作有争议或讨论性的内容

4. 分享量优化:

   • 创作有价值、实用的内容
   • 制作有趣、有共鸣的内容
   • 适当加入情感元素

5. 体裁选择:

   • 根据不同指标表现选择合适的体裁
   • 短视频适合快速传播
   • 中长视频适合深度内容
   • 图文适合知识分享

6. 垂类聚焦:

   • 专注于表现好的垂类
   • 分析垂类特点和受众偏好
   • 持续优化内容方向

注意事项/Notes:

• 日期格式必须为YYYYMMDD（8位数字）
• 时间跨度不能超过90天
• primary_verticals参数必须从 fetch_item_analysis_involved_vertical 接口获取
• 如果时间范围内无投稿，可能返回空数据
• genres参数可以自由组合，按需筛选体裁
• 不同metric_type展示不同维度的表现数据
• 建议结合多个指标综合分析内容表现
• 数据分析建议至少有7天以上的投稿数据

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