--- title: "获取视频详细分段统计数据/Get Video Detailed Statistics" method: POST path: "/api/v1/tiktok/creator/get_video_detailed_stats" tags: ["TikTok-Creator-API"] --- # 获取视频详细分段统计数据/Get Video Detailed Statistics `POST /api/v1/tiktok/creator/get_video_detailed_stats` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/tiktok/creator/get_video_detailed_stats` - Auth: HTTP bearer # [中文] ### 用途: - 获取指定 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） ### 示例请求体: ```json { "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: ```json { "cookie": "your_cookie", "start_date": "04-01-2025", "item_id": "7496499484705246507" } ``` ## Request body - GetVideoDetailedStatsRequest - `cookie` string: 用户 Cookie 字符串/User Cookie String - `proxy` string, nullable: 可选 HTTP 代理地址/Optional HTTP Proxy Address - `start_date` string: 查询开始时间，如 '04-01-2025'/ Query Start Date, e.g. '04-01-2025' - `item_id` string, required: 视频 ID/Video ID ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 11 info - added the optional property `cache_message` to the response with the `200` status - added the optional property `cache_message_zh` to the response with the `200` status - added the optional property `cache_url` to the response with the `200` status - added the optional property `docs` to the response with the `200` status - …7 more - **2025-05-16** `14d38e4b883a`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/creator/get_video_detailed_stats/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)