TikTok Video Insights Extractor

Extract detailed metadata and engagement statistics from TikTok video pages using a stealth Playwright browser. This Actor loads TikTok videos like a real user, waits for TikTok’s internal hydration data, and reliably captures engagement metrics with smart fallbacks.

---

✨ What this Actor does

Given one or more TikTok URLs, this Actor:

• Loads each page in a real Chromium browser (Playwright)
• Mimics a modern Chrome user for improved reliability
• Extracts data primarily from TikTok’s internal hydration JSON
• Falls back to DOM-based selectors if needed
• Outputs clean, structured data to the default Apify dataset

This approach is significantly more reliable than simple HTML scraping.

---

📥 Input

You can provide either a single URL or multiple URLs.

Input fields

Field	Type	Description
url	string	A single TikTok video (or hashtag) URL
urls	array	Optional list of TikTok URLs
proxy	object	Proxy configuration (residential proxy recommended)

⚠️ Either url or urls must be provided.

Example input (single URL)

{
  "url": "https://www.tiktok.com/@username/video/1234567890"
}

---

Example input (multiple URLs)

{
  "urls": [
    "https://www.tiktok.com/@user1/video/111",
    "https://www.tiktok.com/@user2/video/222"
  ]
}

🌐 Proxy usage

TikTok actively rate-limits and blocks automated traffic.

This Actor is configured to use Apify residential proxies by default, which is strongly recommended for:

• Higher success rates

• Fewer captchas

• More consistent extraction of engagement metrics

You can customize or disable the proxy in the input if needed.

---

📤 Output

For each processed URL, the Actor outputs one dataset item containing video-level insights.

Extracted fields (typical)

• videoUrl

• authorHandle

• authorName

• description

• hashtags

• likes

• comments

• shares

• bookmarks

• views

• music

• pageTitle

• scrapedAt

Note: Some metrics (such as views) may be hidden by TikTok depending on the video and account settings.

---

Example output

{
  "videoUrl": "https://www.tiktok.com/@username/video/1234567890",
  "authorHandle": "@username",
  "authorName": "Creator Name",
  "description": "Sample caption #tiktok #viral",
  "hashtags": ["#tiktok", "#viral"],
  "likes": "12450",
  "comments": "312",
  "shares": "98",
  "bookmarks": "44",
  "views": "245000",
  "music": "Original sound",
  "pageTitle": "TikTok - Make Your Day",
  "scrapedAt": "2026-01-31T12:00:00.000Z"
}

---

🧠 How it works (high level)

1. Launches a headless Chrome browser via Playwright

2. Loads the TikTok page and waits for hydration

3. Triggers lazy-loaded UI elements via scrolling and hover

4. Extracts engagement stats from TikTok’s internal JSON state

5. Applies DOM-based fallbacks if JSON data is unavailable

6. Saves results to the Apify dataset

---

⚠️ Limitations & notes

• This Actor does not discover new videos — it only processes provided URLs

• TikTok UI and data structures may change over time

• Private, deleted, or region-restricted videos may return limited data

• Very large URL batches should be split across multiple runs

---

✅ Best practices

• Use residential proxies (default setting)

• Avoid running very large batches in parallel

• Expect occasional missing metrics due to TikTok restrictions

---

📄 License & usage

Use responsibly and ensure compliance with TikTok’s terms of service and applicable laws in your jurisdiction.

---

In test mode, the actor runs in validation mode and does not scrape real TikTok data.