🎥 YouTube Video Downloader

High-quality, video-only or audio-only or merge video download links and rich metadata from one or multiple YouTube videos — all in a single run, with clean structured output and resolution control.

Extract rich metadata and instant download links for YouTube videos or playlists — fast, clean, and reliable.

✨ Key Features

• ✅ Supports single video & playlist URLs
• ✅ Multiple resolution options (8K → 360p)
• ✅ Clean & structured JSON output
• ✅ Video-only, audio-only & merged links
• ✅ Automatic best-quality fallback
• ✅ Bulk processing supported
• ✅ Ideal for automation & data pipelines

---

🚀 What This Actor Provides

This actor processes YouTube video or playlist URLs and returns:

• 🎬 Direct downloadable video links (video-only)
• 🎧 Separate audio download links
• 🔀 Merged video + audio download links
• 📊 Detailed video metadata
• 🎯 Resolution-based video selection

It is ideal for content archiving, analytics, preview systems, and download automation.

---

🎥 Video Resolution

Choose your desired resolution:

{
  8K
  4K
  2K
  1080p (default)
  720p
  480p
  360p
}

**If the selected resolution is unavailable, the actor **automatically provides the highest available resolution**.

---

📥 Input Example

{
  "videoResolution": "1080p",

  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=wFU2hU7nE0k"
    },
    {
      "url": "https://youtu.be/G5RpJwCJDqc?si=h7DRF_vVVO8IB866"
    }
  ]
}

---

📤 Output Example

[
  {
    "original_url": "https://www.youtube.com/watch?v=wFU2hU7nE0k",
    "requested_resolution": "1080p",
    "provided_resolution": "1080p",
    "title": "How SpaceX Lands Rockets",
    "channel": "Science Explained",
    "duration": "8m 34s",
    "thumbnail": "https://i.ytimg.com/vi/wFU2hU7nE0k/maxresdefault.jpg",
    "downloadable_video_link": "https://example------------------------------------------------------------",
    "downloadable_audio_link": "https://example------------------------------------------------------------",
    "merge_downloadable_video_link": "https://example-------------------------------------------------------",
    "view_count": "2.3M",
    "categories": [
      "Science",
      "Technology"
    ],
    "description": "A detailed explanation of how SpaceX successfully lands reusable rockets.",
    "availability": "public",
    "live_status": "not_live",
    "channel_subscribers": "1.4M",
    "video_filesize": "96.8MB"
  },
  {
    "original_url": "https://youtu.be/G5RpJwCJDqc?si=h7DRF_vVVO8IB866",
    "requested_resolution": "1080p",
    "provided_resolution": "720p",
    "title": "Top 10 Travel Destinations",
    "channel": "World Travel Guide",
    "duration": "5m 12s",
    "thumbnail": "https://i.ytimg.com/vi/G5RpJwCJDqc/maxresdefault.jpg",
    "downloadable_video_link": "https://example-----------------------------------------------------",
    "downloadable_audio_link": "https://example-----------------------------------------------------",
    "merge_downloadable_video_link": "https://example------------------------------------------------",
    "view_count": "850K",
    "categories": [
      "Travel",
      "Lifestyle"
    ],
    "description": "Discover the top 10 travel destinations you should visit this year.",
    "availability": "public",
    "live_status": "not_live",
    "channel_subscribers": "620K",
    "video_filesize": "54.3MB"
  }
]

📦 Output Data Explained (Field by Field)

Each run returns an array of objects. Below is a clear explanation of every output field:

Field Name	Description
original_url	The original YouTube video or playlist URL provided
requested_resolution	Resolution selected by the user (e.g., 1080p)
provided_resolution	Actual resolution delivered (best available match)
title	Full title of the video
channel	Channel or uploader name
duration	Video length (formatted: h m s)
thumbnail	High-quality thumbnail image URL
downloadable_video_link	Direct video-only download link (no audio)
downloadable_audio_link	Direct audio-only download link
merge_downloadable_video_link	Combined video + audio download link
view_count	Total views (formatted: K / M)
categories	Content category list
description	Full video description
availability	Public or restricted availability status
live_status	Indicates if the video is live or not
channel_subscribers	Channel subscriber count
video_filesize	Estimated video file size

---

🌟 Features & Overview

✨ Resolution Selector (8K → 360p) 🎥 Video-only extraction (no sound) 🎧 Separate audio download support 🔗 Merged video + audio links 📦 Batch processing (multiple URLs) 📊 Clean, structured, ready-to-use output 🔁 Retry-friendly & stable results

---

✅ Benefits & Advantages

• 🚀 Saves time — no manual format selection
• 📁 Perfect for automation & pipelines
• 🧩 Easy integration with apps & workflows
• 📊 Ideal for analysis, archiving & previews
• 🔄 Reliable output even for multiple URLs

---

🧠 Best Practices

✅ Always provide valid YouTube URLs ✅ Select a realistic resolution (fallback happens automatically) ✅ Use multiple URLs to maximize batch efficiency ✅ Re-run the actor if a temporary failure occurs ✅ Use merged links if you need audio + video together

---

⚠️ Possible Errors & How to Avoid Them

Issue	How to Avoid
Invalid URL	Double-check YouTube links
Private / restricted video	Ensure video is publicly accessible
Resolution not available	Actor auto-selects best available
Temporary failure	Simply re-run the actor
Empty output	Ensure startUrls is not empty

---

📌 Important Notes

• 🎥 Videos are video-only (no embedded audio)
• 🎧 Audio links are provided separately
• 🔁 Re-running the actor often resolves transient issues
• 🚫 No internal implementation details are exposed

---

---

🧠 Best Practices

• ✔ Always provide valid YouTube URLs
• ✔ Use playlists for bulk extraction
• ✔ Rerun if temporary issues occur
• ✔ Choose realistic resolution options
• ✔ Store download links immediately (they may expire)

---

🎧 Audio-Only Downloader

If you only need audio downloads, use this actor instead:

👉 YouTube Audio Downloader 🎶 Youtube Audio Downloader (Video/Shorts)

---

✅ Summary

YouTube Video Downloader Pro is a clean, reliable, and scalable solution for extracting YouTube video data and direct download links — perfect for creators, analysts, and automation workflows.

🎉 Run once. Collect everything. Done.