[中文]

用途:

获取指定视频在 TikTok Shop 中关联展示的商品列表及其推广表现数据。

可用于分析每个视频挂载商品的数量、商品价格区间、商品跳转链接，以及商品销售和推广效果。

备注:

必须提供 item_ids（视频 ID 列表）。

时间范围默认使用 start_date 所在自然月。

支持单次查询多个视频，返回每个视频关联的所有商品信息及对应商品的推广数据。

参数:

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

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

item_ids: 视频 ID 列表，例如 ["7496499484705246507", "7496110433699482923"]

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

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

返回内容说明:

segments（分段数据列表）:

time_selector: 时间筛选信息（起止时间戳）

filter: 查询条件（视频 ID 列表）

timed_lists: 每个时间段下的视频商品关联列表

videoToProductsMap:

item_id: 视频 ID

products: 关联商品列表

id: 商品 ID

name: 商品名称

cover_image.thumb_url_list: 商品图片 URL 列表

product_detail_page_url: 商品跳转链接

price_min / price_max: 商品价格区间

stats:

product.id: 商品 ID

商品销售推广表现（如销量、点击率等）

示例请求体:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_ids": ["7496499484705246507", "7496110433699482923"]
}

[English]

Purpose:

Retrieve the list of products associated with specified videos on TikTok Shop, along with their promotional performance data.

Useful for analyzing the number of products linked to each video, the product price range, product detail page links, and sales performance metrics.

Notes:

Requires item_ids (list of video IDs).

The time range defaults to the calendar month of the specified start_date.

Supports querying multiple videos at once.

Return Description:

segments:

time_selector: Time filter information (start/end timestamps)

filter: Query conditions (video ID list)

timed_lists: Product list associated with videos in the selected time range

videoToProductsMap:

item_id: Video ID

products:

id: Product ID

name: Product name

cover_image.thumb_url_list: List of product image URLs

product_detail_page_url: Product detail page link

price_min / price_max: Price range

stats:

product.id: Product ID

Promotional performance metrics (e.g., sales volume, CTR)

Example Request Body:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_ids": ["7496499484705246507", "7496110433699482923"]
}

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_ids": [
        "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 Associated Product List

[中文]#

用途:#

备注:#

参数:#

返回内容说明:#

示例请求体:#

[English]#

Purpose:#

Notes:#

Return Description:#

Example Request Body:#