TikTok Shop

TikTok Shop Category Products

Products listed under a TikTok Shop category id, with exact prices — title, canonical URL, image, price (current, original, discount, savings, and the min/max across variants), rating, units sold, variant count, brand, shop, and promotion labels — plus a pagination cursor, as JSON. Take the category_id from TikTok Shop Categories; level 1 and level 2 ids both work. This endpoint and TikTok Shop Search are authoritative for price; the product detail endpoint returns null prices. Costs 1 credit per request.

POST/api/v1/tiktok-shop/category/products

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

category_idstringrequired

Category id from TikTok Shop Categories: 4 to 20 digits. Level 1 and level 2 ids both work.

Example: 601450

cursorstring

Opaque cursor from a previous response's next_cursor. Keep passing it while has_more is true. Page size is inconsistent upstream (15 to 20 products), so never assume a fixed page size or synthesize your own offset.

Example: eyJrIjoiY2F0ZWdvcnkiLCJvIjoyMCwiZiI6WyIxNzMy…

regionstringdefault:US

Marketplace region. Category listings are served for US and GB only. GB coverage is intermittent at the source: when it is unavailable the request answers 502 rather than pretending the category is empty.

Example: GB

US — United States
GB — United Kingdom, intermittent upstream

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok_shop.category_products(category_id="601450", region="US")
print(results)

Response

"category_id": "601450",

"next_cursor": "eyJrIjoiY2F0ZWdvcnkiLCJvIjoyMCwiZiI6WyIxNzMyMzQ3NDU0NzExMzA1MDgwIl19",

"has_more": true

"response_time": 2240,

"credits_used": 1,

"credits_remaining": 4814

}