Youtube Video Downloader

YouTube Video Downloader 🎬

YouTube Video Downloader helps you download YouTube videos in your chosen resolution and get direct download links—plus optional storage upload for added convenience. Whether you’re looking to download YouTube videos, generate assets for content workflows, or build a repeatable YouTube downloader online pipeline, this actor streamlines the process with structured results you can reuse at scale.

---

Why choose YouTube Video Downloader?

Feature	Benefit
✅ Video URL list input	Process multiple YouTube video URLs in a single run
✅ Choose your resolution	Get the best available match for 8K, 4K, 2K, 1080p, 720p, 480p, or 360p
✅ Direct downloadable links	Outputs downloadable_video_link and downloadable_audio_link where available
✅ Resilient retries and fallbacks	Handles failures with retries and fallback extraction strategies for better reliability
✅ Proxy support	Built-in proxy configuration to improve consistency when downloading at scale
✅ Structured dataset output	Writes a dataset with consistently labeled fields for easy analysis and exports

---

Key features

• 🎥 Resolution-aware downloading: Supports 8K, 4K, 2K, 1080p, 720p, 480p, and 360p selections via desired_resolution
• 🔗 Video and audio download links: Returns downloadable_video_link and downloadable_audio_link when usable formats are found
• 🧾 Complete video metadata: Includes fields like title, author, thumbnail, duration, channel, and video_type
• 🛡️ Reliability-focused handling: Includes retries and fallback logic to improve success rate across different URLs
• 🌐 Flexible input: Accepts video_urls as a list, so you can run batch download YouTube to MP4 and download YouTube to MP3 style workflows (video/audio links depend on available formats)
• 💾 Optional storage upload: If you enable upload_video_to_apify, the actor uploads the 360p video to Apify Key-Value Store and returns apify_storage_url
• 📊 Progressive format info for uploads: When storage upload is enabled, it uses best_progressive_format_info to download the uploadable asset

---

Input

Provide input via an input.json file. Example structure:

{
  "video_urls": [
    {
      "url": "https://youtu.be/YZ84iQrbYjw?si=_8-Y64fWSGA82dOz"
    },
    {
      "url": "https://youtube.com/shorts/s9YG00vZ09c?si=fMtwzCARAHbcuJQu"
    }
  ],
  "desired_resolution": "2k",
  "upload_video_to_apify": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Fields

Field	Required	Description
video_urls	✅	List of YouTube video URLs to process. This is the only required input.
desired_resolution	❌	Pick the resolution you want: 8K, 4K, 2K, 1080p, 720p, 480p, or 360p. Default is 2k.
proxyConfiguration	❌	Proxy settings (optional). If you don’t select a proxy, the actor automatically uses residential proxy as a recommended default approach. Only Residential (default) and Own proxies are available.
upload_video_to_apify	❌	If enabled, the actor uploads the 360p video to Apify Key-Value Store and returns a download link. This may be slow. Default: false.

---

Output

The actor saves results in the Apify dataset as JSON records (one per input URL) via await Actor.push_data(results_list).

Example output (single record):

[
  {
    "original_url": "https://youtu.be/YZ84iQrbYjw?si=_8-Y64fWSGA82dOz",
    "requested_resolution": "2k",
    "provided_resolution": 1440,
    "download_type": "progressive",
    "downloadable_video_link": {
      "mp4": "https://example.com/video.mp4"
    },
    "downloadable_audio_link": "https://example.com/audio.m4a",
    "title": "N/A",
    "author": "N/A",
    "thumbnail": "N/A",
    "duration": "N/A",
    "channel": "N/A",
    "source": "youtube",
    "video_type": "Video",
    "note": "Requested 1440p found.",
    "prog_video_type": "Video+Audio",
    "prog_resolution": "1440p",
    "prog_video_format": "N/A",
    "prog_downloadable_link": {
      "url": "https://example.com/best-prog.mp4"
    },
    "best_progressive_format_info": {
      "resolution": 1440,
      "format": "mp4",
      "url": "https://example.com/best-prog.mp4",
      "format_id": "N/A",
      "bitrate_kbps": 0
    },
    "apify_storage_url": "https://example.com/apify-storage-link",
    "storage_note": "Upload successful",
    "status": "SUCCEEDED"
  }
]

Output Fields

Field	Type	Description
original_url	string	The YouTube URL that was processed
requested_resolution	string	The resolution requested via desired_resolution
provided_resolution	number	The height actually provided for the downloadable video format
download_type	string	The download type chosen for downloadable_video_link (for example, whether it’s progressive or video-only)
downloadable_video_link	object	Direct downloadable video link (keyed by extension like mp4)
downloadable_audio_link	string	Direct downloadable audio link when available
apify_storage_url	string | null	Public URL to the uploaded video in Apify Key-Value Store (only when storage upload is enabled and succeeds)
note	string	A human-readable note about resolution selection (e.g., requested resolution found vs closest provided)
prog_video_type	string	Progressive download type label used for the progressive format info
prog_resolution	string	Progressive resolution label (e.g., 1440p)
prog_video_format	string	Progressive format extension used for progressive downloading
prog_downloadable_link	object	Download link for the progressive format ({"url": ...})
title	string	Video title
author	string	Video author/uploader
thumbnail	string	Thumbnail URL
duration	string | number	Duration formatted via format_duration
channel	string	Channel name (or uploader if channel is not present)
source	string	Data source label (youtube)
video_type	string	Either Shorts (duration < 61) or Video
status	string	Processing status: SUCCEEDED or failure marker depending on the run
error	string	Present on failures (when download/processing fails for a URL)

💡 Export formats: In Apify, you can export the resulting dataset to common formats like JSON/CSV from the dataset UI (depending on your needs).

---

How to use YouTube Video Downloader (via Apify Console)

1. Open Apify Console: Go to console.apify.com and sign in.
2. Find the actor: Search for YouTube Video Downloader and open its actor page.
3. Configure INPUT: In the INPUT section, add your video_urls (a list of YouTube links).
4. Choose resolution (optional): Set desired_resolution to one of: 8k, 4k, 2k, 1080p, 720p, 480p, 360p (default is 2k).
5. Decide on storage upload (optional):
   If you enable Upload Video to Storage (upload_video_to_apify: true), the actor uploads the 360p video to Apify storage and returns apify_storage_url. Longer videos can take more time.
6. (Optional) Proxy settings: If you configure proxyConfiguration, use it when needed. If you don’t select a proxy, the actor uses residential as the recommended default approach.
7. Run the actor: Click Run. Watch the logs—if a download fails (especially for long videos), you can re-run with the failed URL(s).
8. Access results: When finished, open the dataset under OUTPUT and export your results (JSON/CSV) for your workflow.

No coding required—get direct YouTube to MP4 downloader and YouTube MP3 downloader style links in minutes.

---

Advanced features & SEO optimization

• 🔍 Engineered for YouTube video download workflows: Built for recurring “download YouTube video” tasks where you want consistent output fields for downstream processing
• 📌 Resolution selection with fallback: If the exact requested height isn’t available, it provides the closest possible option and records it in note + provided_resolution
• 🛠️ Storage-ready automation: When you enable upload_video_to_apify, you get apify_storage_url to plug into content pipelines that prefer stored assets over transient links
• 🧠 Metadata included automatically: Helps you label assets quickly (title, author, thumbnail, duration, channel, and video_type)
• 🔄 Resilience for long batches: Retries and fallbacks are included to improve success when downloading lots of URLs, including Shorts and standard videos

---

Best use cases

• 📈 Content teams repurposing assets: Download videos in a consistent resolution for editing, archiving, and batch publishing
• 🎯 SEO and research workflows: Build a structured dataset of video metadata plus direct downloadable links to speed up analysis
• 🎬 Creator ops & media libraries: Store 360p versions in Apify Key-Value Store using upload_video_to_apify for stable access
• 🧾 Data analysts assembling link datasets: Use dataset fields like duration, channel, video_type, and provided_resolution to categorize results
• 💻 Automation pipelines for YouTube downloader online: Integrate outputs into systems that require structured JSON for YouTube video download requests
• 🗂️ Batch asset production: Process many video_urls in one run to support scalable “download YouTube to MP4” style workflows

---

Technical specifications

• Supported Input Formats

  • ✅ video_urls as a list (each item is a YouTube URL you want to process)
  • ✅ Optional desired_resolution
  • ✅ Optional proxyConfiguration
  • ✅ Optional upload_video_to_apify for storage upload (uploads the 360p video)

• Proxy Support

  • ✅ Uses the configured proxy setup from proxyConfiguration
  • ✅ Has an automatic recommended approach when no proxy is selected

• Retry Mechanism

  • ✅ Retries are used to improve reliability when processing/downloading fails

• Dataset Structure

  • ✅ One JSON record per input URL pushed via Actor.push_data(results_list)
  • ✅ Includes core metadata + direct link fields and (optionally) storage link fields

• Limitations

  • ❌ Storage upload may be slower, especially for longer videos
  • ❌ If a download fails, re-running with the failed URL(s) typically resolves it

---

FAQ

Can I download YouTube videos in different qualities (HD / 4K / 8K)?

✅ Yes. Use desired_resolution to request 8k, 4k, 2k, 1080p, 720p, 480p, or 360p. The output includes provided_resolution and a note explaining whether the exact resolution was found.

Will it also provide audio download links?

✅ It can. The actor outputs downloadable_audio_link when downloadable audio formats are available for the video.

What happens if I enable “Upload Video to Storage”?

✅ If upload_video_to_apify is enabled, the actor uploads the 360p video to Apify storage and provides apify_storage_url. It may take longer for long videos.

Do I need to use a proxy?

✅ Not necessarily. If you don’t set proxyConfiguration, the actor uses a residential proxy approach as the recommended default. You can also configure proxies via proxyConfiguration when you need it.

How do I handle failed downloads?

✅ If a download fails (especially for long videos), simply re-run the actor with the failed URL(s). It usually works on the second try.

Where can I find the download links after the run?

✅ The direct links are returned in the dataset fields: downloadable_video_link and downloadable_audio_link. If storage upload is enabled, you’ll also get apify_storage_url.

Is this actor suitable for batch downloading?

✅ Yes. Provide multiple URLs in video_urls and the actor processes them in a loop, pushing results to the dataset at the end.

Can I export the results to JSON or CSV?

✅ Yes. After the run, you can open the dataset in Apify Console and export the data in formats supported by Apify’s dataset UI.

---

Support & feature requests

Have feedback or ideas to improve this YouTube Video Downloader—especially for download YouTube videos at scale?

• 💡 Feature Requests: For example, CSV-ready outputs, additional format selection options, or tighter integration steps for “best YouTube video downloader” workflows. Share your ideas and we’ll consider them for future updates.
• 📧 Contact: Reach out via dataforleads@gmail.com.

User feedback directly shapes the roadmap for this YouTube video downloader actor.

---

YouTube Video Downloader — Final thoughts

The YouTube Video Downloader gives you structured, resolution-aware downloads and optional storage links in a format you can reuse instantly. If you’re after the most practical YouTube video download workflow, run it with your video_urls and export clean JSON results.

---

Disclaimer

This actor accesses only publicly accessible sources. It does not access private profiles, authenticated content, or password-protected pages.

You are responsible for complying with applicable laws (including GDPR/CCPA where relevant), privacy requirements, spam regulations, and each platform’s terms of service. For any data-removal requests, contact dataforleads@gmail.com.

Please use this tool responsibly, ethically, and for legitimate purposes only.