TikTok Shop Seller Products Scraper

The Actor collects one TikTok Shop seller's product catalog by seller_id and region, straight from the seller's storefront. Each record carries title, price, rating, sold count, brand, and product variants for one listing.

{
  "seller_id": "7495516049083828882",
  "region": "US",
  "maxItems": 100,
  "enrichProductDetails": false
}

Accepted input

seller_id accepts either the bare numeric ID or a shop page URL and is required. region is US only. Seller storefront pages exist on TikTok's US storefront alone — other storefronts return nothing — so no other region is offered here. maxItems defaults to 100 and bounds the number of products saved; 0 removes the bound. enrichProductDetails defaults to false and is described under Full product detail below.

Result fields

product_id and title identify the row. image, image_url, and transparent_image carry the product image in TikTok's raw object form, a convenience first URL, and a transparent-background variant when one exists. product_price_info, rate_info, and sold_info carry the formatted price, star score and review count, and units sold. brand_info names the product's brand when TikTok records one, and sku_info lists every purchasable variant with its own SKU ID and price.

{
  "product_id": "1730890193353609874",
  "title": "Colossal Bubble Mascara, get Buildable Volume and Length for Bold, Separated Lashes, for 24HR, Maybelline New York",
  "product_price_info": { "currency_name": "USD", "sale_price_format": "12.99" },
  "rate_info": { "score": 4.3, "review_count": "64013" },
  "sold_info": { "sold_count": 628436 },
  "brand_info": { "brand_name": "Maybelline New York" }
}

This is a trimmed, live-verified result from the Maybelline New York storefront; product_price_info and sku_info each carry more fields than shown here.

Full product detail

A storefront row carries what the product card shows. The description, the complete variant matrix, the shop's own profile and a page of reviews with the star breakdown only exist on the product's own page. Set enrichProductDetails to true and each saved row gains product_info, shop_info, review_info, categories, promotion_tag, and the whole product_detail record, plus the product's real name and seller_id.

It costs one extra request per product, so a 500-product catalog is 500 extra requests — leave it off for a first pass, then re-run with it on for the products worth the detail. A product whose detail page cannot be read keeps its storefront row and is not charged for.

How much of a catalog you get

Most storefronts come back in a single request: the Actor asks for as many products as maxItems wants, up to 150 at a time, and a shop whose catalog fits inside that reports has_more: false and is done.

Past 150 there is no way to page further. TikTok stops handing out a way to go further. The Actor asks again instead: already-seen product_ids are never saved twice within a run, and the run stops once two requests in a row add nothing new rather than repeating indefinitely. A very large catalog can therefore come back partial.

Related Actors

For the seller's profile alone — name, rating, and follower counts — without the full catalog, use the TikTok Shop Seller Info Scraper; the two share the same seller_id input. For a single product's full detail, use the TikTok Shop Product Scraper. For a keyword search or a category browse across many sellers, use the TikTok Shop Search Scraper or the TikTok Shop Category Products Scraper.