Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取商品分类列表/Get product category list

GET

https://api.tikhub.io/api/v1/tiktok/shop/web/fetch_products_category_list

TikTok-Shop-Web-API

Last modified:2026-10-07 09:04:04

OperationId:fetch_products_category_list_api_v1_tiktok_shop_web_fetch_products_category_list_get

[中文]

用途:

获取指定地区的商品分类树。

参数:

region: 商品或商家所在地区，US/SG/MY/PH/TH/VN/ID/JP/MX；GB、BR 暂不支持。

返回与使用说明:

响应 data 是分类节点数组，不是无包装的顶层数组。

每个节点包含 self（分类信息）和 children（子分类数组）；叶节点的 children 为空。

self.category_id 是字符串；分类数量与层级因地区而异。

返回数据结构:

以下为主要字段示意，省略通用响应字段和部分可选字段；具体字段以实际响应为准。

{
  "code": 200,
  "data": [
    {
      "self": {
        "category_id": "600000",
        "category_name": "Example category",
        "is_leaf": false
      },
      "children": [
        {
          "self": {
            "category_id": "600001",
            "category_name": "Example subcategory",
            "is_leaf": true
          },
          "children": []
        }
      ]
    }
  ]
}

[English]

Purpose:

Get the product category tree for the selected region.

Parameters:

region: Product or seller region, US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable.

Response and usage:

Response data is an array of category nodes, rather than an unwrapped top-level array.

Each node contains self (category information) and children (child categories); leaves have an empty children array.

self.category_id is a string; category count and depth vary by region.

Response Structure:

This example shows the main fields and omits common response fields and some optional fields. Use the fields present in the actual response.

{
  "code": 200,
  "data": [
    {
      "self": {
        "category_id": "600000",
        "category_name": "Example category",
        "is_leaf": false
      },
      "children": [
        {
          "self": {
            "category_id": "600001",
            "category_name": "Example subcategory",
            "is_leaf": true
          },
          "children": []
        }
      ]
    }
  ]
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tikhub.io/api/v1/tiktok/shop/web/fetch_products_category_list?region=US' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

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

Modified at 2026-10-07 09:04:04

搜索商品列表V2(移动端，仅 US)/Search products list V2 (Mobile, US only)

根据分类ID获取商品列表/Get products by category ID

获取商品分类列表/Get product category list

[中文]#

用途:#

参数:#

返回与使用说明:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Response and usage:#

Response Structure:#