--- title: "获取作品的统计数据/Get video metrics" method: GET path: "/api/v1/tiktok/analytics/fetch_video_metrics" tags: ["TikTok-Analytics-API"] --- # 获取作品的统计数据/Get video metrics `GET /api/v1/tiktok/analytics/fetch_video_metrics` ## 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/analytics/fetch_video_metrics` - Auth: HTTP bearer # [中文] ### 用途: - 获取TikTok视频的详细统计数据，包括观看量、点赞数、评论数和收藏数等核心指标 - 提供总量统计以及从发布日期起14天的每日趋势数据，便于分析视频表现 - 帮助创作者分析内容效果，评估用户互动情况，优化内容策略 ### 参数: - item_id: 视频作品ID，必填参数，可从视频分享链接或TikTok Studio获取 ### 返回内容说明: - `item_id`: 请求的视频ID - `video_views`: 视频总观看次数 - `value`: 观看次数数值 - `video_views_14_days`: 近14天的每日观看量趋势数据 - `interval`: 数据间隔类型 - `value`: 每日数据列表 - `likes`: 视频总点赞数 - `value`: 点赞数值 - `likes_14_days`: 近14天的每日点赞数趋势数据 - `comments`: 视频总评论数 - `value`: 评论数值 - `comments_14_days`: 近14天的每日评论数趋势数据 - `favorites`: 视频总收藏数 - `value`: 收藏数值 - `favorites_14_days`: 近14天的每日收藏数趋势数据 - `video_summary`: 视频表现的概览分析 - `title`: 概览标题 - `content`: 概览内容 - `summary_type`: 概览类型 ### 示例响应: ```json { "code": 200, "router": "/api/v1/tiktok/analytics/fetch_video_metrics", "params": { "item_id": "7502551047378832671" }, "data": { "item_id": "7502551047378832671", "video_views": { "value": 1555500 }, "likes": { "value": 11571 }, "comments": { "value": 6920 }, "favorites": { "value": 1243 }, "video_summary": { "title": "Overview", "content": "This post received more comments per view than most other posts." } } } ``` # [English] ### Purpose: - Retrieve detailed analytics data for TikTok videos, including views, likes, comments, and favorites - Provide total statistics and daily trends for 14 days since the release date, facilitating video performance analysis - Help creators analyze content effectiveness, evaluate user engagement, and optimize content strategy ### Parameters: - item_id: Video ID, required parameter, can be obtained from video sharing links or TikTok Studio ### Return Description: - `item_id`: The requested video ID - `video_views`: Total number of video views - `value`: View count value - `video_views_14_days`: Daily view trends for the past 14 days - `interval`: Data interval type - `value`: List of daily data - `likes`: Total number of likes on the video - `value`: Like count value - `likes_14_days`: Daily like trends for the past 14 days - `comments`: Total number of comments on the video - `value`: Comment count value - `comments_14_days`: Daily comment trends for the past 14 days - `favorites`: Total number of times the video was favorited - `value`: Favorite count value - `favorites_14_days`: Daily favorite trends for the past 14 days - `video_summary`: Overview analysis of video performance - `title`: Overview title - `content`: Overview content - `summary_type`: Overview type ### Example Response: ```json { "code": 200, "router": "/api/v1/tiktok/analytics/fetch_video_metrics", "params": { "item_id": "7502551047378832671" }, "data": { "item_id": "7502551047378832671", "video_views": { "value": 1555500 }, "likes": { "value": 11571 }, "comments": { "value": 6920 }, "favorites": { "value": 1243 }, "video_summary": { "title": "Overview", "content": "This post received more comments per view than most other posts." } } } ``` ## Query parameters - `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`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/analytics/fetch_video_metrics/get.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)