TikTok Video Downloader

Download TikTok videos as MP4 files and extract comprehensive metadata from any TikTok video, profile, trending feed, hashtag, or sound. Scrape bulk videos, save video files and thumbnails, and get structured JSON data — all in one run.

Why use TikTok Video Downloader?

• Download actual MP4 video files — not just metadata. Get video files saved directly to your Key-Value Store
• Bulk video downloader — scrape and download multiple videos from profiles, trending feeds, hashtags, and sounds in a single run
• Multiple scraping modes — single video, user profile, trending feed, hashtag, or sound
• Fast files-only mode — skip metadata extraction and just download video/cover files directly (faster, cheaper)
• Auto URL detection — paste any TikTok link and the actor automatically detects the type
• Built-in proxy support — uses Apify Proxy with residential IPs to bypass rate limits
• Anti-bot bypass — powered by Playwright browser automation with stealth mode
• Structured JSON output — clean dataset with video stats, author info, music details, and hashtags

What data can TikTok Video Downloader extract?

Field	Type	Description
Video URL	String	Full TikTok video URL
Video file	MP4 (binary)	Downloaded video file in Key-Value Store
Cover image	JPEG/PNG (binary)	Video thumbnail in Key-Value Store (optional)
Description	String	Video caption or text
Author username	String	TikTok @username
Author nickname	String	Display name
Verified	Boolean	Whether the author is verified
Avatar URL	String	Author profile picture URL
Play count	Number	Total video views
Like count	Number	Total likes
Share count	Number	Total shares
Comment count	Number	Total comments
Music title	String	Audio/song title
Music author	String	Audio/song creator
Music URL	String	Direct audio file URL
Hashtags	Array	Hashtags used in the video
Duration	Number	Video length in seconds
Create time	String	Video upload timestamp

Use Cases

• Social media managers — bulk download competitor content and trending TikTok videos for analysis
• Marketers and researchers — scrape TikTok engagement metrics, trending content, and hashtag performance data
• Data scientists — collect structured TikTok metadata for sentiment analysis, trend forecasting, and research
• Content creators — back up your own TikTok videos and track engagement over time
• Developers — integrate TikTok data into your apps via structured JSON API output

How to scrape TikTok videos

1. Add your TikTok URL — paste a video, profile, hashtag, or trending link
2. Choose a mode — auto-detect, single video, profile, trending, hashtag, or sound
3. Configure downloads — enable video and/or cover image downloads
4. Run the actor — results are saved to the dataset and files to Key-Value Store

Supported URL formats

• Single video: https://www.tiktok.com/@username/video/123456
• User profile: https://www.tiktok.com/@username
• Hashtag: https://www.tiktok.com/t/hashtag
• Trending: Use mode "trending" (no URL needed)

How much does it cost?

This actor uses Pay Per Event pricing at $0.003 per video scraped. You only pay for what you use — Apify compute costs are billed separately.

Videos	Actor Cost
100	$0.30
1,000	$3.00
10,000	$30.00

The free Apify tier includes $5 free credit to get started. Downloading video files uses additional compute resources — use files-only mode when you only need downloads, or disable downloads for metadata-only scraping to save on costs.

Input

See the Input tab for full configuration options. Key settings:

• Start URLs — TikTok URLs to scrape (video, profile, or hashtag links)
• Scraping Mode — auto-detect, single video, profile, trending, hashtag, or sound
• Output mode — "full" for metadata + downloads, "files_only" for downloads only (faster)
• Max results — limit how many videos to scrape per run (0 = unlimited)
• Download videos — save MP4 files to Key-Value Store (enabled by default)
• Download covers — save thumbnail images to Key-Value Store (disabled by default)
• Proxy configuration — recommended for large scraping jobs. Use residential proxies for best results.

Output

Each video is pushed to the dataset as a JSON object. You can download the dataset in JSON, CSV, or Excel format.

Downloaded video files are stored in the Key-Value Store with keys like video-1234567890.mp4.

Sample output

{
  "id": "7106594312292453675",
  "url": "https://www.tiktok.com/@tiktok/video/7106594312292453675",
  "description": "Check out TikTok's Minecraft community!",
  "author": {
    "id": "107955",
    "username": "tiktok",
    "nickname": "TikTok",
    "verified": true
  },
  "stats": {
    "playCount": 561600,
    "likeCount": 98700,
    "commentCount": 1342
  },
  "music": {
    "title": "original sound",
    "author": "TikTok"
  },
  "videoKey": "video-7106594312292453675"
}

Tips

• Use residential proxies for best results — TikTok aggressively blocks datacenter IPs
• Use files-only mode to skip metadata when you just need downloads — saves time and cost
• Disable video downloads for metadata-only scraping — saves time and storage costs
• Start with maxItems: 10 when testing a new profile or hashtag
• Trending mode does not require a start URL — just select "trending" as the mode

FAQ

Is this actor legal?

This actor only extracts publicly available data that TikTok displays to any visitor. It does not access private accounts, messages, or any authenticated content. Always ensure your use case complies with TikTok's Terms of Service and applicable data protection regulations in your jurisdiction.

Why do I need a proxy?

TikTok has strong anti-bot protections. Using Apify's residential proxy rotation helps avoid rate limits and CAPTCHAs. Without a proxy, large scraping jobs may get blocked.

Can I bulk download all videos from a TikTok profile?

Yes. Select "profile_videos" mode and paste a profile URL. The actor will iterate through all videos on the profile. Use maxItems to limit how many to download.

How to scrape TikTok trending videos?

Select "trending" mode — no URL is needed. The actor will fetch the current trending feed and scrape videos from it.

Can I scrape videos by hashtag?

Yes. Paste a hashtag URL like https://www.tiktok.com/t/minecraft and select "hashtag_videos" mode to scrape all videos under that hashtag.

Why is my video download empty?

Some TikTok videos may have download restrictions or the video URL may have expired. Try re-running the actor or enabling proxy rotation for better reliability.

What's the difference between "full" and "files_only" mode?

"Full" mode scrapes metadata (description, stats, author info, music, etc.) and pushes it to the dataset, plus downloads files. "Files_only" mode skips all metadata extraction — it just downloads the MP4 and/or cover files directly. Use files_only when you only need the video files and want faster, cheaper runs.

Can I scrape private profiles?

No. This actor only works with publicly available TikTok content.

Support

If you encounter any issues, please visit the Issues tab and report the problem. We actively monitor and respond to all issues.