YouTube Video & Audio Downloader

YouTube Video & Audio Downloader

Download YouTube videos, or pull just the audio as MP3, at a quality you choose. Each result comes back with metadata (title, channel, duration, views, resolution) and, if you ask for them, subtitles. It's meant for archiving, repurposing clips, and building video or audio datasets without hand-saving files one at a time.

How it works

The actor runs yt-dlp behind an Apify residential proxy, fetches the best stream at or below your quality cap, and stores each file in the run's key-value store with a public URL. YouTube bot-blocks most datacenter IPs, so residential proxy is the default and is the part that actually keeps downloads from failing.

Input

Pass either an array of urls or a single videoUrl. Everything else has a sensible default, so a list of links is enough to get going.

Output

One dataset record per URL. A successful record has ok: true plus title, channel, durationSeconds, viewCount, uploadDate, resolution, format, and fileSizeBytes. The download itself lives in the key-value store. mediaKey is the store key and mediaUrl is a direct link to the file. When subtitles are requested, subtitles holds an array of { key, url } per language. If a single URL fails, you get ok: false with an error message and the run keeps going on the rest.

Example

{
  "urls": [
    "https://www.youtube.com/watch?v=aqz-KE-bpKQ"
  ],
  "quality": "1080",
  "subtitles": true,
  "subLangs": "en"
}

Pricing

$0.05 per successful download, pay per result, no subscription. Failed URLs aren't charged.

Notes

Residential proxy is on by default for a reason. If you switch to datacenter IPs, expect YouTube to bot-block a lot of requests. Some videos (age-restricted, region-locked, or private) won't download regardless of proxy. Subtitle availability depends on what the channel uploaded; auto-captions exist for most videos but accuracy varies. If any step uses an AI model, that runs on your own OpenAI key.