List TikTok Shop category products (v2)
Returns products for category_id in the chosen region. The listing is a random sample: repeat calls return different products, so it is not a stable page. count (default 20, max 150) sets how many.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
category_id?|
Numeric TikTok Shop category ID, for example 601450.
region?string
TikTok Shop storefront to read from, such as US or GB. Results, pricing, and availability are region-specific.
Default
"US"Value in
- "US"
- "GB"
- "SG"
- "MY"
- "PH"
- "TH"
- "VN"
- "JP"
- "MX"
count?integer
How many products to return (1-150). Results are collected in pages of about 20, so larger values take longer to answer. Fewer may come back than asked for — the response's own has_more flag is the source of truth on whether more exist.
Range
1 <= value <= 150Default
20curl -X GET "https://example.com/v1/tiktok-shop/category/products" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "categoryInfo": { "property1": null, "property2": null }, "categoryProductsData": { "productList": [ { "product_id": "string", "property1": null, "property2": null } ], "categoryReviews": [ { "property1": null, "property2": null } ], "hasMore": true, "property1": null, "property2": null }, "property1": null, "property2": null }}