TikTok Scraper

🚀 TikTok Scraper is a powerful Apify Actor designed to extract detailed metadata from any TikTok video without using the official TikTok API. It leverages residential proxies ` to bypass restrictions, delivering clean, structured data – perfect for TikTok analytics, market research, influencer tracking, and content strategy.

🔥 Features

• No Official API Required – scrapes public TikTok video data directly, acting as a true TikTok API alternative.
• Smart Proxy Integration – uses Apify residential proxies to avoid IP blocks and TikTok rate limit bypass.
• Cookie Support – optional cookies help bypass login walls for restricted content.
• Comprehensive Metadata – extracts video ID, title, description, author, play count, like count, comment count, share count, duration, music info, upload date, thumbnail, and more.
• Batch Processing – accepts multiple TikTok URLs in a single run.
• Automatic Retry – retries failed requests up to 3 times with exponential backoff.
• Apify Dataset Ready – each video's metadata is pushed as a separate dataset item for easy export (JSON, CSV, XML).
• Async Architecture – fast, non‑blocking async Python scraper built with asyncio.
• Lightweight & Maintainable – built on `, the most reliable TikTok downloader library.

---

⚙️ How It Works

1. Input – Provide one or more TikTok video URLs and optional cookies.
2. Proxy – Actor initialises a residential proxy via Apify Proxy (recommended for TikTok anti-block).
3. Scrape – For each URL, extracts metadata including TikTok video stats, author info, music details, and timestamps.
4. Output – Each video's data is pushed to the Apify Dataset – a perfect TikTok data export solution.
5. Finish – Logs total scraped videos and exits.

---

📥 Input

The Actor accepts a JSON input with the following fields:

Field	Type	Default	Description
urls	string / array	required	One or more TikTok video URLs (e.g., "https://www.tiktok.com/@user/video/1234567890").
cookies	string	null	Optional Netscape format cookies to authenticate (helps with TikTok login bypass).
proxyConfiguration	object	{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}	Proxy settings – TikTok residential proxy recommended.

Example input:

{
  "urls": [
    "https://www.tiktok.com/@tiktok/video/7123456789012345678",
    "https://www.tiktok.com/@user/video/6987654321098765432"
  ],
  "cookies": "# Netscape HTTP Cookie File\n.tiktok.com\tTRUE\t/\tFALSE\t1735689600\tSESSION\tabc123...",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📤 Output

Each dataset item corresponds to one TikTok video:

Field	Type	Description
videoId	string	Unique TikTok video ID.
status	string	"Success" if scraping succeeded.
title	string	Video caption / title.
description	string	Full video description.
authorMeta.name	string	TikTok author username.
playCount	int	Number of views – TikTok view count.
diggCount	int	Number of likes – TikTok like count.
commentCount	int	Number of comments – TikTok comment count.
shareCount	int	Number of shares – TikTok share count.
videoMeta.duration	int	Video duration in seconds.
musicMeta.musicName	string	Name of the background music.
musicMeta.musicAuthor	string	Artist of the background music.
createTimeISO	string	Upload date (YYYYMMDD) – TikTok upload date.
webVideoUrl	string	Original video URL.
thumbnail	string	URL of the video thumbnail.
scrapedAt	string	ISO timestamp of when the data was scraped.

If a video fails after retries, it is simply skipped (no item pushed).

Example output item:

{
  "videoId": "7123456789012345678",
  "status": "Success",
  "title": "This is a trending TikTok video",
  "description": "Check out this amazing content!",
  "authorMeta.name": "tiktok",
  "playCount": 1500000,
  "diggCount": 250000,
  "commentCount": 5000,
  "shareCount": 12000,
  "videoMeta.duration": 45,
  "musicMeta.musicName": "Original Sound",
  "musicMeta.musicAuthor": "Creator",
  "createTimeISO": "20250115",
  "webVideoUrl": "https://www.tiktok.com/@tiktok/video/7123456789012345678",
  "thumbnail": "https://p16-sign.tiktokcdn.com/obj/...",
  "scrapedAt": "2025-02-14T12:34:56Z"
}

---

🧰 Technical Stack

• Proxy: Apify Proxy with RESIDENTIAL group – real peer IPs, high anonymity.
• Platform: Apify Actor – serverless, scalable, integrated with Dataset and Key‑Value Store.
• Deployment: One‑click run on Apify Console or via REST API.

---

🎯 Use Cases

• TikTok Analytics – track video performance metrics and engagement trends.
• Influencer Marketing – monitor creator content and audience engagement.
• Competitor Research – analyse competitor videos and trending content strategies.
• Content Ideation – discover trending sounds, hashtags, and video formats.
• Brand Monitoring – track brand mentions and user-generated content on TikTok.
• Market Research – gather insights on audience preferences and trends.
• Academic Studies – collect TikTok metadata for research on social media trends.
• Social Media Dashboard – integrate TikTok data into analytics platforms.
• Music Analysis – track trending audio and music usage on TikTok.
• Viral Content Tracking – monitor and analyse viral video trends.

---

🚀 Quick Start

1. Open in Apify Console – visit the Actor page and click Try for free.
2. Paste TikTok URL(s) in the input field (one URL or a batch).
3. Add cookies (optional) if accessing restricted content.
4. Enable residential proxies (recommended).
5. Click Start and wait for results.
6. Export – download metadata as JSON, CSV, HTML, or Excel.

You can also call this Actor programmatically via Apify SDK or REST API – ideal for automated pipelines.

---

💎 Why Use This Actor?

Feature	Benefit
✅ No TikTok API limits	Extract unlimited video metadata without API quotas.
✅ Residential proxies	Bypass TikTok anti-bot detection – high success rate.
✅ Batch processing	Scrape multiple videos in one run.
✅ Complete metadata	Get video stats, music info, author details, and more.
✅ Clean schema	Ready for immediate analysis or database ingestion.
✅ Apify ecosystem	Seamless integration with other Actors, triggers, and webhooks.
✅ No login required	Works with public TikTok content – optional cookies for restricted access.

---

⚠️ Important Notes

• TikTok Terms of Service – Use responsibly and at reasonable speed. This Actor is meant for personal, educational, or research use.
• Proxy Credits – Residential proxy usage consumes Apify platform credits. Free tier may have limited availability.
• Rate Limiting – TikTok may rate limit requests. Use reasonable intervals between batches.
• Cookie Format – Cookies should be in Netscape format for proper authentication.
• Library Updates – If TikTok changes its structure, the underlying ` library may need updates. We monitor and maintain regularly.

📦 Changelog

v1.0.0 (February 2025)

• Initial release with residential proxy support.
• Batch processing for multiple TikTok URLs.
• Extracts comprehensive video metadata (stats, music, author info, timestamps).
• Automatic retry with exponential backoff.
• Cookie support for restricted content.
• Full Apify Actor integration.

---

🧑‍💻 Support & Feedback

• Issues & Ideas: Open a ticket on the Apify Actor issue tracker.
• Contributions: Pull requests are welcome via the GitHub repository.
• Documentation: Visit Apify Docs for platform guides.