TikTok Video Downloader A simple and efficient actor that downloads TikTok videos in HD quality and stores them in organized Apify key-value stores for easy access and management. ## 🌟 Features - 🎬 HD Quality Downloads - Automatically downloads videos in highest quality available - 📦 Organized Storage - Save videos to custom-named storage for better organization - 🔗 Multiple URL Formats - Supports all TikTok URL formats (full URLs, short links, etc.) - 📊 Rich Metadata - Extracts video info, author details, and engagement statistics - ⚡ Batch Processing - Download multiple videos in one run - 💾 Easy Access - Videos stored in Apify key-value store, ready to download - 🎯 Simple Setup - Just paste URLs and run! ## 🚀 Quick Start 1. Paste TikTok video URLs you want to download 2. Name your storage (optional) - keeps videos organized 3. Choose quality - HD (recommended) or Standard 4. Run the actor and download videos from Storage tab! ## 📥 Input Configuration ### Required Settings | Field | Type | Description | |-------|------|-------------| | Video URLs | Array | List of TikTok video URLs to download | ### Optional Settings | Field | Type | Default | Description | |-------|------|---------|-------------| | Storage Name | String | tiktok-videos | Custom name for the key-value store (keeps videos organized) | | Download Quality | String | hd | Video quality: hd or standard | ### Example Input json { "videoUrls": [ "https://www.tiktok.com/@username/video/1234567890", "https://vm.tiktok.com/ZMhQxYz12/", "https://www.tiktok.com/@anotheruser/video/9876543210" ], "storageName": "client-campaign-videos", "downloadQuality": "hd" } ## 📤 Output Format Each downloaded video produces a dataset entry: json { "videoUrl": "https://www.tiktok.com/@username/video/1234567890", "videoId": "1234567890", "title": "Amazing video title #viral #fyp", "author": "Creator Name", "authorUsername": "username", "thumbnail": "https://...", "duration": 15, "stats": { "views": 1250000, "likes": 185000, "comments": 2340, "shares": 8920 }, "quality": "HD", "downloadInfo": { "success": true, "storage_key": "1234567890", "storage_name": "client-campaign-videos", "quality": "HD", "file_size": 2458932, "file_size_mb": 2.35 }, "processedAt": "2024-12-18T10:30:45.123456" } ## 💾 Accessing Downloaded Videos ### Method 1: Via Apify Console (Easiest) 1. Go to your actor run page 2. Click on Storage tab 3. Click on Key-Value Stores 4. Find your storage (e.g., "client-campaign-videos") 5. Click on any video file to view or download 6. Videos are named by their video ID (e.g., 1234567890) ### Method 2: Via Apify API javascript // Get storage const store = await Actor.openKeyValueStore('your-storage-name'); // Get video const video = await store.getValue('video-id'); // Download via API const url = `https://api.apify.com/v2/key-value-stores/${storeId}/records/${videoId}?token=${apiToken}`; ## 📦 Custom Storage Names ### Why Use Custom Storage Names? - Organization: Keep different projects/campaigns separate - Easy Access: Quickly find specific video collections - Clean Workflow: Avoid mixing videos from different runs - Team Collaboration: Share specific storages with team members ### Naming Best Practices ✅ Good Names: - project-alpha-videos - client-nike-campaign - viral-trends-dec-2024 - competitor-analysis ❌ Avoid: - Names with spaces (use hyphens instead) - Special characters (only letters, numbers, and hyphens) - Very long names (keep under 63 characters) ### Storage Name Rules - Must start with a letter or number - Can contain letters, numbers, and hyphens - Cannot contain spaces or special characters - Maximum 63 characters - Must be unique within your account ## 🎬 Supported URL Formats The actor supports all TikTok URL formats: - Full URLs: https://www.tiktok.com/@username/video/1234567890 - Short links: https://vm.tiktok.com/ZMhQxYz12/ - Mobile links: https://vt.tiktok.com/ZSjQxYz12/ - Direct video: https://www.tiktok.com/v/1234567890 ## 📊 Quality Options ### HD Quality (Recommended) - Resolution: Up to 1080p - File Size: 2-10 MB per video (varies by duration) - Speed: Slightly slower download - Best For: Professional use, content analysis, archiving ### Standard Quality - Resolution: 720p or lower - File Size: 1-5 MB per video - Speed: Faster download - Best For: Quick previews, bandwidth-limited environments ## 🎯 Use Cases - 📱 Social Media Management - Archive client's viral videos - 📊 Content Research - Download trending videos for analysis - 🎬 Content Creation - Collect inspiration and references - 📈 Competitor Analysis - Archive competitor content - 🎓 Education - Save educational TikToks for offline viewing - 💼 Marketing Campaigns - Backup campaign videos - 🔍 Trend Analysis - Collect videos from specific trends - 🎨 Portfolio Building - Save work samples ## ⚠️ Limitations - Videos must be publicly accessible (not private accounts) - Some region-restricted videos may not download - Deleted or removed videos cannot be downloaded - Maximum file size: Videos under 100 MB recommended - Rate limits: Process videos sequentially to avoid blocks ## 🔧 Troubleshooting ### "Failed to get video info" Possible causes: - Video is private or deleted - URL format is incorrect - Video is region-restricted Solutions: - Verify the video is publicly accessible - Check URL is complete and correct ### "Video download timeout" Possible causes: - Large video file - Slow network connection - Server temporarily busy Solutions: - Retry the download - Try standard quality instead of HD - Split large batches into smaller runs ### "Storage name invalid" Cause: Storage name doesn't meet requirements Solution: Use only letters, numbers, and hyphens. Start with letter/number. ### Downloads succeed but can't find videos Solution: 1. Check the storage name you used 2. Go to Storage → Key-Value Stores 3. Look for your custom storage name 4. Videos are inside that store ## 📝 Best Practices 1. Test First: Start with 2-3 videos to verify everything works 2. Use Descriptive Names: Name your storage based on project/purpose 3. Organize by Project: Create separate storages for different projects 4. Check Video Status: Verify videos are public before downloading 5. Monitor Costs: Keep track of storage usage in Apify Console 6. Batch Wisely: Download 10-50 videos per run for optimal performance 7. Clean Up: Delete old storages you no longer need to save costs 8. Backup Important Videos: Download critical videos to local storage too ## 🔐 Legal & Ethics - ✅ Only download videos for personal/research use - ✅ Respect creator copyright and intellectual property - ✅ Do not redistribute downloaded videos without permission - ✅ Follow TikTok's Terms of Service - ✅ Use downloads for legitimate purposes only - ✅ Give credit to original creators when using content - ✅ Respect privacy - don't download private/sensitive content Disclaimer: Users are responsible for ensuring their use of downloaded videos complies with TikTok's Terms of Service, copyright laws, and applicable regulations. ## 🆘 Support - Issues: Report bugs in Apify Console feedback - Documentation: Apify Documentation - Community: Apify Discord - Storage Help: Key-Value Store Docs ## 💡 Tips & Tricks ### Organizing Multiple Collections Create different storages for different purposes: json { "videoUrls": ["..."], "storageName": "project-alpha-week1" } Then for week 2: json { "videoUrls": ["..."], "storageName": "project-alpha-week2" } ### Sharing Videos with Team 1. Download videos to custom storage 2. Go to Storage → Key-Value Stores → Your Storage 3. Share storage access with team members 4. Everyone can access videos from same storage ## 🏆 Why Choose This Actor? - 🎯 Simple: Just paste URLs and run - 📦 Organized: Custom storage keeps everything neat - ⚡ Fast: Efficient batch downloading - 💾 Accessible: Easy access via Apify Console or API - 🎬 Quality: HD downloads when available - 📊 Complete: Includes video metadata and stats - 💰 Affordable: Optimized for minimal costs - 🔧 Reliable: Error handling and retry logic