🎧 Youtube Audio Downloader (Video/Shorts) — Apify Actor

Extract high-quality audio download links and essential video metadata from one or multiple YouTube videos — with optional language selection and reliable output structure.

This actor is designed for speed, stability, and simplicity. Just provide video URLs, choose your preferred audio language, and get clean, ready-to-use results.

Select a language 🌍 and run the process ▶️ to get the audio link 🔊, ready to download ⬇️ or play ▶️.

---

🚀 What This Actor Provides

For each YouTube video URL, this actor returns:

• 📄 Basic video information
• 🎶 All available audio-only download links
• 🌍 A separately selected audio link based on your chosen language
• 🖼️ High-quality thumbnail
• ⏱️ Video duration in readable format

All outputs are structured and ready for automation, storage, or direct use.

---

Features

• ✅ Extracts video metadata (title, description, duration).
• ✅ Finds and exposes a direct audio download URL (best available audio quality).
• ✅ Selects the highest-resolution thumbnail available.
• ✅ Supports residential proxy configuration via environment variables.
• ✅ Includes retry logic with exponential backoff for transient failures.
• ✅ Pushes structured results into the Actor dataset.
• ✅ Handles shorts urls or share link ✅

---

📤 Output Data Overview

Each processed video generates one output record.

🔹 Output Fields Explained

Field	Description
url	Original YouTube video URL
title	Video title
description	Video description (if available)
duration	Video length in MM:SS or HH:MM:SS
thumbnail_url	Highest-quality available thumbnail
selected_downloadable_audio_link	Best audio link matching your selected language
downloadable_audio_links	List of all audio-only formats available
error (optional)	Error message if processing failed

---

🎶 Audio Link Object Structure

Each audio link contains:

Field	Meaning
format_id	Internal format identifier
ext	Audio file extension (mp3, m4a, webm, etc.)
format	Human-readable format description
bitrate	Audio quality (kbps)
language	Audio language code (if available)
url	Direct downloadable audio link

---

🌟 Features & Highlights

• 🎧 Audio-only links (no video noise)
• 🌍 Language-based audio selection
• 📦 Batch processing (multiple URLs)
• 🔁 Automatic retry for failed videos
• 📊 Clean, structured dataset output
• ⚡ Optimized for fast and stable results

---

🎯 Benefits & Advantages

✅ Saves time — no manual extraction ✅ Supports Shorts, normal videos & shared links ✅ Perfect for automation pipelines ✅ Beginner-friendly inputs ✅ Professional-grade structured output

Ideal for:

• Content creators
• Audio processing pipelines
• Research & analysis
• Archiving & backups

---

🧾 Input Example

{
  "audioLanguage": "English",
  "startUrls": [
    { "url": "https://www.youtube.com/watch?v=SSX8jTwcpII" },
    { "url": "https://youtu.be/IWDUPZuktK4" },
    { "url": "https://www.youtube.com/shorts/AbCdEfGh123" },
    { "url": "https://youtube.com/shorts/XyZ987LmnoQ" }
  ]
}

---

📄 Output Example

{
  "url": "https://www.youtube.com/watch?v=SSX8jTwcpII",
  "title": "Sample Video Title",
  "description": "Video description here...",
  "duration": "5:32",
  
  "selected_downloadable_audio_link": {
    "format_id": "140",
    "ext": "m4a",
    "format": "audio only",
    "bitrate": "128 kbps",
    "language": "English",
    "url": "https://audio-download‐‐---------------------------------------link"
  },

  "thumbnail_url": "https://i.ytimg.com/vi/.../maxresdefault.jpg",

  "downloadable_audio_links": [
    {
      "format_id": "249",
      "ext": "webm",
      "bitrate": "50 kbps",
      "language": "Spanish,",
      "url": "https://audio----------------------------------------------link-1"
    },
    {
      "format_id": "249",
      "ext": "webm",
      "bitrate": "50 kbps",
      "language": "Portuguese",
      "url": "https://audio-link------------------------------------------------2"
    },
    {
      "format_id": "249",
      "ext": "webm",
      "bitrate": "50 kbps",
      "language": " French",
      "url": "https://audio-link--------------------------------------------------3"
    },
    {
      "format_id": "249",
      "ext": "webm",
      "bitrate": "50 kbps",
      "language": "hindi",
      "url": "https://audio-link-------------------------------------------------------4"
    }
      ..................
  ]
}

🎛️ Audio Language Options

Includes: English, Spanish, Portuguese, French, German, Russian, Chinese, Japanese, Korean, Arabic, Hindi, Bengali, Turkish, Vietnamese, Thai, Indonesian (Default: Auto Detect / English)

✅ Best Practices

• 🔗 Always use valid YouTube video or share links
• 🎶 Select a language only if you need a specific one
• 📦 For large batches, process in smaller groups
• 🔁 If a video fails, simply run again
• 🧪 Test with 1–2 URLs before bulk runs

---

⚠️ Possible Errors & How to Avoid Them

Issue	How to Avoid
No output returned	Ensure URLs are valid and public
Selected language missing	Actor automatically falls back to original audio
Temporary failure	Re-run the actor
Empty audio list	Video may not contain audio-only formats

💡 Tip: Most temporary issues resolve by simply running the actor again.

---

🏁 Final Notes

• This actor focuses on output quality, not complexity
• No setup required — just input URLs and run
• Built for reliability, speed, and ease of use

🎉 Run it once, check the output, and you’re good to go!

---

Contact & support ✉️

If you run into issues or need help:

Email: alphascraper69@gmail.com

Please include a sample input and the dataset record (if available) so we can help troubleshoot faster.

---