TikTok Shop Seller Products Scraper

Pull one seller's entire TikTok Shop catalogue by seller ID — every product they list, with pagination handled for you and optional full detail on each one.

Point it at a competitor's shop and you get their whole range in one dataset: what they sell, at what price, and how much of it has moved.

Input

Field	Type	Default	What it does
seller_id	string	—	Required. The seller or shop ID whose catalogue you want.
region	enum	US	US, GB, SG, MY, PH, TH, VN, ID.
maxItems	integer	100	Caps how many products are saved. 0 means the whole catalogue.
addonProductDetails	boolean	false	Adds the detail fields below. One extra request per product.

{
  "seller_id": "8655572138322465518",
  "region": "US",
  "maxItems": 100,
  "addonProductDetails": false
}

Every product row from any of the search Actors carries a seller_id — that is where to get one.

Output

Eleven fields on every row:

Field	What it holds
product_id	TikTok Shop product ID
seller_id	Seller or shop ID
title	Product title
name	Product name, when available
price	Product price information
image	Primary product image URL
sold_count	Sales count
rating	Product rating
seller_info	Seller information returned alongside the listing
seo_url	Product SEO URL information
seller_product	The original listing wrapper, when the catalogue endpoint returns extra metadata

{
  "product_id": "1732432759321694958",
  "seller_id": "8655572138322465518",
  "title": "LEGO Classic Creative Bricks Box",
  "price": "$24.99",
  "sold_count": 4821,
  "rating": 4.8
}

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. Fields the upstream response omits come back null rather than being dropped, so the row shape stays stable across a catalogue.

It costs one extra request and one extra billed event per product, so on a 500-product shop that is 500 extra requests. Leave it off for a first pass, then re-run with it on for the products you actually care about.

Questions

Where do I find a seller ID? Every row from TikTok Shop Search Scraper or TikTok Shop Products Scraper has a seller_id. Search for a product the shop sells, take the seller_id off the result, feed it here.

Why did I get fewer products than the shop appears to list? The catalogue endpoint pages through a cursor and the run stops when TikTok reports no more pages, returns an empty page, or hands back a cursor identical to the previous one. That last case is the common one on large shops — TikTok stops advancing rather than saying it has finished. Set maxItems to 0 to take everything offered, but a very large catalogue can still come back partial.

What is seller_product and why is it sometimes missing? The catalogue endpoint sometimes wraps each product with extra listing metadata — shop-specific ordering, promotion state. When it does, the product itself is unwrapped into the normal fields and the original wrapper is kept whole in seller_product. When TikTok returns a bare product with no wrapper, the field is absent.

Does a failed detail lookup lose the product? No. Enrichment is per-product: a lookup that returns nothing leaves that row with its catalogue fields and no detail fields, the run carries on, and you are not charged for the empty lookup.

Can I pass a shop URL instead of a seller ID? No — this one takes the ID only. URLs are accepted by TikTok Shop Product Scraper, for products rather than shops.

Other TikTok Shop Actors

Actor	Use when
TikTok Shop Search Scraper	You are searching by keyword and want listing fields only
TikTok Shop Products Scraper	You are searching by keyword and want detail too
TikTok Shop Product Scraper	You already have one product ID or URL
TikTok Shop Category Products Scraper	You want a whole category, without a keyword
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