[中文]

用途:

获取指定 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"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "cookie": "Your_Cookie_String",
    "proxy": "string",
    "start_date": "04-01-2025",
    "item_id": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

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

[中文]#

用途:#

备注:#

参数:#

返回内容说明:#

示例请求体:#

[English]#

Purpose:#

Notes:#

Return Description:#

Example Request Body:#