# TikTok Shop Product Detail Scraper (`om_kh/tiktok-shop-product-detail-scraper`) Actor

TikTok Shop product detail with verified price, exact SKU variants, stock and seller — every value carries its source URL and a verification flag. Our fee $0.0125 per product + supplier. All supplier fields included.

- **URL**: https://apify.com/om_kh/tiktok-shop-product-detail-scraper.md
- **Developed by:** [Khandji Omar](https://apify.com/om_kh) (community)
- **Categories:** E-commerce, AI, Social media
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.88 / 1,000 product details

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Shop Product Detail Scraper — Verified Price

> **You paste a TikTok Shop product URL. You get title, verified price,**
> **exact SKU variants, stock and seller** — every value carries its
> source URL and a verification flag.

### In short: what you give, what you get, what it costs

| | |
|---|---|
| **You give** | TikTok Shop product links |
| **We do** | Read each product and verify its price |
| **You get** | One row per product: title, verified price, exact SKU variants, stock and seller, every value with its source link and a verification flag, plus every field the supplier returns (`source_data`) |
| **It costs** | $0.0125 per product + $0.002 per SKU variant, + $0.001 per run from Nov 26, 2026 (no start fee before). Apify also bills the supplier Actor `pratikdani/tiktok-shop-scraper` that this robot runs for you, at its own price (about $0.025 per product on the free plan, $0.015 on paid plans), so about **$0.0375 per product in total**. An item that returns an error is never charged |
| **It does not** | Sign in to TikTok or place orders |

A real result row is shown further down this page.

### Free tier — 3 results free on every run

**The first 3 results of every run are free**, on every run you ever make — not a one-off trial. One guard: the free allowance never covers more than half of a run, so the offer stays sustainable.

### ✅ Live-verified 2026-09-10 — chained source replaced

The originally planned source (`cunning_soil/tiktok-shop-product-scraper-mobile-api`)
was **proved non-functional**: four live tests with four different input
shapes all returned zero products. It was dropped rather than shipped.
The real source is `pratikdani/tiktok-shop-scraper`, verified end to end on
a real product (Oclean X Pro, $117.51, cost $0.054).

Confirmed fields: `product_id`, `product_name`, `product_url`,
`price`/`min_price`/`max_price` (strings like `"$117.51"`), `currency`,
`seller{seller_id, seller_name, seller_link}`, `seller_type`, `skus`
(**a dict keyed by SKU id, not a list** — `{real_price,
sale_prop_value_ids, sku_id, stock}`, with no text attribute label, so
`attrs` is honestly always `None`), `total_stock_cnt`, `sale_cnt`,
`review_count`.

Also found: the URL form Google indexes (`shop.tiktok.com/us/pdp/<slug>/<id>`)
is rejected by the source; only `shop.tiktok.com/view/product/<id>` works.
`_normalize_product_url()` accepts both forms and a bare id.

**Still pending:** the 200-run reliability recipe required by
`NORME_VIGIA.md` §5 / addendum A1.

### 5 advantages

1. **One bad URL never kills your batch.**
2. **Never billed on a failed lookup.**
3. **Honest price verification** — `price_verified: false` with a reason
   when the real price cannot be confirmed.
4. **Honest sold-count** — `null` + `reason: "not_public"` when not
   observable, never an estimate.
5. **Hard cost cap you control.** Set `maxTotalChargeUsd`.

### Pricing

Pay per event, base FREE-tier prices: **$0.0125** per product delivered (since 2026-10-26, was $0.125), **$0.002** per SKU variant.

**Source Actor charge:** this Actor runs `pratikdani/tiktok-shop-scraper` on your account, which bills you its own price (about $0.025 per product on the free plan, $0.015 on paid plans, plus $0.002 per start). Your total per product is about **$0.0375**. The free results waive our fee only.
Paid Store plans pay less on every event — the largest plans reach $0.0011 on the cheapest event; the Pricing tab on this Actor's Store page is
always the authority. **No event is ever charged on an item that returns an `error`** —
a batch of 200 with one bad input bills 199.

### Use it from an AI agent (MCP and x402)

Connect Claude Desktop, Cursor, VS Code or any MCP client to Apify's MCP server
at `https://mcp.apify.com` and add this Actor, `om_kh/tiktok-shop-product-detail-scraper`, as a tool — the
agent passes the same JSON as the run input and gets the dataset back.

AI agents that pay with **x402** can run it too, without an Apify account: the
Actor charges only per result delivered, so an agent pays exactly for what it gets.

### Related Actors

- [TikTok Shop Creator Finder](https://apify.com/om_kh/tiktok-shop-creator-finder) — find creators who could promote this product
- [1688 Wholesale Supplier Scraper](https://apify.com/om_kh/1688-wholesale-supplier-scraper) — source the product before you list it

### Support

Found a bug or have a feature request? Use the **Issues** tab on this
Actor's Apify Store page, or message the author (`om_kh`) directly.

### Example input

```json
{
  "productUrls": [
    "https://shop.tiktok.com/view/product/1732417183133045688"
  ]
}
```

### Compared with pratikdani/tiktok-shop-scraper

Read on the Store on 2026-10-26 (pratikdani/tiktok-shop-scraper). Where it does better, this section says so.

- **Same source data:** this Actor runs pratikdani/tiktok-shop-scraper for you, so every row carries its fields.
- **This Actor's fee is free on the first results of every run**, and a hard cost cap (`maxTotalChargeUsd`) limits it.
- **Price:** you pay pratikdani/tiktok-shop-scraper's own price ($25 per 1,000) plus this Actor's $12.5, so $37.5 per 1,000 in total. If you only need the raw rows once, pratikdani/tiktok-shop-scraper alone is cheaper; this Actor is for the only-new mode on schedules and the cost cap.

### How to use it in 3 steps

1. Click **Try for free**; the form opens with a ready example in **Product URLs**.
2. Optional: change the other fields; every one has a description and a sensible default.
3. Click **Start** and download the results as JSON, CSV or Excel, or read them from the API.

### Output example

One real row from a run on Apify:

A real row from this Actor's latest run on Apify (2026-10-18; long texts are cut and people's names hidden here, your dataset has them in full):

```json
{
  "status": "ok",
  "product_id": "1732417183133045688",
  "product_url": "https://www.tiktok.com/shop/pdp/1732417183133045688",
  "title": "5-1 FreshHood Apparel fast shipping 100% cotton T-shirts",
  "price": 25.99,
  "price_verified": true,
  "currency": "USD",
  "variants": [
    {
      "sku_id": "1732417196783539128",
      "price": 25.99,
      "stock": 961501
    },
    {
      "sku_id": "1732417196783473592",
      "price": 25.99,
      "stock": 961501
    }
  ],
  "stock_total": "4.81M",
  "sold_count": "192.98K",
  "seller": {
    "name": "(hidden here)",
    "url": "https://www.tiktok.com/shop/store/freshhood-apparel/7494495282633476024"
  }
}
```

#### Every supplier field included

Each row also carries `source_data`: the full row returned by [pratikdani/tiktok-shop-scraper](https://apify.com/pratikdani/tiktok-shop-scraper), every field it gives, untouched — you never get less than the supplier itself delivers. Our own fields above stay exactly as they are. A row over 200 KB is trimmed and `source_data_trimmed` lists the fields cut.

### Use cases

- **Price tracking:** follow the real price and stock of competitor products on TikTok Shop, every day, with only the changes delivered.
- **Product research:** check SKU variants, seller and stock before listing a product yourself.
- **Affiliate and agency work:** verify the price a creator is promoting before a campaign.
- **Catalog sync:** feed a spreadsheet or a database with clean product rows through the API, n8n or Make.

### FAQ

**Which URLs work?** Any public TikTok Shop product page URL (shop.tiktok.com or www.tiktok.com/view/product/...).

**What does a product cost in total?** $0.0125 for this Actor plus the source Actor's own price (about $0.025 per product on the free plan): about $0.0375. The first 3 products of every run waive this Actor's fee.

**What if the price is not public?** The row says `price_verified: false` with a reason, never a guessed price.

**Do I need a TikTok account or cookies?** No.

**Can I cap the cost?** Yes, set `maxTotalChargeUsd`: the run stops before going over it.

### All input fields

The main fields are described above; these are the others the form accepts:

- **`includeSeller`** (Include seller detail) — Include seller name and shop URL.
- **`includeVariants`** (Include SKU variants) — Include per-SKU price, stock, and attributes.
- **`productIds`** (Product IDs) — TikTok Shop product IDs, if you have them instead of URLs.
- **`regions`** (Regions) — TikTok Shop region of the products, e.g. US, GB, ID, TH, VN. The first one is used; default US.

### Your feedback

Did this Actor save you time? A short review on the **Reviews** tab helps other people find it, and every review is read. Something missing or broken? Open an issue on the **Issues** tab: it is answered and fixed fast.

# Actor input Schema

## `productUrls` (type: `array`):

TikTok Shop product URLs to fetch.

## `productIds` (type: `array`):

TikTok Shop product IDs, if you have them instead of URLs.

## `regions` (type: `array`):

TikTok Shop region of the products, e.g. US, GB, ID, TH, VN. The first one is used; default US.

## `includeVariants` (type: `boolean`):

Include per-SKU price, stock, and attributes.

## `includeSeller` (type: `boolean`):

Include seller name and shop URL.

## `monitorEnabled` (type: `boolean`):

On later runs with the same Monitor ID, deliver only products not seen before.

## `monitorId` (type: `string`):

Groups runs into one monitored target. Leave blank for a one-off run.

## `maxTotalChargeUsd` (type: `number`):

Hard ceiling on what this run can bill you.

## Actor input object example

```json
{
  "productUrls": [
    "https://shop.tiktok.com/view/product/1732417183133045688"
  ],
  "regions": [
    "US"
  ],
  "includeVariants": true,
  "includeSeller": true,
  "monitorEnabled": false
}
```

# Actor output Schema

## `report` (type: `string`):

A visual summary of delivery, charges, and source issues.

## `results` (type: `string`):

Products in a sortable table. No JSON knowledge required.

## `csv` (type: `string`):

Results ready for spreadsheets, CRMs, and analytics tools.

## `excel` (type: `string`):

Results as an Excel workbook for non-technical teams.

## `runSummary` (type: `string`):

Machine-readable delivery, billing, and source diagnostics.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "productUrls": [
        "https://shop.tiktok.com/view/product/1732417183133045688"
    ],
    "regions": [
        "US"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("om_kh/tiktok-shop-product-detail-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "productUrls": ["https://shop.tiktok.com/view/product/1732417183133045688"],
    "regions": ["US"],
}

# Run the Actor and wait for it to finish
run = client.actor("om_kh/tiktok-shop-product-detail-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "productUrls": [
    "https://shop.tiktok.com/view/product/1732417183133045688"
  ],
  "regions": [
    "US"
  ]
}' |
apify call om_kh/tiktok-shop-product-detail-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,om_kh/tiktok-shop-product-detail-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Te4x7FEk9LibbzBoO/builds/ss89Q5oNPwn7Kvfab/openapi.json
