# TikTok Shop Scraper data API: fields, sample output and cost per 1,000 rows

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](https://apify.com/v0iddo/tiktok-shop-product-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

```json
{
  "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](https://apify.com/v0iddo/tiktok-shop-product-scraper/examples/tiktok-shop-product-details)
- [TikTok product scraper: units sold for beauty and fashion](https://apify.com/v0iddo/tiktok-shop-product-scraper/examples/tiktok-product-scraper-beauty-fashion-units-sold)
- [TikTok Shop price tracker: phone accessories and a pet tool](https://apify.com/v0iddo/tiktok-shop-product-scraper/examples/tiktok-shop-price-tracker-accessories)

## 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.

```bash
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](https://apify.com/v0iddo/tiktok-shop-product-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/tiktok-shop-product-scraper/](https://voidd0.github.io/tiktok-shop-product-scraper/)