Tiktok Video Downloader

Apify Actor for downloading videos from TikTok by providing URLs or searching by hashtags, user profiles, or keywords.

What does this actor do?

This actor downloads videos from TikTok with multiple search modes. It extracts metadata and stores the videos in the key-value store with direct download links in the dataset.

Features

• Download videos from provided TikTok URLs
• Search videos by hashtags
• Search videos from user profiles
• Search videos by keywords
• Extract video metadata
• Store videos in key-value store
• Provide direct download URLs in dataset

Input

Parameter	Type	Required	Description
searchMode	string	Required	url or hashtag. Default: url. User profile and keyword modes are temporarily disabled.
queryInput	string	Required	Paste video URLs (comma, newline, or JSON array) for url mode, or a hashtag without # for hashtag mode.
downloadMode	string	Optional	Choose whether to download full videos or extract metadata only. Default: videos
quality	string	Optional	Preferred video quality/format. Default: best
maxVideos	integer	Optional	Maximum number of videos to process (1-100). Default: 10
useProxy	boolean	Optional	Whether to use proxy for downloading. Disable for faster downloads. Default: true
maxDownloadSpeed	integer	Optional	Limit download speed in KB/s. Set to 0 for unlimited speed. Default: 0
cookies	string	Optional	Cookies to bypass authentication
proxyConfiguration	object	Optional	Proxy settings (only used when useProxy is enabled)

*Note: Supply queryInput for every run. Only direct URLs and hashtags are supported at the moment.

How It Works

Direct URL Mode (Recommended) ✅

1. You provide TikTok video URLs
2. Actor downloads videos using yt-dlp
3. Videos stored in key-value store with download links

Search Modes

Direct URL Mode (searchMode: "url") - 🎯 Recommended

Paste one or more TikTok links into queryInput (comma, newline, or JSON array). The actor forwards those URLs straight to yt-dlp for downloading/storage.

Example:

{
  "searchMode": "url",
  "queryInput": "https://www.tiktok.com/@user/video/1234567890",
  "useProxy": false
}

Hashtag Mode (searchMode: "hashtag")

Loads https://www.tiktok.com/tag/

Example:

{
  "searchMode": "hashtag",
  "queryInput": "fyp",
  "maxVideos": 20,
  "useProxy": true
}

Tips:

• Provide TikTok cookies for better results
• Enable proxy to avoid rate limiting
• Try popular hashtags first (e.g., "fyp", "viral")

⚠️ User profile and keyword searches are temporarily disabled due to TikTok anti-bot changes. Please provide direct video URLs or use hashtag mode.

Performance Optimization

For faster downloads, consider these options:

• Disable Proxy: Set useProxy to false for direct downloads (recommended for most users)
• Speed Limiting: Use maxDownloadSpeed to prevent extremely slow downloads from hanging
• Format Selection: The actor automatically prefers H.264 codecs for faster downloads and better compatibility

Troubleshooting

"No videos found for hashtag"

Possible causes:

• TikTok may require authentication (login) to view certain content
• The hashtag doesn't exist or has no public videos
• TikTok's API restrictions or rate limiting
• Geographic restrictions

Solutions:

1. Provide cookies: Export your TikTok cookies from your browser and paste them in the "TikTok Cookies" field
2. Enable proxy: Make sure "Use Proxy" is enabled
3. Use Direct URL mode: Instead of searching, provide specific video URLs
4. Try popular content: Test with popular hashtags like "fyp" or "viral" first

How to get TikTok cookies

1. Open TikTok in your browser and log in
2. Open browser Developer Tools (F12)
3. Go to Application/Storage tab → Cookies → https://www.tiktok.com
4. Copy all cookies as JSON or Netscape format
5. Paste into the "TikTok Cookies" field

Downloads are very slow

Solutions:

1. Disable proxy: Set useProxy to false
2. Set speed limit: Use maxDownloadSpeed parameter (e.g., 500 KB/s)
3. Use H.264 format: The actor automatically prefers H.264

Some videos fail to download

Possible causes:

• Video is private, deleted, or region-locked
• Bot detection by TikTok
• Network issues

Solutions:

• Provide authentication cookies
• Enable proxy
• Reduce maxVideos to avoid rate limiting
• Wait 1-2 minutes between runs

Output

The actor outputs metadata for each processed video to the dataset, including a direct download URL for the stored video.

{
  "video_id": "VIDEO_ID",
  "title": "Video Title",
  "author": "Creator Name",
  "url": "https://www.tiktok.com/@user/video/VIDEO_ID",
  "download_url": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/VIDEO_ID.mp4",
  "file_size": 1234567,
  "file_extension": "mp4",
  "quality_requested": "best",
  "downloaded_format": "h264",
  "collected_at": "2025-11-07T12:00:00"
}

Resources

• Apify Platform Documentation