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:2026-04-22 19:46:01

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接口获取)

offset: 翻页偏移量 (默认0)

每页默认20个商品，每次请求增加20，当响应中的 hasMore 为true时可继续请求下一页，否则已到最后一页。

例如: 第1页offset=0，第2页offset=20，第3页offset=40，以此类推。

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)

offset: Offset for pagination (default 0)

Default 20 products per page, increase by 20 for each request. If hasMore in response is true, can request next page, otherwise reached last page.

Example: Page 1 offset=0, Page 2 offset=20, Page 3 offset=40, and so on.

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

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.tikhub.io/api/v1/tiktok/shop/web/fetch_products_by_category_id?category_id=963976&offset=0&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-04-22 19:46:01

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

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

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

[中文]#

用途:#

参数:#

重要提示:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Important Notice:#

Response Structure:#

[示例/Example]#