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

{
  "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:

{
  "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

// 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:

{
  "videoUrls": ["..."],
  "storageName": "project-alpha-week1"
}

Then for week 2:

{
  "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