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

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

GET

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

TikTok-Shop-Web-API

Last modified:2025-09-16 22:31:04

OperationId:fetch_products_by_category_id_api_v1_tiktok_shop_web_fetch_products_by_category_id_get

[中文]

用途:

根据商品分类ID获取该分类下的商品列表

可用于构建分类浏览功能

参数:

category_id: 分类ID (必填，从fetch_products_category_list接口获取)

region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)

重要提示:

由于接口风控原因，请务必将请求timeout设置为30秒

如遇到400错误代码，请重试请求3次

返回数据结构:

{
    "code": 0,
    "message": "success",
    "data": {
        "products": [                // 商品列表(最多20个)
            {
                "product_id": "xxx",
                "title": "商品标题",
                "image": "商品图片",
                "price": {},              // 价格信息
                "rating": {},             // 评分信息
                "sales": {}               // 销量信息
            }
        ]
    }
}

[English]

Purpose:

Get product list by category ID

Can be used to build category browsing feature

Parameters:

category_id: Category ID (required, from fetch_products_category_list API)

region: Region code (US/GB/SG/MY/PH/TH/VN/ID)

Important Notice:

Due to API rate limiting, please set request timeout to 30 seconds

If you encounter error code 400, please retry the request 3 times

Response Structure:

{
    "code": 0,
    "message": "success",
    "data": {
        "products": [                // Product list (up to 20)
            {
                "product_id": "xxx",
                "title": "Product title",
                "image": "Product image",
                "price": {},              // Price info
                "rating": {},             // Rating info
                "sales": {}               // Sales info
            }
        ]
    }
}

[示例/Example]

category_id = 963976
region = "US"

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.tikhub.io/api/v1/tiktok/shop/web/fetch_products_by_category_id?category_id=963976&region=US' \
--header 'Authorization: Bearer <token>'

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": "2025-09-16 03:14:36",
    "time_stamp": 1758017676,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

Modified at 2025-09-16 22:31:04

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

获取热卖商品列表/Get hot selling products list

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

[中文]#

用途:#

参数:#

重要提示:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Important Notice:#

Response Structure:#

[示例/Example]#