获取视频详细分段统计数据/Get Video Detailed Statistics

[中文]

用途:

• 获取指定 TikTok 视频在指定自然月内的详细分段统计数据。
• 支持按时间段（日/周/月）统计新粉丝、点赞、评论、分享、商品浏览、完播率等多维指标。
• 可用于深入分析单个视频在不同时间段的表现变化，优化内容策略和推广效果。

备注:

• 必须提供 item_id（视频 ID）。
• 时间范围基于 start_date 所在自然月。
• 若数据量大，返回的数据将按不同时间粒度分段统计（granularity=日/周/月）。

参数:

• cookie: 用户 Cookie 字符串（用于身份认证）
• start_date: 查询起始日期，格式为 'MM-DD-YYYY'，如 '04-01-2025'
• item_id: 视频 ID，例如 "7496499484705246507"
• proxy: 可选 HTTP 代理地址，如不使用可省略
  • 示例格式: http://username:password@host:port

返回内容说明:

• segments（数据分段列表）:
  • time_selector: 时间筛选条件（period, granularity, start_timestamp, end_timestamp）
  • filter: 查询条件（creator_id, item_id）
  • timed_stats: 按时间段返回的统计数据列表
    • start_timestamp: 开始时间戳
    • end_timestamp: 结束时间戳
    • stats:
      • creator_id: 创作者账号 ID
      • item_id: 视频 ID
      • new_follower_cnt: 新增粉丝数量
      • share_cnt: 分享次数
      • comment_cnt: 评论次数
      • like_cnt: 点赞次数
      • product_view_cnt: 商品浏览量
      • video_completion_rate: 视频完播率（字符串，0-1）

示例请求体:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507"
}

[English]

Purpose:

• Retrieve detailed segmented statistics for a specified TikTok video within a given calendar month.
• Supports analyzing new followers, likes, comments, shares, product views, and video completion rates across different time segments (daily/weekly/monthly).
• Useful for deeply analyzing the performance changes of a single video over time, optimizing content strategies and promotional outcomes.

Notes:

• Requires item_id (video ID).
• Time range is based on the calendar month of start_date.
• Large datasets will be automatically segmented based on granularity (daily/weekly/monthly).

Return Description:

• segments:
  • time_selector: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)
  • filter: Query conditions (creator_id, item_id)
  • timed_stats: Segmented statistics list
    • start_timestamp: Start timestamp
    • end_timestamp: End timestamp
    • stats:
      • creator_id: Creator ID
      • item_id: Video ID
      • new_follower_cnt: Number of new followers
      • share_cnt: Number of shares
      • comment_cnt: Number of comments
      • like_cnt: Number of likes
      • product_view_cnt: Number of product views
      • video_completion_rate: Video completion rate (string, range 0-1)

Example Request Body:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507"
}

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