[中文]

用途:

获取 TikTok Shop 创作者账号在指定时间范围内的直播表现数据概览。

默认统计从 start_date 当月起 1 个自然月（如传入 2025-04-01，则统计整个 4 月的数据）。

返回内容说明:

segments（分段数据列表）:

time_selector: 时间范围设置（周期、起止时间戳、时区、语言）

filter.creator_id: 创作者 ID

timed_stats: 每个时间段（通常按日或月分段）的直播表现数据，包含：

live_revenue.amount: 直播带货收入

live_show_gpm.amount: 直播场均带货收入

new_follower_cnt: 新增粉丝数量

sku_order_paid_cnt: 已付款 SKU 数量

item_sold_cnt: 成交商品件数

product_view: 商品曝光次数（浏览量）

product_click: 商品点击次数

live_pay_order_ucnt: 直播支付订单人数

live_ctr: 直播点击率（Click-Through Rate）

live_co: 直播转化率（Conversion Rate）

live_like_cnt: 直播点赞次数

live_comment_cnt: 直播评论次数

live_show_cnt: 直播场次

live_watch_cnt: 直播观看人数

备注:

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

直播期间数据按自然日拆分。

参数:

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

start_date: 查询开始时间（格式 MM-DD-YYYY），如 04-01-2025

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

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

创作者账号直播数据概览

[English]

Purpose:

Retrieve a summary of live streaming performance for a TikTok Shop creator account within a specified time range.

By default, it covers one full calendar month starting from the provided start_date (e.g., input 04-01-2025 will fetch data for the entire April 2025).

Response Fields:

segments (List of segmented data):

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

filter.creator_id: Creator ID

timed_stats: Live performance statistics per time segment, including:

live_revenue.amount: Live streaming revenue

live_show_gpm.amount: Average revenue per live show

new_follower_cnt: Number of new followers

sku_order_paid_cnt: Number of SKUs paid

item_sold_cnt: Number of items sold

product_view: Number of product views

product_click: Number of product clicks

live_pay_order_ucnt: Number of unique users who placed live orders

live_ctr: Live Click-Through Rate (CTR)

live_co: Live Conversion Rate (CO)

live_like_cnt: Number of live likes

live_comment_cnt: Number of live comments

live_show_cnt: Number of live sessions

live_watch_cnt: Number of live viewers

Notes:

This API is only applicable to TikTok Shop creator accounts.

Data is split by natural days during the live sessions.

Parameters:

cookie: User Cookie string for authentication

start_date: Query start date in the format MM-DD-YYYY, e.g., 04-01-2025

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

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

Return:

Creator live streaming performance overview

[示例/Example]

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

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"
}

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 Live Overview

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

获取创作者直播概览/Get Creator Live Overview

[中文]#

用途:#

返回内容说明:#

备注:#

参数:#

返回:#

[English]#

Purpose:#

Response Fields:#

Notes:#

Parameters:#

Return:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

返回内容说明:

备注:

参数:

返回:

[English]

Purpose:

Response Fields:

Notes:

Parameters:

Return:

[示例/Example]