TikTok Media Downloader: High-Quality Video & Audio Extraction Tool

This powerful Apify Actor enables seamless downloading of TikTok content in premium quality. Extract videos with or without watermarks and save audio tracks separately with just a few clicks. Perfect for content creators, marketers, and researchers who need reliable TikTok media extraction.

Key capabilities include customizable proxy configuration, adjustable download timeouts, and intelligent retry systems to guarantee successful downloads even with unstable connections. Save time and effort with this comprehensive TikTok media extraction solution.

Features

• Download TikTok videos in highest available quality
• Option to download videos without watermark
• Audio-only download capability
• Flexible download type selection (video, audio, or both)
• Configurable proxy settings with Apify Proxy integration
• Automatic retry mechanism for failed requests
• Configurable download timeouts
• Stores downloaded media securely in Apify storage
• Unique ID generation for each downloaded file
• Preserves video quality and type information

Input Parameters

The Actor accepts the following input parameters:

Required Parameters

• startUrls (Array) - List of TikTok post URLs to process. Example:

  1{
  2      "url": "https://www.tiktok.com/@mysticwild/video/7435475440392850721"
  3  }
  

• downloadType (String) - Specifies what type of media to download:

  • "videoOrAudio" - Download either video or audio (default)
  • "video" - Download video only
  • "audio" - Download audio only

• proxyConfiguration (Object) - Configure proxy settings to avoid rate limiting and improve reliability

  • Recommended: Enable Apify Proxy for optimal performance
  • Supports custom proxy configuration

Optional Parameters

• noWatermarkOnly (Boolean) - When true, only downloads videos without TikTok watermark. If no watermark-free version is available, the download will fail. Default: false
• downloadTimeoutSecs (Integer) - Timeout in seconds for media downloads. Increase this if downloading large files. Default: 500
• maxRequestRetries (Integer) - Number of retry attempts for failed requests. Default: 15

Output

For each successfully processed TikTok post, the Actor saves:

1{
2    "quality": "HD Original",
3    "type": "MP4",
4    "sourceUrl": "https://www.tiktok.com/@mysticwild/video/7435475440392850721",
5    "timestamp": "2025-03-16T01:08:56.082Z",
6    "filename": "a076ba86-10e4-476b-b17e-b63caf0071b3.mp4",
7    "fileUrl": "https://api.apify.com/v2/key-value-stores/[store-id]/records/[filename]",
8    "isAudio": false
9}

• quality: Quality level of the downloaded media (e.g., "HD Original")
• type: File format of the media (e.g., "MP4" for video, "MP3" for audio)
• sourceUrl: Original TikTok post URL
• timestamp: ISO timestamp of when the media was downloaded
• filename: Unique identifier for the file with appropriate extension
• fileUrl: Direct URL to download the media file from Apify's storage
• isAudio: Boolean indicating whether the downloaded file is audio

The media files are stored in the Actor's default key-value store and can be accessed via the provided fileUrl.

Usage

1. Create a new task for this Actor on the Apify platform
2. Configure the input parameters:
   • Add TikTok post URLs to the startUrls array
   • Select desired downloadType (video, audio, or both)
   • Set noWatermarkOnly if you need watermark-free videos
   • Adjust performance settings if needed
   • Set up proxy configuration (required)
3. Run the Actor and wait for the results
4. Access your downloaded media files through the provided URLs in the dataset

Best Practices

1. Proxy Usage: Always configure proxy settings as it's required for reliable operation
2. Download Type: Choose the appropriate downloadType based on your needs:
   • Use videoOrAudio for maximum flexibility
   • Use video when you specifically need video content
   • Use audio for audio-only extraction
3. Timeout Settings: Adjust downloadTimeoutSecs based on expected file sizes
4. Retries: Keep maxRequestRetries high enough to handle temporary failures
5. URL Format: Ensure TikTok URLs are direct links to posts

Resources

• Apify SDK Documentation
• Crawlee Documentation
• Apify Platform Documentation
• Apify Actors Documentation
• Apify Proxy Documentation