tiktok-shop/
category-products

Use the TikTok Shop Category Products API to list the products of a TikTok Shop category from its category ID and market, returning title, price and currency, units sold, rating, reviews and shop, up to 500 per call.

TikTok Shop Category Products API

Category ID input
9 markets
Up to 500 products
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
category_idRequiredNumeric category ID taken from the id field of TikTok Shop Categories, such as 601450.
regionOptionalMarket of the category: US, SG, MY, PH, TH, VN, ID, JP or MX. Defaults to US.
results_limitOptionalNumber 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.

  1. POST {"category_id": "601450", "region": "US", "results_limit": 30} to /v1/tiktok-shop/category-products.
  2. Poll GET /v1/tasks/{task_id}; the products are ready when status is succeeded.
  3. 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.

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.

Explore other platforms

Combine TikTok Shop data with public data from other supported social platforms.

TikTok Shop Category Products API — FAQ

TikTok Shop Category Products API is a programmatic interface for listing the products in one TikTok Shop category, identified by its category ID and market. It returns each product's title, description, price and currency, units sold, rating, review count, shop, images and page URL.

Run TikTok Shop Categories and copy the id of the category you want. IDs are made of digits only, such as 601450.

Any category ID from the tree is accepted. The example request in How to Use sends 601450, the top-level Beauty & Personal Care category, and a deeper ID focuses the list on one branch.

The TikTok Shop Category Products API charges 0.5 credits per product, so the default 30 products cost 15 credits and a full 500 cost 250.