# TikTok Shop Scraper — Product Videos & Creator Discovery (US) (`monkey.d.scraping/tiktok-shop-product-video-lab`) Actor

Find US TikTok Shop products by keyword, shop or product link. Get prices, ratings, units sold, related videos and deduplicated creator summaries. $4 per 1,000 read products plus $0.002 per start.

- **URL**: https://apify.com/monkey.d.scraping/tiktok-shop-product-video-lab.md
- **Developed by:** [Monkey D. Scraping](https://apify.com/monkey.d.scraping) (community)
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 products

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Scraper & API — Products, Prices & Creators

Search TikTok Shop US products by keyword, shop URL or product ID. Extract prices, ratings and units sold, inspect related TikTok videos, and find creators linked to the products you research. Built for sellers, ecommerce analysts and agencies comparing competitor products and planning creator campaigns.

**$4 per 1,000 successfully read products, plus $0.002 per start at the default 512 MB memory.** Related videos and creator summaries are included. Platform usage is included for standard runs.

### TikTok Shop product research and competitor analysis

- **Product research:** start from a product link or ID and inspect its associated videos and creators.
- **Keyword research:** search a product category such as `led face mask`, then compare product prices, ratings, sold counts and video engagement.
- **Competitor research:** enter a US shop URL to collect its products and identify creators appearing across them.
- **Campaign planning:** use creator summaries to prioritize creators by engagement across the collected unique videos.

### Quick start

Choose an operation, fill its matching input, and click Start. Use only one of `productUrls`, `keyword` or `shopUrl` in each run.

#### TikTok Shop product scraper: links or IDs

```json
{
  "mode": "products",
  "productUrls": ["1731405080882483712", "1730242674331521612"],
  "maxVideosPerProduct": 20
}
```

US product URLs from `shop.tiktok.com/us/pdp/` and `www.tiktok.com/shop/pdp/` are accepted, including links with a product-name segment.

#### TikTok Shop product search by keyword

```json
{
  "mode": "keyword",
  "keyword": "led face mask",
  "maxProducts": 5,
  "maxVideosPerProduct": 20
}
```

#### TikTok Shop store scraper: competitor catalog

```json
{
  "mode": "shop",
  "shopUrl": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
  "maxProducts": 5,
  "maxVideosPerProduct": 20
}
```

### Outputs

The run Output tab links to **Products**, **Creators**, **Videos** and **Summary**, plus CSV downloads for creators and videos.

| Output | What it contains |
| --- | --- |
| Products | One row per product with status, product URL/title, price, currency, rating, review count, sold count and associated videos. |
| Creators | One row per creator ID, product links, unique video count, total views and likes, latest video date and highest-view video link. |
| Videos | Flat list of product-video associations with creator ID/name, title, views, likes, upload date and player URL. |
| Summary | Read/unavailable/error counts, video and creator counts, and whether the spending budget was reached. |

#### Product fields

`priceText` is the displayed offer. `minSkuPrice` and `maxSkuPrice` are separately reported SKU price bounds. `rating` uses a five-point scale; `reviewCount` comes from the same product summary. Missing numeric values are `null`.

`soldCount` is the source's units-sold count. `soldCountDefinition` preserves its meaning, including the period and treatment of returns when supplied. This is a product metric; creator metrics describe the collected videos.

`observedAt` records the observation time. Videos use UTC `publishedAt` dates and `durationMilliseconds` durations. `association: listed_on_product_page` identifies the observed product-video relationship.

#### Creator metrics

Creator summaries are sorted by `totalViews` across collected unique videos. A video associated with multiple products is counted once per creator. `viewsObservedVideoCount` and `likesObservedVideoCount` report how many videos supplied each metric. `latestVideoAt`, `topVideoId` and `topVideoUrl` help inspect recent and high-view examples. Names are display names.

### Pricing and spending control

| Event | Price |
| --- | --- |
| Successfully read product | $0.004 each ($4 per 1,000) |
| Actor start | $0.002 at default memory |
| Associated videos and creator summaries | Included |

A successfully read product is charged once, including a product whose associated-video list is empty. Products reported as unavailable and failed reads are not charged. At 512 MB, two read products cost $0.010 total; 100 read products cost $0.402. Standard runs include platform usage. Apify scales the start event with memory above 1 GB.

Set Maximum cost per run in Apify to control spending. The Actor stops collecting when the remaining budget cannot cover another product and keeps delivered results.

### FAQ

**How do I find TikTok Shop creators by product?**
Choose Product links or IDs and enter the product. Open Creators after the run to see creator IDs, names, product links and engagement across collected videos.

**Can I search products by keyword and get videos in the same run?**
Yes. Choose Products by keyword, enter an English product keyword and choose the number of products. Product details, associated videos and creator summaries are included in the product price.

**Can I inspect a competitor's shop?**
Yes. Choose Products in a shop and enter its US TikTok Shop store URL. Creator summaries group the collected videos across its products.

**What do product statuses mean?**
`ok` means the product and associated videos were read. `no_related_videos` means the product was read with an empty video list. `product_unavailable` records regional unavailability. `unavailable` records a failed read. Results remain available when a run reports reading errors.

**Can an AI agent consume these results?**
The Actor accepts structured JSON input and exposes named Products, Creators, Videos and Summary outputs for programmatic workflows.

### TikTok Shop API: products, keyword search and creators

The single-tenant Server interface returns `products`, `videos`, `creators` and `summary` directly in the HTTP response. Send `POST /search` with the same input JSON, or `GET /search?productId=1731405080882483712`. For keyword and shop requests set `mode` and `keyword` or `shopUrl`. Choose up to three products and up to twenty videos per product per request. Results are scoped to each request.

Authenticate with your Apify token in the `Authorization: Bearer ...` header. The Server URL is available in the Actor's API section. Requests are handled one at a time per instance; a busy instance returns HTTP 429. HTTP 206 includes collected results and a summary indicating incomplete processing.

Server pricing is **$0.004 per read product + $0.002 per instance start at 512 MB + Apify platform usage**. Start applies when an instance starts, not to every request served by that instance. The instance shuts down after 60 seconds of inactivity. Successful repeat requests perform a fresh read and are billed again. To replay an identical response on the same live instance, send the same `Idempotency-Key` header within ten minutes; up to 64 recent keyed responses are retained. A key reused with a different input returns HTTP 409. Instance restarts begin a new replay window.

# Actor input Schema

## `mode` (type: `string`):

Choose one operation. Fill only its corresponding input below.

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

For Product links or IDs mode. Paste US TikTok Shop product links or numeric IDs. Leave empty for other operations.

## `keyword` (type: `string`):

For Products by keyword mode. Example: led face mask. Leave empty for other operations.

## `shopUrl` (type: `string`):

For Products in a shop mode. Example: https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079. Leave empty for other operations.

## `maxProducts` (type: `integer`):

Maximum products to inspect for keyword or shop searches.

## `maxVideosPerProduct` (type: `integer`):

Associated videos per product, included in the product price.

## Actor input object example

```json
{
  "mode": "products",
  "productUrls": [
    "https://shop.tiktok.com/us/pdp/19-pc-silicone-kitchen-tool-set-with-wooden-handles-safe-durable/1731405080882483712"
  ],
  "maxProducts": 5,
  "maxVideosPerProduct": 20
}
```

# Actor output Schema

## `products` (type: `string`):

Product details and associated videos. One row per product, with read status.

## `creators` (type: `string`):

Unique creators, product links, collected video counts and engagement.

## `videos` (type: `string`):

Flat list of product-video associations.

## `summary` (type: `string`):

Read counts and budget completion.

## `creatorsCsv` (type: `string`):

Download creators as a CSV table.

## `videosCsv` (type: `string`):

Download videos as a CSV table.

# 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/us/pdp/19-pc-silicone-kitchen-tool-set-with-wooden-handles-safe-durable/1731405080882483712"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/tiktok-shop-product-video-lab").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/us/pdp/19-pc-silicone-kitchen-tool-set-with-wooden-handles-safe-durable/1731405080882483712"] }

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/tiktok-shop-product-video-lab").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/us/pdp/19-pc-silicone-kitchen-tool-set-with-wooden-handles-safe-durable/1731405080882483712"
  ]
}' |
apify call monkey.d.scraping/tiktok-shop-product-video-lab --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/tiktok-shop-product-video-lab"
        }
    }
}
```

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/bx6bOP27wcU93LHfn/builds/qAFLM1RulqI3DcftM/openapi.json
