TikTok Data Scraper ⚡

Super-fast TikTok Data Scraper to collect trending videos, search results, profiles, comments, music data, and direct video details by URL in HD. Built for Apify Actors, designed for scale, and easy to configure.

---

Why use this TikTok Data Scraper? 🚀

• ✅ High coverage: Trending, Search, Profiles, Comments, Music, and Video-by-URL (HD)
• ✅ Scalable: Batched writes, retries, and key rotation for resilient large runs
• ✅ Clean JSON output: Structured, ready for analytics, dashboards, and pipelines

Target keyword: TikTok Data Scraper

Related keywords: TikTok scraping, TikTok API alternative, TikTok trends, TikTok user data, TikTok comments scraper, TikTok music scraper, TikTok video downloader HD, TikTok analytics, social media data extraction, TikTok crawler.

---

Table of Contents 📚

• Features
• How it works
• Project structure
• Quick start
• Input configuration
• Example inputs
• Example outputs
• Best practices
• FAQ
• Best hashtags
• Changelog

---

Features ✨

Module	What you get	Input switches
Trending feed	Popular videos by region	trending_enabled, trending_region, trending_count
Search	Videos, photos, challenges, users by keyword	search_enabled, search_keywords, search_*
Profiles	Posts, profile info, followers, following	user_enabled, user_*
Comments	Top-level comments and replies	comment_enabled, comment_*
Music	Music info and posts	music_enabled, music_*
Video by URL (HD)	Direct video details and media links	video_enabled, video_urls, video_hd

This TikTok Data Scraper is ideal for marketing analytics, creator dashboards, research, content curation, and social media intelligence.

---

How it works 🧠

• The Actor orchestrates multiple TikTok data endpoints defined in main.js.
• Requests are retried with small backoffs and key rotation for reliability.
• Results are buffered and pushed to the default dataset for performance.

---

Input configuration ⚙️

Reference of commonly used inputs.

Group	Key	Type	Default	Description
Trending	trending_enabled	boolean	false	Enable trending feed
	trending_region	string	us	Region code
	trending_count	integer	10	Number of items
Search	search_enabled	boolean	false	Enable search
	search_keywords	array[string]	—	Keywords list
	search_region	string	us	Region for feed/photo search
	search_videos_per_keyword	integer	10	Items per keyword
	search_enable_user	boolean	false	Include user search
	search_enable_photo	boolean	false	Include photo search
	search_enable_challenge	boolean	false	Include challenge search
	search_publish_time	integer	0	Publish time filter (epoch)
	search_sort_type	integer	0	Sort type
Profiles	user_enabled	boolean	false	Enable profile data
	user_ids	array[string]	—	Numeric user IDs
	user_videos_per_user	integer	10	Max posts per user
	user_fetch_posts	boolean	true	Fetch user posts
	user_fetch_info	boolean	true	Fetch profile info
	user_fetch_followers	boolean	false	Fetch followers
	user_fetch_following	boolean	false	Fetch following
	user_fetch_favorite	boolean	false	Fetch favorites
	user_time	integer	0	Pagination time
Comments	comment_enabled	boolean	false	Enable comments
	comment_video_urls	array[string]	—	Video URLs to fetch comments for
	comment_videos_per_url	integer	10	Max comments per video
	comment_reply_video_id	string	—	Video ID for replies
	comment_reply_comment_id	string	—	Comment ID for replies
Music	music_enabled	boolean	false	Enable music module
	music_ids	array[string]	—	Music IDs for posts
	music_urls	array[string]	—	Music URLs for info
	music_videos_per_music	integer	10	Max posts per music
Video URL	video_enabled	boolean	false	Enable direct video-by-URL
	video_urls	array[string]	—	TikTok video page URLs
	video_hd	boolean	true	Request HD when available

---

Example inputs 📥

1) Direct Video-by-URL (HD)

{
  "video_enabled": true,
  "video_urls": [
    "https://www.tiktok.com/@tiktok/video/7516594811734854943"
  ],
  "video_hd": true
}

2) Trending + Search

{
  "trending_enabled": true,
  "trending_region": "us",
  "trending_count": 20,

  "search_enabled": true,
  "search_keywords": ["recipes", "travel"],
  "search_region": "us",
  "search_videos_per_keyword": 10,
  "search_enable_user": true
}

3) Profiles + Comments

{
  "user_enabled": true,
  "user_ids": ["7098999999999999999"],
  "user_fetch_posts": true,
  "user_fetch_info": true,

  "comment_enabled": true,
  "comment_video_urls": [
    "https://www.tiktok.com/@someuser/video/7123456789012345678"
  ],
  "comment_videos_per_url": 25
}

---

Example outputs 📤

Results are written to the default dataset as structured JSON.

• Video by URL (source: "video", subtype: "by_url")

{
  "source": "video",
  "subtype": "by_url",
  "url": "https://www.tiktok.com/@tiktok/video/7516594811734854943",
  "hd": true,
  "data": { /* provider response with video details and media links */ }
}

• Trending (source: "trending")

{
  "source": "trending",
  "region": "us",
  "aweme_id": "xxxx",
  "desc": "...",
  "author": { /* ... */ },
  "statistics": { /* ... */ }
}

• Search (videos) (source: "search", subtype: "feed_search")

{
  "source": "search",
  "subtype": "feed_search",
  "keywords": "recipes",
  "aweme_id": "xxxx",
  "desc": "..."
}

• Summary item at the end:

{
  "success": true,
  "pages_fetched": 3,
  "total_pushed": 421,
  "fetched_at": "2025-01-01T12:34:56.000Z"
}

---

Best practices 🧩

• Keep count small when testing to validate shapes and speed.
• Use the example inputs to start with a focused data slice.

---

FAQ ❓

• Is login required?
  • No. This TikTok Data Scraper uses public data.
• Can I get HD media links?
  • Yes, enable video_enabled and set video_hd to true.
• Where do results go?
  • The default Apify dataset for the run.

---

Best hashtags for discoverability 🏷️

#TikTokDataScraper #TikTokScraper #TikTokAnalytics #SocialData #DataScraping #SocialMediaTools #GrowthHacking #MarketingAnalytics #CreatorEconomy #OpenData

---

Changelog 📦

• Added direct Video-by-URL (HD) support via video_enabled, video_urls, video_hd.
• Expanded input schema with modular controls for Search, Profiles, Comments, and Music.

---