🎬 YouTube Downloader

This Apify Actor downloads YouTube videos and music in selected quality.

The actor:

1. Downloads the video (or audio)
2. Returns a temporary secure download URL

Designed for automation, content archiving, data pipelines, and integration with other Apify workflows. 🚀

---

⚡ Fast & Reliable Infrastructure

• Secure backend processing
• Temporary secure download links
• Optimized format selection

---

✨ Features

• 🎥 Download YouTube videos or audio by URL
• 🎯 Select preferred quality (360p, 720p, 256kbps etc.)
• 🔁 Automatic analyze → download workflow
• 🔐 Secure time-limited download URLs

---

📥 Input Parameters

Parameter	Type	Required	Description
videoUrls	string[]	✅ Yes*	List of YouTube video URLs. Recommended input for one or multiple videos.
url	string	❌ No	Deprecated legacy single YouTube video URL field. Prefer videoUrls.
quality	string	❌ No	Preferred video quality (e.g., "360p", "720p"). If not provided, a safe default is selected automatically
audioOnly	boolean	❌ No	Check to download only audio.
bitrate	string	❌ No	Preferred audio quality (e.g. "192 kbps", "256 kbps". If not provided, a safe default is selected automatically

*Provide at least one URL using videoUrls. The deprecated url field is still supported for backward compatibility.

---

📝 Example Input

{
    "videoUrls": [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "https://www.youtube.com/watch?v=5YM9RbGmX-Y"
    ],
    "quality": "720p"
}

{
    "audioOnly": true,
    "bitrate": "256",
    "videoUrls": [
        "https://music.youtube.com/watch?v=Qz0qubtokio&si=QNcmmFFfrJ6NYOdS"
    ]
}

Deprecated legacy input:

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

If quality is not provided, the actor will:

1. Prefer 720p
2. Fallback to 480p (non-60fps)
3. Use the best available safe format

---

📤 Output

The actor returns a JSON object containing a temporary download URL.

Example Output

{
    "downloadUrl": "https://your-secure-storage-url/video.mp4?X-Amz-..."
}

The link:

• ⏳ Is time-limited
• 🔐 Is secure
• 🔄 Expires automatically

---

🚀 Usage

1. Open the actor in Apify.
2. Provide YouTube video URLs in videoUrls.
3. (Optional) Select desired quality.
4. Run the actor.
5. Download your video from the returned URL.

You can also run it via API.

---

🌐 Example API Call

curl -X POST https://api.apify.com/v2/acts/your-actor-id/run \
  -H "Content-Type: application/json" \
  -d '{
        "videoUrls": [
          "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
          "https://www.youtube.com/watch?v=5YM9RbGmX-Y"
        ],
        "quality": "720p"
      }'

---

⚠️ Limitations & Notes

• The download URL is temporary and expires after a short time.
• Some high-quality formats (e.g., 1080p60) may be restricted.
• Large videos may take longer to process.
• Private or restricted videos cannot be downloaded.
• Use responsibly and comply with YouTube's Terms of Service.
• Rate limits may apply. Please be patient. Contact support if you need higher limits.

---

🎯 Best Use Cases

• 📦 Archive YouTube content
• 🤖 Feed videos into AI pipelines
• 📊 Automate content research
• 🔁 Integrate into data workflows
• 🎙 Combine with transcription or comment scraping

---

Other Recommended Scrapers

• 🐦 X (Twitter) Posts Search — Find posts/tweets based on keywords, hashtags, and more
• 🐦 X (Twitter) Post Replies Scraper — Scrap replies of multiple X (Twitter) posts
• 🐦 X (Twitter) Profile Posts Scraper — Scrap posts of specific X (Twitter) profile
• 📘 Facebook Posts Search — Discover Facebook posts for a given topic or page
• 📘 Facebook Comments Scraper — Extract comments from public Facebook posts
• 📘 Facebook Reactions Scraper — Scrap reactions from Facebook posts (like, sad, haha, angry etc.)
• 📘 Facebook Posts Scraper — Scrap posts from Facebook pages, groups etc.
• 🎬 YouTube Search Scraper — Extract videos from search queries
• 🎬 YouTube Comments Scraper — Extract comments from posted videos

📬 Support

Need help or custom infrastructure?

Contact: scraper1one@gmail.com