[中文]

用途:

获取 TikTok Shop 创作者账号在指定时间范围内发布的视频列表及其详细数据表现。

支持分页查询，每页返回指定时间段内的视频及其播放、成交等详细数据。

返回内容说明:

segments（分段数据列表）:

time_selector: 查询时间范围（起止时间戳、时区、语言等）

filter.creator_id: 创作者账号 ID

list_control:

rules: 列表排序规则（通常按发布时间降序）

next_pagination: 翻页信息（是否有更多页，当前页，总页数，总记录数）

timed_lists: 每个时间段内的视频数据，包括：

video_meta:

item_id: 视频 Item ID

name: 视频标题

publish_time: 视频发布时间（Unix 时间戳）

duration: 视频时长（秒）

video_play_info: 视频播放资源信息（封面图、播放链接等）

new_follower_cnt: 视频期间新增粉丝数

vv_cnt: 视频播放量

ctr: 商品点击率（Click Through Rate）

gmv.amount: 视频带货产生的总 GMV 金额

item_sold_cnt: 视频带动的商品售出数量

direct_gmv.amount: 直接带货 GMV

completion_rate: 视频观看完成率

备注:

此接口仅适用于 TikTok Shop 创作者账号。

数据按自然日或周分组，且每条视频数据对应一段时间内的统计值。

参数:

cookie: 用户 Cookie 字符串（用于身份认证）

start_date: 查询起始日期，格式为 'MM-DD-YYYY'，如 '04-01-2025'

page: 页码，默认为第一页 0

rules: 列表排序规则，默认按发布时间排序，可选值如下：

"VIDEO_LIST_PUBLISH_TIME"：按发布时间排序

"VIDEO_LIST_GMV"：按商品交易总额排序

"VIDEO_LIST_DIRECT_GMV"：按直接商品交易总额排序

"VIDEO_LIST_VV_CNT"：按观看人次数排序

"VIDEO_LIST_ITEM_SOLD_CNT"：按成交件数排序

"VIDEO_LIST_CTR"：按商品点击率排序

"VIDEO_LIST_COMPLETION_RATE"：按观看完播率排序

"VIDEO_LIST_LIKE_CNT"：按点赞数排序

"VIDEO_LIST_NEW_FOLLOWER_CNT"：按新增粉丝数排序

proxy: 可选 HTTP 代理地址，如不使用可省略

示例格式: http://username:password@host:port

创作者账号视频列表及详细分析数据

[English]

Purpose:

Retrieve a list of videos published by a TikTok Shop creator account within a specified time range, along with detailed performance metrics.

Supports pagination to fetch multiple pages of video records within the given time range.

Response Fields:

segments (List of segmented data):

time_selector: Time range settings (start/end timestamps, timezone, locale)

filter.creator_id: Creator account ID

list_control:

rules: List sorting rules (typically by publish time descending)

next_pagination: Pagination information (has more pages, current page, total pages, total records)

timed_lists: List of videos for each time range, including:

video_meta:

item_id: Video Item ID

name: Video title

publish_time: Video publish time (Unix timestamp)

duration: Video duration (seconds)

video_play_info: Video play resources (cover image, playback URL, etc.)

new_follower_cnt: Number of new followers during the video's period

vv_cnt: Video views count

ctr: Click Through Rate for associated products

gmv.amount: Gross Merchandise Value generated by the video

item_sold_cnt: Number of items sold due to the video

direct_gmv.amount: Direct GMV from the video

completion_rate: Video completion rate

Notes:

This API is only available for TikTok Shop creator accounts.

Data is grouped by natural day or week, and each video's stats represent the corresponding period.

Parameters:

cookie: User Cookie string for authentication

start_date: Query start date, formatted as 'MM-DD-YYYY', e.g., '04-01-2025'

page: Page number, default is the first page 0

rules: List sorting rules, default is by publish time. Available options:

"VIDEO_LIST_PUBLISH_TIME": Sort by video publish time

"VIDEO_LIST_GMV": Sort by gross merchandise value (GMV)

"VIDEO_LIST_DIRECT_GMV": Sort by direct GMV

"VIDEO_LIST_VV_CNT": Sort by video view count

"VIDEO_LIST_ITEM_SOLD_CNT": Sort by number of items sold

"VIDEO_LIST_CTR": Sort by click-through rate

"VIDEO_LIST_COMPLETION_RATE": Sort by video completion rate

"VIDEO_LIST_LIKE_CNT": Sort by number of likes

"VIDEO_LIST_NEW_FOLLOWER_CNT": Sort by number of new followers

proxy: Optional HTTP proxy address, can be omitted if not used

Example format: http://username:password@host:port

Return:

Detailed video list and performance analysis for the creator account

[示例/Example]

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "page": 0
}

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",
    "page": 0,
    "rules": "VIDEO_LIST_PUBLISH_TIME"
}

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 Creator Video List Analytics

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

获取创作者视频列表分析/Get Creator Video List Analytics

[中文]#

用途:#

返回内容说明:#

备注:#

参数:#

返回:#

[English]#

Purpose:#

Response Fields:#

Notes:#

Parameters:#

Return:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]