YouTube Video Downloader Pro - Fast & Reliable

The YouTube downloader that actually works. Multi-engine architecture ensures your downloads succeed even when other tools fail. No API keys, no proxies, no setup headaches. Just paste the URL.

Why This One?

Most YouTube downloaders on Apify break constantly. They rely on a single method that YouTube patches every few weeks. This actor uses multiple independent download engines with automatic failover — if one engine is down, it seamlessly switches to the next. You get your video, every time.

Key Features

Feature	Description
Multi-Engine Failover	Multiple independent download engines with automatic retry
Up to 1080p	Full HD quality downloads in MP4 format
Fast Processing	Most videos ready in under 30 seconds
No API Keys	Zero configuration required — just provide a YouTube URL
Geo-Restriction Bypass	Auto-detects country and routes through residential proxy
Pay Only on Success	You are only charged when the download succeeds
Metadata Included	Returns title, author, duration, thumbnail alongside the download URL

Quick Start

1. Click Start on this actor's page
2. Paste your YouTube URL in the input field
3. Set your desired quality (480p, 720p, or 1080p)
4. Click Start and wait for the result
5. Copy the downloadUrl from the output

That's it. No tokens, no cookies, no configuration.

Input

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "quality": 1080
}

Field	Type	Required	Description	Default
url	String	Yes	Full YouTube video URL	—
quality	Integer	No	Video quality in pixels (480, 720, or 1080)	1080
proxyConfiguration	Object	No	Proxy settings for geo-restricted videos (see below)	—

Geo-Restricted Videos (Proxy Setup)

Some YouTube videos are only available in specific countries. When the actor encounters a geo-restricted video, it will show:

⚠️  GEO-RESTRICTION DETECTED
This video is not available in the server's region.
Available countries: [US, BR, GB, DE, ...]

🔧 HOW TO FIX: Enable "Residential Proxy" in the actor input settings.
   Go to Input → Proxy configuration → Select "Apify Proxy (residential)".
   The actor will automatically route through the correct country.

To fix this:

1. Go to the actor Input tab
2. Scroll down to Proxy configuration
3. Select Apify Proxy (residential)
4. Re-run the actor

The actor automatically detects which countries have access to the video and routes the download through a residential proxy in one of those countries. No manual country selection needed.

Input example with proxy:

{
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "quality": 1080,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Note: Residential proxies have an additional cost on Apify. The actor only uses the proxy when needed (geo-restricted videos). Non-restricted videos are downloaded directly without proxy to save costs.

Supported URL Formats

All standard YouTube URL formats are supported:

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• https://www.youtube.com/v/VIDEO_ID

Output

The actor returns a JSON object with the download URL and video metadata:

{
  "success": true,
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "downloadUrl": "https://download-server.example.com/video.mp4",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video)",
  "author": "Rick Astley",
  "duration": 213,
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "quality": "1080p"
}

Output Fields

Field	Type	Description
success	Boolean	Whether the download succeeded
url	String	The original YouTube URL you provided
downloadUrl	String	Direct download link for the MP4 file
title	String	Video title
author	String	Channel name
duration	Number	Video duration in seconds
thumbnail	String	URL of the video thumbnail
quality	String	Actual quality of the downloaded video

Use Cases

• Content Archival — Save important videos before they get taken down
• Offline Viewing — Download videos for travel, presentations, or areas with poor connectivity
• Video Editing — Get source material for mashups, compilations, or reaction videos
• Research & Education — Archive educational content for offline study or academic reference
• Social Media — Repurpose YouTube content for other platforms (with permission)
• Backup — Keep personal backups of your own uploaded content

Integrations

This actor can be triggered via:

• Apify API — Call programmatically from any language
• Zapier — Automate downloads based on triggers
• Make (Integromat) — Build complex automation workflows
• Webhooks — Get notified when a download completes
• Scheduled Runs — Download videos on a recurring schedule

API Example (Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('dc_solutions/youtube-video-downloader-pro').call({
  url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
  quality: 1080,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].downloadUrl);

API Example (Python)

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('dc_solutions/youtube-video-downloader-pro').call(
    run_input={
        'url': 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
        'quality': 1080,
    }
)

items = client.dataset(run['defaultDatasetId']).list_items().items
print(items[0]['downloadUrl'])

Pricing

This actor uses pay-per-event pricing. You only pay when a download succeeds — failed attempts are free.

Event	Cost
Successful download	~$0.05 per video
Failed download	Free

No monthly subscription. No hidden fees. Pay only for what works.

FAQ

Q: What video quality can I download? A: Up to 1080p (Full HD) in MP4 format. You can choose between 480p, 720p, and 1080p. The actor will select the best available quality up to your chosen maximum.

Q: How long does a download take? A: Most videos are processed in 10-30 seconds. Longer videos (1+ hour) may take up to 2 minutes.

Q: The download failed with "Geo-restricted video". What do I do? A: Enable Residential Proxy in the input settings. Go to Input → Proxy configuration → Select "Apify Proxy (residential)". The actor will automatically detect the correct country and route through it. Check the logs for the list of available countries.

Q: Can I download private or age-restricted videos? A: Currently, only public YouTube videos are supported. Private, unlisted, and age-restricted videos are not available.

Q: What happens if the download fails? A: You are not charged. The actor uses multiple engines with automatic failover. If all engines fail, the output will show "success": false with an error message.

Q: Are the download URLs permanent? A: Yes! Videos are hosted on Apify Key-Value Store, so the download URL is permanent and doesn't expire.

Q: Can I download multiple videos at once? A: Each actor run processes one video. To download multiple videos, start multiple runs in parallel via the API.

Important Notes

• Download URLs are permanent (hosted on Apify storage)
• Geo-restricted videos require Residential Proxy — the actor will tell you in the logs if this is needed
• Maximum supported quality is 1080p
• Only public YouTube videos are supported
• The actor returns a download URL, not the file itself
• Respect copyright laws and YouTube's Terms of Service when using downloaded content

Support

Found a bug or have a feature request? Open an issue in the Issues tab or reach out through the actor's discussion page.