TikTok Shop Creator Videos Scraper

The Actor collects the creator and affiliate videos promoting one or many TikTok Shop products, with the creator behind each video and its play and like counts.

{
  "product_ids": [
    "https://shop.tiktok.com/us/pdp/1730927783781307026",
    "1729447567685489298"
  ],
  "region": "US"
}

Accepted input

product_ids is required and takes page links or bare product IDs, mixed freely in the same list. Each product is fetched separately; one that cannot be read is logged as a warning and skipped rather than ending the run. region is required and selects the storefront read — US, GB, SG, MY, PH, TH, or VN — which changes the products, prices, and currency returned, not only the display language. maxItems defaults to 100 and bounds the number of videos saved across the whole run; a value of 0 disables the bound.

Result fields

Each row is one video: item_id is the TikTok video ID, and product_id identifies the product it promotes, taken from the upstream response when present and falling back to the ID supplied in product_ids otherwise. video_title is the video's own caption, named apart from title because that field elsewhere carries the product's title, not the video's. video_url links directly to the video file, and cover_image_url is its thumbnail. duration is the video length in seconds. author_id, author_name, and author_avatar_url identify the creator who posted it. play_count and like_count are the video's engagement counts as TikTok reports them at fetch time. upload_time is when the video was posted, as an epoch string. ad_label is TikTok's paid-partnership label and is present only when the video carries one; a video with no paid-partnership disclosure omits it.

One request per product, no pagination

TikTok returns a product's entire creator video list in a single request; there is no further paging on this surface. maxItems therefore trims the combined list down to size rather than driving additional requests once a product's videos are in hand.

Products with no creator videos

Plenty of products carry no creator or affiliate videos at all. A product with none yields no rows and is not treated as an error; the run continues to the next product in product_ids.

Related Actors

For the people buying a product rather than the creators promoting it, use the TikTok Shop Reviews Scraper. For a product's full page — description, variants, seller profile, and reviews together — use the TikTok Shop Product Scraper. For the seller behind the product, use the TikTok Shop Seller Info Scraper.