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: json { "searchMode": "url", "queryInput": "https://www.tiktok.com/@user/video/1234567890", "useProxy": false } ### Hashtag Mode (searchMode: "hashtag") Loads https://www.tiktok.com/tag/ in stealth Playwright, scrolls to reveal posts, and captures /video/ links. Cookies are recommended for niche or geo-restricted tags. Example: json { "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. json { "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