Tiktok Shop Analytics

Version 1.0.19 — honest scope update (2026-05-21). This actor discovers TikTok videos that promote TikTok Shop products, extracts product mentions from those videos, and analyzes the creators behind them. See Data quality notes below for what this actor does and does not return.

Discover what's trending on TikTok Shop by mining the videos that promote it, the creators driving sales, and the hashtag ecosystem around viral products.

What this actor does

The actor uses TikTok video search and hashtag pages as its entry point and returns three kinds of data:

1. product_mention — TikTok videos that mention TikTok Shop products (descriptions, hashtags, shop-icon indicators, in-bio shop links). These tell you which products are getting promoted right now.
2. video — Engagement metadata for each promoting video (views, likes, comments, shares, creator follower count, etc.). Use these to spot viral moments.
3. creator / affiliate — Profiles of the creators promoting products, with affiliate-tier classification (mega / macro / mid-tier / micro / nano) and engagement-rate scoring.

Plus a per-run run_summary record so a single run is self-describing.

What this actor does NOT do

• It does not return TikTok Shop product catalog data directly. TikTok Shop search URLs (https://www.tiktok.com/shop/search?q=...) return HTTP 404 to unauthenticated requests; the Shop frontend is a JS-rendered SPA that calls internal authenticated APIs we cannot access without a logged-in session. → If you need direct product catalog data (SKU, current price, inventory, seller ID) you will need a Shop API key or a logged-in proxy. Consider integrating RapidAPI's TikTok Shop endpoints via the RAPIDAPI_KEY env var in your run input.
• It does not return inventory or sales counts. Those fields exist in the output schema as null when running in the default video-discovery mode.

Use cases this actor is good at

• Trending discovery — what's being promoted on TikTok right now
• Influencer outreach — find creators driving traffic to specific products
• Hashtag ecosystem analysis — #TikTokMadeMeBuyIt, #AmazonFinds, etc.
• Cross-region trend comparison — what's hot in US vs UK vs ID
• Affiliate-tier mapping — which mega/macro creators promote what

Use cases this actor is not the right tool for

• Direct product catalog scraping — use a Shop API integration instead
• Real-time price tracking — the actor returns price mentions, not feeds
• Inventory monitoring — not supported

Quick start

Find creators promoting viral skincare

{
    "dataTypes": ["affiliates"],
    "hashtag": "#TikTokMadeMeBuyIt",
    "maxCreators": 30,
    "enableCreatorAnalysis": true
}

Find videos promoting kitchen products

{
    "dataTypes": ["products"],
    "searchQuery": "kitchen gadgets",
    "region": "US",
    "maxProducts": 50
}

The result will be product_mention items (videos that promote products), not raw product catalog rows.

Combined run

{
    "dataTypes": ["products", "affiliates"],
    "searchQuery": "viral skincare",
    "hashtag": "#TikTokMadeMeBuyIt",
    "region": "US",
    "maxProducts": 50,
    "maxCreators": 30
}

Output schema highlights

product_mention items

Field	Description
dataType	Always "product_mention"
description	Video description / caption
hashtags	Hashtags found in the video
productKeywords	Shop-related keywords detected (["shop", "tiktokshop", ...])
hasProductLink	True if a product URL was found in the description
hasShopMention	True if the description mentions "shop", "store", etc.
hasDiscountCode	True if a discount code pattern was matched
viralityScore	Heuristic 0–100 based on engagement / hashtags

video items

Full video engagement metadata: likes, comments, shares, plays, authorFollowers, engagementRate, music, createTime.

creator / affiliate items

Field	Description
username, displayName, followers	Standard profile data
engagementRate	Likes / followers
affiliateScore	0–100 affiliate-potential heuristic
affiliateTier	mega / macro / mid-tier / micro / nano
contactEmail	Extracted from bio if present

Affiliate tiers

Tier	Followers
Mega	1M+
Macro	100K – 1M
Mid-tier	10K – 100K
Micro	1K – 10K
Nano	< 1K

Regions supported

US, UK, ID, TH, VN, MY, PH, SG (TikTok regional video search corpora).

Data quality notes

A single run currently returns roughly 2–5 items per query in the default video-discovery mode. This is by design given the entry point — TikTok's hashtag and search corpora surface a limited set of high-engagement videos.

If you need higher item counts:

1. Use multiple hashtag runs in parallel (e.g. one per category)
2. Provide explicit productUrls or creatorUrls to scrape directly
3. Increase maxProducts / maxCreators (but expect diminishing returns past 50)

Tips for best results

1. Use residential proxies — TikTok blocks datacenter IPs aggressively
2. Start small — Test with 10–20 items before running larger jobs
3. Combine data types — products + affiliates gives the richest picture
4. Try region rotation — Some hashtags are bigger in ID/TH than US
5. Focus on viralityScore > 60 for trending signal

Pricing

This actor is FREE (uses your platform's compute units). Typical run:

• ~30–60 seconds for a single search
• ~0.01–0.05 compute units per run
• Playwright + stealth mode is the main compute cost

Versioning

Version	Notes
1.0.19	Honest scope update — README rewrite, documentation matches what the actor actually does. No code change to scraping logic.
1.0.18	Stable build (April 2026). Tagged latest.
1.1.1 – 1.1.4	Attempted feature builds; produced failed runs and were rolled back.

Legal notice

This actor scrapes publicly available data from TikTok. Users are responsible for ensuring their use complies with TikTok's Terms of Service and applicable laws. Data should be used for research and analysis purposes only.

---

Built by JCD