YouTube Music Downloader

Overview

An Apify actor for downloading music from YouTube Music. It supports downloading both video and audio in formats like MP4 and MP3, with configurable quality and proxy support to avoid IP blocking.

Key Features

• Download Video: Fetch and store high-quality music videos from YouTube Music.
• Download Audio: Extract and save audio tracks, primarily as MP3 files.
• Format Options: Choose between MP3 (audio) and MP4 (video) formats.
• Proxy Support: Configure a proxy to help prevent IP blocking by YouTube.
• Structured Storage: Downloads and their links are stored in separate Apify datasets for easy management.

Important Notes

• Proxy: Using a reliable proxy is recommended to avoid IP blocking, though it may increase download times.
• macOS QuickTime: Downloaded MP4 videos may not play in QuickTime Player due to codec issues. Use VLC or convert the file with FFmpeg.
• Storage: Each run stores the download link in one dataset and the actual media file in another.

Input Parameters

Configure the actor with these input fields:

• url (string, required): The full YouTube Music video or track URL.
• onlyAudio (boolean): Set to true to download audio only (e.g., MP3). Default is false for video.
• useFFmpeg (boolean): Set to true to use FFmpeg for processing. Recommended for reliability.
• proxy (object, optional): Proxy configuration object. Using useApifyProxy is a good option.

Output

On a successful run, the actor stores an item in the dataset with this structure:

{
  "download_link": "your_download_link_here",
  "status_code": 200
}

The actual media file is saved to a separate Apify Key-Value Store, accessible via the download_link.

How to Use

Here’s a basic Python example using the Apify Client:

from apify_client import ApifyClient

# Initialize client with your API token
client = ApifyClient('your_apify_api_token')

# Prepare the actor input
run_input = {
    "url": "https://music.youtube.com/watch?v=...",
    "onlyAudio": False,  # Set True for MP3
    "useFFmpeg": True,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

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

# Fetch the dataset items to get the download link
dataset_client = client.dataset(run['defaultDatasetId'])
items = dataset_client.list_items().items

# Download the file using the link from the dataset
if items:
    download_link = items[0]['download_link']
    # Use requests or similar to fetch the file from download_link