TikTok Shop Scraper data API: fields, sample output and cost per 1,000 rows
Reference for TikTok Shop Scraper: output fields, a sample record and what a run costs. Scrape TikTok Shop product pages in the United States from product links or IDs: title, price, original price, discount, units sold, rating, review count, st...
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 is the reference for the Actor v0iddo/tiktok-shop-product-scraper: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.
At a glance
| Actor | v0iddo/tiktok-shop-product-scraper |
| Store page | TikTok Shop Scraper |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 39 (15 number, 15 text, 5 list, 1 URL, 1 image URL, 1 object, 1 true/false) |
| Cap on results | maxItems in the input |
| Price | $2.70 per 1,000 results |
Output fields
Each result is one row with these fields (fields that name people are left out):
| Field | Type | Meaning | Sample value |
|---|---|---|---|
productId |
text | Product ID | 1731578642912612516 |
title |
text | Title | Potaroma Universal Cat Paw Trimmer - ABS Plastic, 1mm to 3.5mm 4-Si... |
price |
number | Price | 12.97 |
originalPrice |
number | Original price | 26 |
currency |
text | Currency | USD |
soldCount |
number | Units sold | 16699 |
rating |
number | Stars | 4.4 |
reviewCount |
number | Reviews | 1427 |
shopName |
text | Shop | Potaroma LLC |
status |
text | Status | on_sale |
mainImage |
image URL | Image | https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo... |
url |
URL | Product URL | https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjusta... |
region |
text | US | |
inStock |
true/false | true | |
priceMax |
number | 12.97 | |
discountPercent |
number | 50 | |
priceText |
text | $12.97 | |
ratingCounts |
object | {"1": 93, "2": 48, "3": 86, "4": 168, "5": 1032} | |
shopId |
text | 7495813075786500260 | |
shopUrl |
text | https://shop.tiktok.com/us/store/potaroma-llc/7495813075786500260 | |
shopRating |
number | 4.4 | |
shopSoldCount |
number | 214149 | |
shopProductCount |
number | 61 | |
shopFollowerCount |
number | 13462 | |
shopScores |
list | [{"name": "24h response rate", "value": "100%"}, {"name": "Ships wi... | |
category |
text | Claw Care | |
categoryId |
text | 817544 | |
categories |
list | ["Pet Supplies", "Dog & Cat Grooming", "Claw Care"] | |
images |
list | ["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5z... | |
description |
text | Adjustable Trimmer for All Cat Sizes: This cat nail clipper feature... | |
specifications |
list | [{"name": "Benefit", "value": "Clean"}, {"name": "Pet type", "value... | |
variants |
list | [{"skuId": "1731578664610402468", "options": [{"name": "Specificati... | |
variantCount |
number | 1 | |
shippingFee |
number | 0 | |
deliveryMinDays |
number | 4 | |
deliveryMaxDays |
number | 7 | |
deliveryEstimate |
text | Oct 30 - Nov 2 | |
input |
text | https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjusta... | |
scrapedAt |
text | 2026-10-26T04:29:12+00:00 |
One record
{
"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
}
Input parameters
| Parameter | Type | Required | Default | What it does |
|---|---|---|---|---|
products |
array | yes | ["https://shop.tiktok.com/us/pdp/cat-nail-clipper-by-potaroma-adjus... | TikTok Shop product links such as https://shop.tiktok.com/us/pdp/product-name/1731578642912612516 or https://www.tiktok.com/shop/pdp/1731578642912612516, or product ID... |
maxItems |
integer | no | 100 | The run stops after this many result rows. |
Ready-made examples
Saved inputs on Apify: run one as it is, or copy it and change the values.
- TikTok Shop product details from product URLs
- TikTok product scraper: units sold for beauty and fashion
- TikTok Shop price tracker: phone accessories and a pet tool
Cost per 1,000 rows
$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.
| Results | Cost at the listed price | Cost at the lowest plan price |
|---|---|---|
| 100 | $0.27 | $0.19 |
| 1,000 | $2.70 | $1.89 |
| 10,000 | $27.00 | $18.90 |
| 100,000 | $270.00 | $189.00 |
The figures are the listed price times the number of results. The maxItems limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.
Get the rows as CSV over HTTP
One request starts a run, waits for it and returns the dataset. The format parameter picks the file type and fields picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.
curl -X POST "https://api.apify.com/v2/acts/v0iddo~tiktok-shop-product-scraper/run-sync-get-dataset-items?format=csv&fields=productId,title,price" \
-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}'
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.
Links
- Actor on the Apify Store: TikTok Shop Scraper
- Guide with the Python and JavaScript code: https://voidd0.github.io/tiktok-shop-product-scraper/
Comments
Join the discussionNo comments yet. Be the first to comment.