TikTok Shop Category Products
TikTok Shop Category Products are the listings filed under one category of a market, each with its title, description, price and currency, units sold, rating, review count, shop and images. Pulled category by category, they reveal the price bands, best sellers and active shops of a vertical and how those differ from one subcategory to the next.
TikTok Shop Category Products API Features
- Browse by category ID instead of keywordcategory_id takes the numeric ID returned by TikTok Shop Categories, so a category's products are read directly without guessing search terms.
- Nine markets, US by defaultregion covers US, SG, MY, PH, TH, VN, ID, JP and MX and falls back to US when it is left out.
- Up to 500 products per categoryresults_limit runs from 1 to 500 with a default of 30, so one request can take a quick sample or a deep slice of a category.
- Commerce fields on every productEach TikTok Shop Category Products API row carries title, text, price with amount and currency, sold_count, rating, reviews_count, seller and media images, plus url for the product page.
TikTok Shop Category Products API Parameters
| Parameters | Required | Description |
|---|---|---|
category_id | Required | Numeric category ID taken from the id field of TikTok Shop Categories, such as 601450. |
region | Optional | Market of the category: US, SG, MY, PH, TH, VN, ID, JP or MX. Defaults to US. |
results_limit | Optional | Number of products to return, from 1 to 500. Defaults to 30. |
How to Use the TikTok Shop Category Products API
Take a category ID from TikTok Shop Categories, send it to the TikTok Shop Category Products API, and read the products under it.
- POST {"category_id": "601450", "region": "US", "results_limit": 30} to /v1/tiktok-shop/category-products.
- Poll GET /v1/tasks/{task_id}; the products are ready when status is succeeded.
- Read the products from results.items and, if has_more is true, request the next page with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id":"601450","region":"US","results_limit":30}'TikTok Shop Category Products API Use Cases
- Comparing price bands across subcategories: Run one request per child category and compare the spread of price.amount to see where each subcategory's products are priced.
- Tracking a category's best sellers: Re-run a category through the TikTok Shop Category Products API on a schedule and follow sold_count for each product id to find the listings that keep gaining units.
- Mapping the shops in a vertical: Group products by seller.id and seller.name to find the shops with the most listings and the highest sales in a category.
TikTok Shop Category Products API Pro Tips
- Use the same region the category ID was read from in TikTok Shop Categories, since every market has its own category tree.
- Store the category_id you sent next to each product you keep, because the category comes from your request rather than from a field on the product row.
- Key TikTok Shop Category Products API rows on id when merging several categories or repeated runs, so a product collected twice is counted once.
Related APIs
Beyond the TikTok Shop Category Products API, use these APIs when you need a different type of public TikTok Shop data.
- TikTok Shop Products API — Collect public products from one TikTok Shop store URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product API — Retrieve one public TikTok Shop product from a PDP URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product Reviews API — Collect public reviews for one TikTok Shop PDP URL with text, rating, reviewer, image, SKU, country, and purchase-context fields.
- TikTok Shop User Showcase API — Collect public showcase products for one TikTok username with price, seller, media, rating, review, sold-count, and regional context.
- TikTok Shop Hot Products API — Collect a TikTok Shop market's hot-selling products by region code, in ranking order, with price, currency, units sold, rating and shop.
- TikTok Shop Categories API — Retrieve the full category tree of a TikTok Shop market with category IDs, names, English slugs, levels, parents and paths.