TikTok Shop Scraper (Apify)

Find US TikTok Shop products by keyword, shop or product link: prices, ratings, units sold, related videos and creators. JSON or CSV.

Hosted MCP Server

npx add-mcp 'https://mcp.apify.com/?tools=monkey.d.scraping/tiktok-shop-product-video-lab'

Installs into Claude Code, Codex, Cursor and more

Documentation

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.

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 section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (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

{
  "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

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

TikTok Shop store scraper: competitor catalog

{
  "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.

OutputWhat it contains
ProductsOne row per product with status, product URL/title, price, currency, rating, review count, sold count and associated videos.
CreatorsOne row per creator ID, product links, unique video count, total views and likes, latest video date and highest-view video link.
VideosFlat list of product-video associations with creator ID/name, title, views, likes, upload date and player URL.
SummaryRead/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

EventPrice
Successfully read product$0.004 each ($4 per 1,000)
Actor start$0.002 at default memory
Associated videos and creator summariesIncluded

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

{
  "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

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

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

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

{
    "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