[中文]

用途:

获取指定 TikTok 视频与指定商品关联的推广详细统计数据。

支持分析视频为商品带来的商品浏览量、点击量、销售量、订单量、商品收入、直接收入等多维度指标。

返回数据按时间段（日/周/月）分段统计，便于观察趋势变化。

备注:

必须同时提供 item_id（视频 ID）和 product_id（商品 ID）。

时间范围基于 start_date 所在自然月。

参数:

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

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

item_id: 视频 ID，例如 "7496499484705246507"

product_id: 商品 ID，例如 "1731050202505515549"

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

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

返回内容说明:

segments（数据分段列表）:

time_selector: 时间筛选参数（period, granularity, start_timestamp, end_timestamp）

filter: 查询条件（creator_id, item_id, product_id）

timed_stats: 按时间段分段的统计数据

start_timestamp: 时间段开始时间戳

end_timestamp: 时间段结束时间戳

stats:

item_id: 视频 ID

product_id: 商品 ID

product_revenue.amount_formatted: 商品产生的总收入（格式化字符串，如 "$100.00"）

product_revenue.amount: 商品产生的总收入（数值）

direct_revenue.amount_formatted: 直接成交产生的收入（格式化字符串）

product_sales_cnt: 商品销售数量

product_view_cnt: 商品浏览量

product_click_cnt: 商品点击量

order_cnt: 生成订单数量

示例请求体:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507",
  "product_id": "1731050202505515549"
}

[English]

Purpose:

Retrieve detailed promotional statistics between a specific TikTok video and a specific product.

Supports analyzing metrics such as product views, clicks, sales, order counts, product revenue, and direct revenue.

The data is segmented by time intervals (daily/weekly/monthly) to observe trends over time.

Notes:

Requires both item_id (video ID) and product_id (product ID).

The time range is based on the calendar month of the specified start_date.

Return Description:

segments:

time_selector: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)

filter: Query conditions (creator_id, item_id, product_id)

timed_stats: Segmented statistics list

start_timestamp: Start timestamp

end_timestamp: End timestamp

stats:

item_id: Video ID

product_id: Product ID

product_revenue.amount_formatted: Total product revenue (formatted string, e.g., "$100.00")

product_revenue.amount: Total product revenue (numeric)

direct_revenue.amount_formatted: Direct sales revenue (formatted string)

product_sales_cnt: Number of products sold

product_view_cnt: Number of product views

product_click_cnt: Number of product clicks

order_cnt: Number of orders created

Example Request Body:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507",
  "product_id": "1731050202505515549"
}

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",
    "product_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-Product Association Statistics

[中文]#

用途:#

备注:#

参数:#

返回内容说明:#

示例请求体:#

[English]#

Purpose:#

Notes:#

Return Description:#

Example Request Body:#