TikTok Shop Scraper

Pull TikTok Shop products, sellers, reviews, categories, and trending items from one Actor. Give it a keyword, a product ID, a seller ID, or a category, and it returns structured rows — titles, prices, sold counts, ratings, review text, shop names, and performance data across eight regions: US, GB, SG, MY, PH, TH, VN, ID.

Modes

Set scraperType to pick what this run collects. Each mode takes its own identifier below the picker.

Mode	Returns	Needs	Or use the focused Actor
Search products	Products matching a keyword, full detail on request	keyword	TikTok Shop Products Scraper
Product detail	One product's full record: shop, reviews, vouchers, category	product_id and region	TikTok Shop Product Detail Scraper
Seller products	A seller's whole catalog	seller_id	TikTok Shop Seller Products Scraper
Product reviews	Every review for a product, filterable by rating or photos	product_id	TikTok Shop Reviews Scraper
Category products	Every product in a category	category (name or ID)	TikTok Shop Category Scraper
Trending products	What's trending right now, by region	region	TikTok Shop Trending Scraper
Shop info	A seller's storefront profile	seller_id	TikTok Shop Seller Info Scraper
Keyword ideas	Autocomplete suggestions for a seed keyword	keyword	TikTok Shop Keyword Ideas Scraper
Categories	The full category tree, flattened	region	TikTok Shop Categories Scraper

scraperType is the only field this Actor marks required. Every other field is mode-specific, and most modes catch a missing identifier for you with a plain error rather than an empty run: Shop Info stops with Add a TikTok Shop seller ID or shop link., Keyword Ideas with Add a search keyword to get suggestions for., Category Products with No TikTok Shop category matches "" in region US. Top-level categories are: ..., and Seller Products with Could not resolve "" to a TikTok Shop seller ID. Pass a shop share link, or the numeric seller ID directly. Region-only modes (Trending Products, Categories) default region to US, so they never hit a blank-identifier case in practice.

One Actor or nine?

Each of the nine modes above is also its own focused Actor, cheaper per result and scoped to a single lookup. Reach for a focused Actor once you know exactly which dataset you need at scale — a keyword search, one seller's catalog, one product's reviews. Reach for this Actor when a project spans several of those — sizing up a seller's catalog plus their reviews plus where they rank in a category, say — because that's one Actor integration instead of switching between several.

Input

{
  "scraperType": "searchProducts",
  "keyword": "wireless earbuds",
  "region": "US"
}

maxItems (default 100, 0 for no limit) caps every paginated mode. region defaults to US across the board; Product Detail is the one mode where it's paired with an ID rather than standing on its own, because the same product ID can serve different data per region. product_id (Product Detail, Product Reviews) and seller_id (Seller Products, Shop Info) each accept either the bare ID or a page link — a URL costs nothing extra for product_id, while a seller share link costs one visible extra request to resolve to a numeric ID.

addonProductDetails — "Add product, shop, review, voucher, category, and performance detail to every product found. This makes one extra request per product." — is available on Search Products, Seller Products, Category Products, and Trending Products; it's not on Product Detail, Product Reviews, Shop Info, Keyword Ideas, or Categories, since those either already return that detail or don't return products at all. A failed or empty enrichment leaves the base row intact and isn't billed.

Output

Field names vary by mode. Across the nine, the ones you'll see most are:

Field	Contents
product_id, seller_id, title, name	Product and seller identifiers
price, rating, sold_count, image	Listing basics (search mode)
product_price_info, rate_info, sold_info	Listing basics (seller/category/trending modes)
review_id, review_text, review_rating, reviewer_name, is_verified_purchase	Review data
category_id, category_name, category_level, parent_category_id	Category tree data
shop_profile	A seller's storefront record
product_detail, shop_info, reviews_info, vouchers, category_info, shop_performance	Present only when addonProductDetails is on, or on Product Detail's own full record

{
  "product_id": "1729384756102938475",
  "seller_id": "7048392010293847561",
  "name": "Wireless Earbuds Pro",
  "title": "Wireless Earbuds Pro - Noise Cancelling",
  "price": "$29.99",
  "sold_count": 15234,
  "rating": 4.6
}

Questions

Why does Product Detail need region when I already have a product_id? TikTok Shop keeps separate per-region catalogs, and the same numeric product ID can point to different listing data depending on which one you ask. Product Detail is the only mode that marks both product_id and region as required for exactly that reason — every other mode defaults region to US and lets you override it.

Category Products failed with "No TikTok Shop category matches ...". What do I pass? Either a category's exact name (e.g. "Beauty & Personal Care") or its numeric ID. A name is resolved against the region's live category tree first, which costs one extra request; an ID skips that lookup entirely. The error message itself lists the top-level categories available in the region you asked for, which is the fastest way to find a valid spelling.

How do I read a seller ID from a shop link instead of looking up the number? Pass the share link (vt.tiktok.com/...) or full shop URL directly into seller_id on Seller Products — it resolves to the numeric ID for you, at the cost of one extra visible request. Shop Info takes a plain numeric ID or link the same way, without that extra resolution step.

Product Reviews only returns 20 rows even though I set maxItems higher. Why? The reviews endpoint pages by a plain page number, 20 reviews per page, not a cursor — so raising maxItems does keep pulling further pages, but each one costs a full request regardless of how many rows it returns. A short final page (fewer than 20) is normal and doesn't mean the run stalled; watch has_more in the log, not the row count of any single page.

Categories returned fewer rows than the full tree. Why? maxItems defaults to 100. A region's full category tree can have more nodes than that, and the default silently caps the export short of the complete tree. Raise maxItems if you need every category.

Can I filter reviews by star rating or photos? Yes — Product Reviews takes reviewRating (all, or 5_star down to 1_star) and reviewFilter (no_filter, with_media, verified_purchase). Every row also carries the product's overall star-rating breakdown alongside its own rating, so a single row still tells you where it sits among the full review set.

What's the difference between "Search Products" here and the separate Search Scraper Actor? Both call the same product search behind the scenes. This Actor's Search Products mode and the TikTok Shop Products Scraper return the full field set and support addonProductDetails; the TikTok Shop Search Scraper trims the input and output down to the core listing fields only, with no detail add-on, for a cheaper run when that's all you need.

Related Actors

Actor	Purpose
TikTok Shop Products Scraper	Keyword search with full product detail
TikTok Shop Search Scraper	Keyword search, core fields only, no add-on
TikTok Shop Product Detail Scraper	One product's full record
TikTok Shop Seller Products Scraper	One seller's catalog
TikTok Shop Reviews Scraper	One product's reviews