TikTok Downloader

Overview

An Apify actor for downloading videos and audio from TikTok. It handles the download process and provides direct links to the media files, supporting different formats and quality options.

Key Features

• Download Video: Fetches and stores high-quality TikTok videos.
• Download Audio: Extracts and saves the audio track separately, for example as an MP3.
• Format Support: Outputs media in MP4 (video) or MP3 (audio) formats.
• Proxy Integration: Built-in support for using proxies to help avoid IP blocking by TikTok.

Input Parameters

Configure the actor run with these inputs:

• url (required): The full URL of the TikTok video to download.
• audioOnly: Boolean (true/false). Set to true to download only the audio track.
• ffmpeg: Boolean (true/false). Specifies whether to use FFmpeg for processing the media file.
• proxy (optional): Configuration object for Apify Proxy. Using a residential proxy is recommended to prevent blocks.
  json { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }

Output

On a successful run, the actor stores an item in its dataset with the download link.

{
  "download_link": "https://apify.com/.../file.mp4?fpr=python_automation",
  "status_code": 200
}

• The download_link is a temporary, direct URL to fetch the media file.
• The actual video/audio file is stored in a separate key-value store for direct access.

How to Use

Here’s a basic example using the Apify Client for Python.

from apify_client import ApifyClient

# Initialize the client
client = ApifyClient('YOUR_APIFY_API_TOKEN')

# Prepare the actor input
run_input = {
    "url": "https://www.tiktok.com/@user/video/123456789",
    "audioOnly": False,
    "ffmpeg": True,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

# Run the actor
run = client.actor('apilabs/tiktok-downloader').call(run_input=run_input)

# Fetch the result from the dataset
dataset_items = client.dataset(run['defaultDatasetId']).list_items().items
download_url = dataset_items[0]['download_link']

# You can now download the file from `download_url`

Important Notes

• Proxy: Using a reliable proxy (like RESIDENTIAL) is strongly advised to avoid IP-based rate limiting or blocking by TikTok.
• macOS QuickTime: Downloaded MP4 videos may not play in QuickTime Player due to codec differences. Use VLC or another media player, or convert the file using FFmpeg.
• Storage: The download link and the actual media file are stored separately in Apify storage (dataset and key-value store, respectively).