[中文]

用途:

获取 TikTok Shop 创作者账号在指定时间范围内的表现概览，包括收益、曝光、点击、成交等多维度数据。

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

备注:

此接口仅适用于已开通 TikTok Shop 功能的创作者账号。

数据按照时间粒度进行分段统计，可用于数据分析和趋势观察。

参数:

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

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

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

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

segments（分段数据列表）:

time_selector: 当前统计段的时间设置，包括周期、起止时间戳、时区、语言等

timed_stats: 每天/每段的详细数据，包含以下字段：

live_revenue.amount: 直播带货收益

video_revenue.amount: 视频带货收益

revenue.amount: 总收益（直播 + 视频）

base_revenue.amount: 基础收益

commission_estimated.amount: 预估佣金

alc_base_revenue.amount: ALC 模式下基础收益

overall_item_sold_cnt: 商品成交数

product_show_cnt: 商品展示次数

product_click_cnt: 商品点击次数

alc_pay_sku_order_cnt: ALC 成交订单数

meta.is_bound_shop: 是否绑定 TikTok 店铺

[English]

Purpose:

Retrieve performance overview of a TikTok Shop creator account within a specified date range, including metrics like revenue, exposure, clicks, and orders.

By default, it aggregates data from the month of start_date (e.g., if start_date is 2025-04-01, it retrieves data for the entire month of April).

Notes:

This API is only applicable to TikTok accounts that have TikTok Shop enabled.

Data is segmented by time granularity (daily/monthly), and can be used for performance analysis or trend monitoring.

Parameters:

cookie: User cookie string for authentication

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

proxy: Optional HTTP proxy address. Leave empty if not needed.

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

Response:

segments: List of data segments, each containing:

time_selector: Time settings for the segment, including period, timestamp range, timezone, and locale

timed_stats: Daily or interval-based statistics, including:

live_revenue.amount: Revenue from livestream sales

video_revenue.amount: Revenue from video sales

revenue.amount: Total revenue (live + video)

base_revenue.amount: Base revenue

commission_estimated.amount: Estimated commission

alc_base_revenue.amount: Base revenue under ALC model

overall_item_sold_cnt: Total items sold

product_show_cnt: Product exposure count

product_click_cnt: Product click count

alc_pay_sku_order_cnt: Orders under ALC model

meta.is_bound_shop: Whether the TikTok account is bound to a shop

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

string

optional

用户 Cookie 字符串/User Cookie String

Default:

Your_Cookie_String

proxy

Proxy

optional

可选 HTTP 代理地址/Optional HTTP Proxy Address

Any of

string

null

Default:

start_date

string

Start Date

optional

查询开始时间，如 '04-01-2025'/ Query Start Date, e.g. '04-01-2025'

Default:

04-01-2025

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

code

integer

Code

optional

HTTP status code | HTTP状态码

Default:

200

router

string

Router

optional

The endpoint that generated this response | 生成此响应的端点

Default:

params

Params

optional

The parameters used in the request | 请求中使用的参数

Default:

{}

data

Data

optional

The response data | 响应数据

Any of

null

Example

{
    "code": 200,
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取创作者账号概览/Get Creator Account Overview

[中文]

用途:

备注:

参数:

返回:

[English]

Purpose:

Notes:

Parameters:

Response:

Request

Request samples

Responses

获取创作者账号概览/Get Creator Account Overview

[中文]#

用途:#

备注:#

参数:#

返回:#

[English]#

Purpose:#

Notes:#

Parameters:#

Response:#

Request

Request samples

Responses

[中文]

用途:

备注:

参数:

返回:

[English]

Purpose:

Notes:

Parameters:

Response: