获取投稿分析概览/Fetch item analysis overview

[中文]

用途:

• 获取账号投稿作品的综合分析数据
• 包括不同体裁、垂类的投稿表现统计
• 此接口需要用户提供有效的抖音创作者平台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 接口获取）
• 注意：日期范围最多90天

返回数据说明:

• 包含不同体裁和垂类的投稿数据分析
• 播放量、点赞量、评论量、分享量等指标
• 不同体裁的内容表现对比

Cookie 获取方式:

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

[English]

Purpose:

• Get comprehensive analysis data for account submitted items
• Including submission performance statistics for 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)
• Note: Date range maximum 90 days

Return Data Description:

• Contains submission data analysis for different genres and verticals
• Metrics including views, likes, comments, shares, etc.
• Performance comparison of different genres

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": [1, 2, 3, 4, 5, 8],
    "primary_verticals": ["动物"]
}

体裁类型说明/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. 调用本接口获取投稿分析数据
4. 分析不同体裁和垂类的表现

数据解读/Data Interpretation:

• 可以看到不同体裁内容的表现差异
• 了解哪种体裁更受欢迎
• 分析垂类内容的表现趋势
• 优化内容创作方向

优化建议/Optimization Suggestions:

1. 体裁优化: 根据数据选择表现更好的体裁类型
2. 内容时长: 分析观众偏好的视频时长
3. 垂类聚焦: 专注于表现好的垂类领域
4. 内容多样化: 尝试不同体裁和垂类的组合
5. 发布策略: 根据不同体裁的表现调整发布频率

注意事项/Notes:

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

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