DEV Community

voiddo
voiddo

Posted on Originally published at voidd0.github.io

TikTok Shop Scraper: how to get Products, Units Sold as JSON or CSV (Python, API, no code)

Scrape TikTok Shop product pages in the United States from product links or IDs: title, price, original price, discount, units sold, rating, review count, stock, variants, images, category, shipping and shop details.

This tutorial shows what the Actor v0iddo/tiktok-shop-product-scraper returns, how to run it on the Apify Store without code, and how to call it from Python and cURL.

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

Field Label Type Example
productId Product ID text 1731578642912612516
title Title text Potaroma Universal Cat Paw Trimmer - ABS Plastic, 1mm to 3.5mm 4-Si...
price Price number 12.97
originalPrice Original price number 26
currency Currency text USD
soldCount Units sold number 16699
rating Stars number 4.4
reviewCount Reviews number 1427
shopName Shop text Potaroma LLC
status Status text on_sale
mainImage Image image URL https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo...
url Product URL URL https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjusta...
region region text US
inStock inStock true/false true
priceMax priceMax number 12.97
discountPercent discountPercent number 50
priceText priceText text $12.97
ratingCounts ratingCounts object {"1": 93, "2": 48, "3": 86, "4": 168, "5": 1032}
shopId shopId text 7495813075786500260
shopUrl shopUrl text https://shop.tiktok.com/us/store/potaroma-llc/7495813075786500260
shopRating shopRating number 4.4
shopSoldCount shopSoldCount number 214149
shopProductCount shopProductCount number 61
shopFollowerCount shopFollowerCount number 13462
shopScores shopScores list [{"name": "24h response rate", "value": "100%"}, {"name": "Ships wi...
category category text Claw Care
categoryId categoryId text 817544
categories categories list ["Pet Supplies", "Dog & Cat Grooming", "Claw Care"]
images images list ["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5z...
description description text Adjustable Trimmer for All Cat Sizes: This cat nail clipper feature...
specifications specifications list [{"name": "Benefit", "value": "Clean"}, {"name": "Pet type", "value...
variants variants list [{"skuId": "1731578664610402468", "options": [{"name": "Specificati...
variantCount variantCount number 1
shippingFee shippingFee number 0
deliveryMinDays deliveryMinDays number 4
deliveryMaxDays deliveryMaxDays number 7
deliveryEstimate deliveryEstimate text Oct 30 - Nov 2
input input text https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjusta...
scrapedAt scrapedAt text 2026-10-26T04:29:12+00:00

Real rows from a run of the Actor (fields that name people are left out):

[
  {
    "productId": "1731578642912612516",
    "url": "https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516",
    "region": "US",
    "title": "Potaroma Universal Cat Paw Trimmer - ABS Plastic, 1mm to 3.5mm 4-Size Adjustable Holes, Hidden Nail File, Anti-Splash Clean Design, Locka...",
    "status": "on_sale",
    "inStock": true,
    "price": 12.97,
    "priceMax": 12.97,
    "originalPrice": 26,
    "discountPercent": 50,
    "currency": "USD",
    "priceText": "$12.97",
    "soldCount": 16699,
    "rating": 4.4,
    "reviewCount": 1427,
    "ratingCounts": {
      "1": 93,
      "2": 48,
      "3": 86,
      "4": 168,
      "5": 1032
    },
    "shopName": "Potaroma LLC",
    "shopId": "7495813075786500260",
    "shopUrl": "https://shop.tiktok.com/us/store/potaroma-llc/7495813075786500260",
    "shopRating": 4.4,
    "shopSoldCount": 214149,
    "shopProductCount": 61,
    "shopFollowerCount": 13462,
    "shopScores": [
      {
        "name": "24h response rate",
        "value": "100%"
      },
      {
        "name": "Ships within 2 days",
        "value": "0%"
      },
      {
        "name": "Positive feedback",
        "value": "84%"
      }
    ],
    "category": "Claw Care",
    "categoryId": "817544",
    "categories": [
      "Pet Supplies",
      "Dog & Cat Grooming",
      "Claw Care"
    ],
    "mainImage": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/f8b4429c891246468abacbfb08a610fc~tplv-fhlh96nyum-crop-webp:800:8...",
    "images": [
      "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/f8b4429c891246468abacbfb08a610fc~tplv-fhlh96nyum-crop-webp:800:8...",
      "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fd59afa10ff7417ca2d6fac0b649424b~tplv-fhlh96nyum-crop-webp:800:8...",
      "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/953365009dd74c6e9a1c9309e6abf4b3~tplv-fhlh96nyum-crop-webp:800:8..."
    ],
    "description": "Adjustable Trimmer for All Cat Sizes: This cat nail clipper features a single round trimming hole with 4 adjustable sizes (1-3.5mm diamet...",
    "specifications": [
      {
        "name": "Benefit",
        "value": "Clean"
      },
      {
        "name": "Pet type",
        "value": "Cats"
      },
      {
        "name": "Pet supplies type",
        "value": "Nail grinder"
      }
    ],
    "variants": [
      {
        "skuId": "1731578664610402468",
        "options": [
          {
            "name": "Specifications",
            "value": "Default"
          }
        ],
        "price": 12.97,
        "originalPrice": 26,
        "stock": 36,
        "available": true
      }
    ],
    "variantCount": 1,
    "shippingFee": 0,
    "deliveryMinDays": 4,
    "deliveryMaxDays": 7,
    "deliveryEstimate": "Oct 30 - Nov 2",
    "input": "https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516",
    "scrapedAt": "2026-10-26T04:29:12+00:00"
  }
]
Enter fullscreen mode Exit fullscreen mode

No code: run it on the Apify Store

  1. Open the TikTok Shop Scraper page on Apify.
  2. Fill in the input form. An example input is already filled in.
  3. Press Start, wait for the run to finish, and download the results as JSON, CSV or Excel from the Output tab.

The input that is pre-filled on the Actor page:

{
  "products": [
    "https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516",
    "https://shop.tiktok.com/us/pdp/zila-cropped-cable-knit-top-100-cotton-front-button-closures/1732500518270439586",
    "https://shop.tiktok.com/us/pdp/jetech-matte-case-for-iphone-16-shockproof-anti-fingerprint/1732347639758557964",
    "https://shop.tiktok.com/us/pdp/jetech-screen-protector-for-ipad-a16-9h-tempered-glass-2-pack/1732359237559685900",
    "https://shop.tiktok.com/us/pdp/waterproof-mascara-by-sace-lady/1730219123026333900",
    "https://shop.tiktok.com/us/pdp/deodorant-truly-beauty-unicorn-fruit-cotton-candy-scent-for-bright-skin/1729430515554816714",
    "https://shop.tiktok.com/us/pdp/womens-bucket-hat-by-unknown-colorblock-knit-warm-fisherman-style/1729721254514234223",
    "https://shop.tiktok.com/us/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo/1729527313880355335",
    "https://shop.tiktok.com/us/pdp/eskute-v101-1500w-electric-bike-28mph-85mi-range-7-speed/1729506602529690818",
    "https://shop.tiktok.com/us/pdp/centella-green-tea-hydrating-gel-cleanser-gentle-daily-use/1729449803340812401"
  ],
  "maxItems": 20
}
Enter fullscreen mode Exit fullscreen mode

Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

Python (apify-client)

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/tiktok-shop-product-scraper.

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'products': ['https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516',
              'https://shop.tiktok.com/us/pdp/zila-cropped-cable-knit-top-100-cotton-front-button-closures/1732500518270439586',
              'https://shop.tiktok.com/us/pdp/jetech-matte-case-for-iphone-16-shockproof-anti-fingerprint/1732347639758557964',
              'https://shop.tiktok.com/us/pdp/jetech-screen-protector-for-ipad-a16-9h-tempered-glass-2-pack/1732359237559685900',
              'https://shop.tiktok.com/us/pdp/waterproof-mascara-by-sace-lady/1730219123026333900',
              'https://shop.tiktok.com/us/pdp/deodorant-truly-beauty-unicorn-fruit-cotton-candy-scent-for-bright-skin/1729430515554816714',
              'https://shop.tiktok.com/us/pdp/womens-bucket-hat-by-unknown-colorblock-knit-warm-fisherman-style/1729721254514234223',
              'https://shop.tiktok.com/us/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo/1729527313880355335',
              'https://shop.tiktok.com/us/pdp/eskute-v101-1500w-electric-bike-28mph-85mi-range-7-speed/1729506602529690818',
              'https://shop.tiktok.com/us/pdp/centella-green-tea-hydrating-gel-cleanser-gentle-daily-use/1729449803340812401'],
 'maxItems': 20}

run = client.actor("v0iddo/tiktok-shop-product-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
Enter fullscreen mode Exit fullscreen mode

cURL

curl -X POST "https://api.apify.com/v2/acts/v0iddo~tiktok-shop-product-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"products": ["https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516", "https://shop.tiktok.com/us/pdp/zila-cropped-cable-knit-top-100-cotton-front-button-closures/1732500518270439586", "https://shop.tiktok.com/us/pdp/jetech-matte-case-for-iphone-16-shockproof-anti-fingerprint/1732347639758557964", "https://shop.tiktok.com/us/pdp/jetech-screen-protector-for-ipad-a16-9h-tempered-glass-2-pack/1732359237559685900", "https://shop.tiktok.com/us/pdp/waterproof-mascara-by-sace-lady/1730219123026333900", "https://shop.tiktok.com/us/pdp/deodorant-truly-beauty-unicorn-fruit-cotton-candy-scent-for-bright-skin/1729430515554816714", "https://shop.tiktok.com/us/pdp/womens-bucket-hat-by-unknown-colorblock-knit-warm-fisherman-style/1729721254514234223", "https://shop.tiktok.com/us/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo/1729527313880355335", "https://shop.tiktok.com/us/pdp/eskute-v101-1500w-electric-bike-28mph-85mi-range-7-speed/1729506602529690818", "https://shop.tiktok.com/us/pdp/centella-green-tea-hydrating-gel-cleanser-gentle-daily-use/1729449803340812401"], "maxItems": 20}'
Enter fullscreen mode Exit fullscreen mode

Good to know

  • Not affiliated with TikTok. The data is what a visitor who is not logged in sees on the product page.
  • One row per product, at most 500 products per run. Each product is one page request (two when the link has no product name in it), a few seconds apart.

Price

$2.70 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.89 per 1,000.

FAQ

What data does the TikTok Shop Scraper return?

Each result is one row in an Apify dataset. Fields include productId, title, price, originalPrice, currency, soldCount, rating, reviewCount, and more. The table above shows every field with an example value.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$2.70 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.89 per 1,000. A new Apify account gets $5 of platform credit every month.

Links

Top comments (0)