[中文]

用途:

获取 TikTok Shop 创作者账号橱窗中正在展示的商品列表。

可用于商品管理、数据分析、查看当前推广商品等场景。

备注:

仅适用于已开通橱窗功能的 TikTok Shop 创作者账号。

支持分页查询，通过 count 和 offset 控制数据量。

参数:

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

count: 每页返回商品数量，默认 20

offset: 分页偏移量，默认 0

proxy: 可选 HTTP 代理地址

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

返回内容说明:

products (List[Dict]): 商品列表，每项包含以下字段：

product_id (str): 商品ID

title (str): 商品标题

format_available_price (str): 商品展示价格（格式化后的字符串，如 $7.94）

seller_info (dict):

seller_id (str): 卖家ID

shop_name (str): 店铺名称

cover (dict): 主图信息

url_list (List[str]): 主图 URL 列表（300x300）

images (List[dict]): 图片列表

每张图片包含 url_list (原图 URL)

source (str): 商品来源渠道（如 Affiliate）

stock_status (int): 库存状态（1: 有货）

review_status (int): 审核状态（1: 通过）

affiliate_info (dict): 联盟佣金信息

commission_with_currency (str): 佣金金额（如 $0.95）

commission_rate (int): 佣金比例（如 1200 = 12%）

category_info (dict): 类目信息

name (str): 主分类名（如 Beauty & Personal Care）

示例请求体:

{
  "cookie": "your_cookie_string",
  "count": 20,
  "offset": 0
}

示例返回数据片段:

{
  "products": [
    {
      "product_id": "1730905148396180014",
      "title": "Car Paint Care Spray",
      "format_available_price": "$7.94",
      "seller_info": {
        "seller_id": "7496108716782225966",
        "shop_name": "moon moon shop shop"
      },
      "cover": {
        "url_list": [
          "https://example.com/xxx.jpg"
        ]
      },
      "images": [
        {
          "url_list": [
            "https://example.com/xxx.jpg"
          ]
        }
      ],
      "source": "Affiliate",
      "stock_status": 1,
      "review_status": 1,
      "affiliate_info": {
        "commission_with_currency": "$0.95",
        "commission_rate": 1200
      },
      "category_info": {
        "name": "Beauty & Personal Care"
      }
    }
  ]
}

[English]

Purpose:

Retrieve the list of products currently displayed in a TikTok Shop creator's showcase.

Useful for product management, analytics, and monitoring promoted items.

Notes:

Only available for TikTok creator accounts with the showcase feature enabled.

Supports pagination via count and offset.

Parameters:

cookie: User Cookie string for authentication

count: Number of products per page (default 20)

offset: Pagination offset (default 0)

proxy: Optional HTTP proxy address

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

Return Structure:

products (List[Dict]): List of showcased products, including:

product_id, title, format_available_price, seller_info, cover, images, source, stock_status, review_status, affiliate_info, category_info.

Example Request:

{
  "cookie": "your_cookie_string",
  "count": 20,
  "offset": 0
}

Example Response Snippet:

{
  "products": [
    {
      "product_id": "1730905148396180014",
      "title": "Car Paint Care Spray",
      "format_available_price": "$7.94",
      "seller_info": {
        "seller_id": "7496108716782225966",
        "shop_name": "moon moon shop shop"
      },
      "cover": {
        "url_list": [
          "https://example.com/xxx.jpg"
        ]
      },
      "images": [...],
      "source": "Affiliate",
      "stock_status": 1,
      "review_status": 1,
      "affiliate_info": {
        "commission_with_currency": "$0.95",
        "commission_rate": 1200
      },
      "category_info": {
        "name": "Beauty & Personal Care"
      }
    }
  ]
}

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",
    "count": 20,
    "offset": 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 Showcase Product List

[中文]#

用途:#

备注:#

参数:#

返回内容说明:#

示例请求体:#

示例返回数据片段:#

[English]#

Purpose:#

Notes:#

Parameters:#

Return Structure:#

Example Request:#

Example Response Snippet:#