TikTok Shop Category Products Scraper

Browse a TikTok Shop category and export everything in it — prices, brands, variants, ratings, and sold counts — without needing a keyword.

Keyword search only finds what you already thought to ask for. A category is the whole shelf, including the products you would never have typed. Give it Beauty & Personal Care and you get the category as TikTok itself organises it.

Input

Field	Type	Default	What it does
category	string	—	Required. A category name, or a numeric category ID.
region	enum	US	US, GB, SG, MY, PH, TH, VN, ID.
maxItems	integer	100	Caps how many products are saved. 0 means no limit.
addonProductDetails	boolean	false	Adds the detail fields below. One extra request per product.

{
  "category": "Beauty & Personal Care",
  "region": "US",
  "maxItems": 100,
  "addonProductDetails": false
}

You don't need to look up an ID first. Type the name as you'd say it — Hand & Foot Care, hand-foot-care, or hand foot care all land on the same category. Punctuation and case don't matter. If you already have the numeric ID, pass that instead and it's used directly.

Names are matched against the live category tree, so a name that doesn't exist fails immediately with the list of top-level categories rather than running and returning nothing.

Output

One row per product.

Field	What it holds
product_id	TikTok Shop product ID
title	Product title
category_id	The category the row came from
category_name	That category's display name
image	Primary product image
product_price_info	Real price, original price, currency, discount
rate_info	Star score and review count
sold_info	Units sold
seller_info	Seller ID and shop name
brand_info	Brand, when TikTok records one
sku_info	Every purchasable variant with its own ID, price, and stock
product_marketing_info	Promotion and campaign labels on the listing
seo_url	Canonical product URL

{
  "product_id": "1732046166861714198",
  "title": "Portable Travel Hand Sanitizer Spray Set, 10-Piece",
  "category_id": "849032",
  "category_name": "Hand & Foot Care",
  "rate_info": { "score": 4.7, "review_count": "3" },
  "sold_info": { "sold_count": 27 },
  "brand_info": { "brand_name": "Clarins" }
}

brand_info, sku_info, and product_marketing_info don't come back from keyword search — they're specific to the category feed. That's the reason to use this Actor over TikTok Shop Search Scraper when you want variant-level or brand data.

With addonProductDetails enabled

Eight more fields are merged into each row — product_detail, product_info, shop_info, reviews_info, hot_reviews, vouchers, category_info, shop_performance. It costs one extra request and one extra billed event per product. Leave it off for a first pass, then re-run with it on for the products worth the spend.

What people use it for

• Find products you didn't know to search for. Category browsing surfaces the long tail; keyword search can't.
• Price a shelf. Every row carries product_price_info and sku_info, so you get the real spread across a category, variant by variant.
• See which brands hold a category. brand_info on every row, counted, is a share-of-shelf estimate.
• Spot what's selling. Sort on sold_info.sold_count and rate_info.review_count together — high sales with few reviews usually means the listing is new.

Questions

How do I find TikTok Shop products without a keyword? That's what this does. TikTok organises its catalogue as a tree — 28 top-level categories in the US, each with its own subcategories, around 240 in total. You name a category and get its products. Keyword search needs you to guess the wording; a category doesn't.

Why did I get fewer products than maxItems? The category ran out. Categories are finite and often smaller than they look — asking for 200 from Hand & Foot Care returns 162, because that's everything TikTok will serve for it. The run stops when TikTok reports no more pages. Setting maxItems: 0 takes everything available, which is the same number.

Why aren't all the products in a category showing up? TikTok's category feed doesn't expose a complete index. It pages through an offset and stops handing out new products well before the category is genuinely exhausted — the same behaviour you see scrolling the app, where the feed eventually stops. You get what the feed serves, which is a large sample, not a guaranteed census.

Do I get duplicate rows? No. The feed re-serves the same product at different offsets — a 120-row walk returned 117 distinct products before deduplication was added. Products already saved in a run are skipped, so every row in your dataset is a distinct product_id, and you're not billed for repeats.

What happens if I type a category name that doesn't exist? The run fails straight away with the list of valid top-level categories in your region, instead of quietly returning zero rows. Category names differ by region, so a name valid in US may not exist in GB.

Does using a name instead of an ID cost more? One extra request per run, once, to fetch the category tree. Passing a numeric ID skips it. On a 100-product run that's a rounding error, so use whichever is easier to read.

Which regions work? All eight — US, GB, SG, MY, PH, TH, VN, ID. The category tree is fetched per region, so IDs and names are resolved against the region you set, not against the US tree.

Other TikTok Shop Actors

Actor	Use when
TikTok Shop Search Scraper	You have a keyword and want listing fields only
TikTok Shop Products Scraper	You have a keyword and want full detail too
TikTok Shop Product Scraper	You already have one product ID or URL
TikTok Shop Seller Products Scraper	You want one shop's entire catalogue
TikTok Shop Reviews Scraper	You want what buyers said about a product

Support

Questions, bugs, or feature requests: contact@toolzerhub.com

Browse the rest: apify.com/toolzerhub