🧠 YouTube Downloader — Download YouTube Videos in Any Quality (With or Without Audio)

Easily download YouTube videos directly within Apify!
This actor lets you fetch and save videos from YouTube in your preferred quality — from 240p up to 1080p — with optional audio merging using FFmpeg.
Perfect for automation workflows, video data processing, or content archiving. Ideal for developers and content creators who need a reliable YouTube downloader API.

---

🚀 Features

✅ Download multiple YouTube videos at once
✅ Choose your preferred video quality (240p, 360p, 480p, 720p, 1080p)
✅ Include or exclude audio using FFmpeg merge
✅ Get instant downloadable URLs in the output JSON
✅ Integrates seamlessly with any Apify automation, scraping, or video workflow

This actor works as a YouTube video extractor, downloader, and automation tool, perfect for video archiving and content analysis.

---

📦 Input Schema

Your input JSON must follow this structure:

{
  "includeAudio": true,
  "quality": "720",
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=5qGezR7nx3Q"
    },
    {
      "url": "https://www.youtube.com/watch?v=anotherVideo"
    }
  ]
}

🧩 Parameters

Field	Type	Description	Required	Example
startUrls	Array	List of YouTube video URLs to download.	✅	[{ "url": "https://www.youtube.com/watch?v=5qGezR7nx3Q" }]
quality	String	Desired video quality. Options: 240, 360, 480, 720, 1080.	❌ (default: 720)	"1080"
includeAudio	Boolean	Whether to include audio in the final output. If true, merges audio and video using FFmpeg.	❌ (default: true)	true

---

📤 Output Example

The actor outputs a JSON array containing the original YouTube URL and the downloadable video URL hosted on Apify:

[
  {
    "sourceUrl": "https://www.youtube.com/watch?v=5qGezR7nx3Q",
    "downloadUrl": "https://api.apify.com/v2/key-value-stores/meWWf8dAUJz4RFxQi/records/5qGezR7nx3Q.mp4?disableRedirect=false"
  }
]

Each record includes:

• sourceUrl: The original YouTube video link
• downloadUrl: The generated download link for the saved video file

---

⚙️ Example Use Cases

🎬 Video Archiving – Save YouTube videos for offline viewing or research.
🤖 Automation Workflows – Integrate video downloading in Apify tasks or bots.
📊 Content Analysis – Collect and process video data for machine learning or analytics.
📱 Social Media Management – Automatically download videos to repurpose content.

This tool also works as a YouTube downloader API, YouTube video extractor, and video automation tool, making it perfect for developers, content creators, and marketers.

---

🧠 How It Works

1. Provide one or multiple YouTube URLs in the startUrls field.
2. Choose your preferred quality and toggle includeAudio.
3. Run the actor — it fetches the videos, processes them, and generates direct downloadable links.

This seamless workflow allows easy integration for video automation, YouTube scraping, and content archiving.

---

🧩 Technical Notes

• Uses FFmpeg for merging audio and video when includeAudio is true.
• Each downloaded file is temporarily stored in the Apify Key-Value Store, accessible via the downloadUrl.
• Supports batch downloading (multiple YouTube URLs).
• Compliant with Apify actor input schema for easy integration in platform UI or API calls.