[中文]

用途:

获取 TikTok Shop 创作者账号在指定时间范围内推广的商品列表及其销售数据分析。

支持按商品成交额、商品上架时间排序，可分页查询。

返回内容说明:

segments（分段数据列表）:

filter.creator_id: 创作者账号 ID

list_control:

rules: 列表排序规则（如按成交额、商品 ID 排序）

next_pagination: 翻页信息（是否还有更多页、下一页页码、总页数、总记录数）

timed_lists: 每个时间段内的商品数据，包括：

product:

id: 商品 ID

name: 商品标题

cover_image.thumb_url_list: 商品封面图列表

item_sold_cnt: 销售商品数量

revenue.amount: 该商品带来的总成交金额（GMV）

commission.amount: 该商品预估佣金收入

备注:

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

数据以自然月或自定义时间范围统计。

默认排序为成交额（GMV）从高到低。

参数:

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

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

end_date: 结束日期，格式为 'YYYY-MM-DD'，如 '2025-05-01'

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

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

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

创作者账号商品列表及商品销售分析数据

[English]

Purpose:

Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics.

Supports sorting by revenue or product publish time and allows pagination.

Response Fields:

segments (List of segmented data):

filter.creator_id: Creator account ID

list_control:

rules: Sorting rules (e.g., by revenue, by product ID)

next_pagination: Pagination info (has more pages, next page number, total pages, total records)

timed_lists: List of product statistics within each time range, including:

product:

id: Product ID

name: Product title

cover_image.thumb_url_list: List of product thumbnail URLs

item_sold_cnt: Number of items sold

revenue.amount: Total Gross Merchandise Value (GMV) generated by the product

commission.amount: Estimated commission income from the product

Notes:

This API is only available for TikTok Shop creator accounts.

Data is aggregated by natural month or the customized date range.

Default sorting is by GMV in descending order.

Parameters:

cookie: User Cookie string for authentication

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

end_date: End date, formatted as 'YYYY-MM-DD', e.g., '2025-05-01'

page: Page number, default is the first page 0

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

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

Return:

Creator product list and corresponding sales analytics data

[示例/Example]

{
  "cookie": "your_cookie",
  "start_date": "2025-04-01",
  "end_date": "2025-05-01",
  "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": "2025-04-01",
    "end_date": "2025-05-01",
    "page": 0
}

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 Product List Analytics

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

获取创作者商品列表分析/Get Creator Product List Analytics

[中文]#

用途:#

返回内容说明:#

备注:#

参数:#

返回:#

[English]#

Purpose:#

Response Fields:#

Notes:#

Parameters:#

Return:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]