TikTok Shop Scraper (US)

Collect live product and seller data from TikTok Shop in the United States. Give it product links or product IDs, store links, or category links, and every product becomes one clean row: current price range, original price and discount, sold count, rating and review count, images, category path, and the shop behind it. Store and category links are expanded into their products automatically, following the page's own next-page data until your result cap is reached.

Only the United States is supported. Non-US links are rejected with a clear message rather than silently returning a different country's catalogue.

Quick Start

{
  "productUrls": [
    "https://shop.tiktok.com/us/pdp/catlink-automatic-cat-litter-box-open-x-app-control-ultra-quiet/1729481391627933425"
  ],
  "storeUrls": [
    "https://shop.tiktok.com/us/store/jetech-us-shop/7494525317462591244"
  ],
  "categoryUrls": [
    "https://shop.tiktok.com/us/c/bath-body-care/849160"
  ],
  "maxProducts": 100,
  "includeShopDetails": true
}

Product links can be full URLs or bare numeric IDs. Store and category links are expanded to their products.

Input

Input	Type	Default	Meaning
productUrls	array	[]	US product page links or numeric product IDs. One row per product.
storeUrls	array	[]	US store page links. Each store is expanded to its product list, following the page's own continuation.
categoryUrls	array	[]	US category page links. Each category is expanded to its product list the same way.
maxProducts	integer	100	Total cap on product rows across all sources, after de-duplication.
maxPages	integer	10	The number of listing pages read per expanded store or category, including the first.
includeShopDetails	boolean	false	When enabled, each expanded store's own summary (rating, sold count, follower count, product count and review count) is added to the run summary at OUTPUT.shops. Shop summaries are not dataset rows and are not charged.

What it returns

The dataset contains one row per product:

Field	Meaning
kind	product for every dataset row.
productId, url, title	Product identity and its canonical page link.
priceMin, priceMax, currency	Current price range at the SKU level.
originalPrice, discountPercent	Pre-discount price and discount, when the page publishes them.
soldCount	Units sold as shown on the page.
rating, reviewCount	Average product rating and number of reviews.
images	Product image links.
categoryPath, categoryId	Category names from broadest to most specific, plus the leaf category ID.
sellerId, sellerName, sellerRating, sellerSoldCount, sellerFollowers	The shop behind the product.
sellerProductCount, sellerReviewCount, sellerRegion	Shop size, review total and region when the page exposes them.
inStock, stock	Availability and total SKU stock when the page publishes it.
source	Whether the row came from a product, store or category input.
scrapedAt	Collection time (UTC, ISO 8601).
error	Always null in the dataset. Failures are reported in the run summary instead.

The run summary (OUTPUT) reports products (rows delivered), errors and the list at productErrors. With includeShopDetails enabled it also carries shops, one summary per expanded store with sellerId, sellerName, sellerRating, sellerSoldCount, sellerFollowers, sellerProductCount, sellerReviewCount, sellerRegion, rating, soldCount, reviewCount, url and scrapedAt, plus shopCount. Those summaries are run metadata, never dataset rows, so they are not charged.

Output example

{
  "kind": "product",
  "productId": "1729481391627933425",
  "url": "https://shop.tiktok.com/us/pdp/catlink-automatic-cat-litter-box-open-x-app-control-ultra-quiet/1729481391627933425",
  "title": "CATLINK 12L Open-X Self Cleaning Automatic Litter Box - App Control with App Status Alerts, Quiet Operation, Large Bin Reduces Refills & Fuss",
  "priceMin": 245.7,
  "priceMax": 245.7,
  "currency": "USD",
  "originalPrice": 388.7,
  "discountPercent": 37.0,
  "soldCount": 3194,
  "rating": 4.5,
  "reviewCount": 270,
  "images": [
    "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ae0b7851a09a4565ab79a2caaf851c78~tplv-fhlh96nyum-crop-webp:800:800.webp"
  ],
  "categoryPath": ["Pet Supplies", "Dog & Cat Litter", "Litter Trays & Boxes", "Automatic Cat Litter Box"],
  "categoryId": "1146768",
  "sellerId": "7496099137713375985",
  "sellerName": "CATLINK Global",
  "sellerRating": 4.6,
  "sellerSoldCount": 4370,
  "sellerFollowers": 5822,
  "sellerProductCount": 8,
  "sellerReviewCount": 329,
  "sellerRegion": "US",
  "inStock": true,
  "stock": 170,
  "source": "product",
  "scrapedAt": "2026-10-19T06:40:00+00:00",
  "error": null
}

Failed products

A product that cannot be retrieved is reported in the run summary at OUTPUT.productErrors, with the same identity fields plus code and message. Failed products are never dataset rows and are not charged. A run in which every selected source fails exits with an error instead of finishing green with an empty dataset.

Limits and caveats

• Only the United States is supported.
• Product links return a single page. Store and category links are paginated up to maxPages and stop at maxProducts.
• Fields such as discount, stock or shop follower count are null when the page does not publish them; product links expose more detail than listing rows.
• Automated access is subject to TikTok's terms; use this actor only where you have the necessary permissions and a lawful basis.

FAQ

Can I mix product, store and category links? Yes — put them all in the matching input. Duplicate products are returned once.

Do listing rows include everything a product page does? Listing rows carry price, sold count, rating, review count, image and seller name. Full detail such as the original price, discount, SKU stock and category path comes from product links.

What does includeShopDetails add? One summary per expanded store in the run summary at OUTPUT.shops, with the shop's own rating, sold count, follower count, product count and review count. It does not add dataset rows or charges.

Price

$0.0055 per product delivered, plus $0.005 per run start. The run-start event is charged per GB of memory; the default 512 MB run is one start event. The start is charged even if the run saves no results. Failed products are not charged, and neither are the optional shop summaries in OUTPUT.shops. Platform usage is included in these prices.