Titan YouTube Downloader (Video, Audio, Metadata, Subtitles)

Download YouTube videos and Shorts in bulk as MP4 or WebM up to 4K, or extract MP3 audio. Get direct download links or deliver files to Amazon S3, Google Cloud Storage, or DigitalOcean Spaces. You pay only for successfully delivered results.

Video and MP3 delivery costs about $5/TB during our limited launch period. Standalone metadata and subtitles are also available when you do not need the media file.

Built on Titan Network's distributed infrastructure, used by leading AI companies and designed to support petabyte-scale dataset delivery.

Choose your output

Output	What you get	Launch pricing
Video	MP4 or WebM from 360p to 4K	About $5/TB delivered
Audio	MP3 audio with attached metadata	About $5/TB delivered
Metadata	Standalone .info.json without media	$0.004 per successful video
Subtitles	Manual or automatic captions in VTT, SRT, JSON3, SRV, or TTML	$0.002 per successful video

How to use the YouTube downloader

1. Click Try for free.
2. Paste YouTube video URLs, Shorts URLs, youtu.be links, or 11-character video IDs.
3. Choose video, MP3, metadata, or subtitles as the output.
4. Select direct links or your own S3-compatible cloud storage.
5. Click Run and open the Dataset to collect the results.

Limited-time launch offer: about $5/TB

For a limited launch period, successfully delivered video and audio cost about $5/TB. Apify's Free plan currently includes $5 of monthly prepaid usage, which can cover up to about 1 TB of successful media delivery when the credit is otherwise unused. Other Store or platform usage and per-run rounding reduce the exact amount.

This is a promotional launch price and may change after the offer. Check the live Pricing tab before starting a run.

---

🌟 Key Features

• Four Output Modes in One Actor: outputType selects media (video or MP3 audio), metadata (standalone .info.json), or subtitles (standalone subtitle files).
• High Quality Video Downloads: Full videos in up to 4K (2160p), 2K (1440p), 1080p Full HD, 720p HD, 480p or 360p.
• Audio-Only Extraction (MP3): outputType=media + format=mp3. Current Gateway supports MP3 only (no M4A/FLAC).
• Standalone Metadata: outputType=metadata delivers <video_id>.info.json only — no media bytes.
• Standalone Subtitles: outputType=subtitles + subtitleLanguages delivers VTT/SRT/JSON3/SRV1-3/TTML subtitle files (manual + automatic), one row per video with every language in downloadFiles.
• Shorts & Standard Videos: Fully supports standard YouTube videos, YouTube Shorts, and youtu.be short links.
• Zero Memory Overhead (Ultra-Lightweight): Runs smoothly on Apify's minimal 128MB RAM tier.
• Direct High-Speed Delivery: Download links are generated as direct pre-signed URLs (retained ~24h), eliminating slow double-transfers and bandwidth bottlenecks.
• Custom Cloud Storage Integration: Pipe outputs directly into your Amazon S3, Google Cloud Storage, or DigitalOcean Spaces bucket. Azure is not supported.
• Real-time Live Progress & ETA: Transparent progress tracking via Apify Console (fetching metadata / downloading / processing / uploading).
• Bounded Concurrency + Configurable Timeout: Default 20 concurrent "submit + SSE" worker units (1-50), and per-mode task timeouts (metadata/subtitles 30 min, audio 2 h, video 4 h) — both configurable.
• One-Run Batch Grouping: All URLs in one run share the same batch_id (<APIFY_USER_ID>:<APIFY_ACTOR_RUN_ID>), which the Gateway groups into a single Titan project (one project, N tasks, parallel downloads). Duplicate video IDs are deduplicated (one Dataset row + one charge).

---

📋 Input Configuration

Parameter	Type	Required	Default	Description
startUrls	Array of strings	Yes	-	YouTube URLs (watch, Shorts, youtu.be) or plain 11-char video IDs.
outputType	String	No	"media"	media (video/audio), metadata (standalone .info.json), subtitles (standalone subtitle files). One run uses exactly one mode.
quality	String	No	"720"	Media/video only: 360, 480, 720, 1080, 1440, 2160. Ignored for audio/metadata/subtitles.
format	String	No	"mp4"	Media only: mp4, webm (video), mp3 (audio only). Ignored for metadata/subtitles.
subtitleLanguages	Array of strings	Subtitles	-	1-10 language codes (e.g. en, zh-Hans) or ["all"] for every available subtitle.
subtitleFormat	String	No	"vtt"	srt, vtt, json3, srv1, srv2, srv3, ttml.
storageType	String	No	"apify"	apify (Titan platform storage / pre-signed links), aws, gcp, digitalocean. Azure is not supported.
s3Bucket	String	External	-	Bucket/container name for aws/gcp/digitalocean.
s3Region	String	No	-	Storage region (us-east-1, auto, nyc3). Required for DigitalOcean.
s3AccessKeyId	String	External	-	Access key ID for external storage.
s3SecretAccessKey	String	External	-	Secret access key for external storage.
maxWaitSec	Integer	No	mode default	Per-task SSE timeout in seconds (metadata/subtitles 1800, audio 7200, video 14400).
maxConcurrency	Integer	No	20	Bounded concurrency (1-50) for submit + SSE worker units.

Field combination rules (sending forbidden fields returns OUTPUT_CONFIG_CONFLICT):

• Video: outputType=media, quality, format=mp4/webm — no subtitle fields.
• Audio: outputType=media, format=mp3, fixed quality=720 — no subtitle fields.
• Metadata: outputType=metadata — omit quality/format and all subtitle fields.
• Subtitles: outputType=subtitles + subtitleLanguages — omit quality and media format.

Example Input JSON

{
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/jNQXAC9IVRw",
    "9bZkp7q19f0"
  ],
  "outputType": "media",
  "quality": "1080",
  "format": "mp4"
}

Audio run:

{ "startUrls": ["dQw4w9WgXcQ"], "outputType": "media", "format": "mp3" }

Metadata run:

{ "startUrls": ["dQw4w9WgXcQ"], "outputType": "metadata" }

Subtitles run:

{
  "startUrls": ["dQw4w9WgXcQ"],
  "outputType": "subtitles",
  "subtitleLanguages": ["en", "zh-Hans"],
  "subtitleFormat": "vtt"
}

---

📊 Output Dataset Format

Each processed video produces a structured dataset record with metadata and download links. The downloadFiles array is the authoritative delivery record and is always persisted in full (audio tasks include the attached .info.json; multi-language subtitles include one entry per delivered language).

Field	Type	Description
id	String	Unique YouTube video ID.
input	String	Original input URL provided.
title	String	Video title.
durationSec	Integer	Total duration in seconds.
outputType	String	media, metadata, or subtitles.
quality / format	String	Media mode only.
subtitleLanguages / subtitleFormat	Array / String	Subtitles mode only.
fileSizeBytes / fileSizeMB	Number	Main delivered file size.
downloadedFileUrl	String	Main file's direct download link (~24h retention on platform storage; may be absent when external storage only returns an object key).
fileKey	String	Main file's storage object key.
downloadFiles	Array	Complete list of delivered files (kind, filename, fileSizeBytes, downloadedFileUrl, fileKey, status). Authoritative.
status	String	completed, failed, timeout, or skipped.
note	String	Expiration / usage instructions.

Example Output Record

{
  "id": "dQw4w9WgXcQ",
  "input": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
  "durationSec": 213,
  "outputType": "media",
  "format": "mp3",
  "fileSizeMB": 4.12,
  "downloadedFileUrl": "https://.../dQw4w9WgXcQ.mp3",
  "fileKey": ".../dQw4w9WgXcQ.mp3",
  "downloadFiles": [
    { "kind": "audio", "filename": "dQw4w9WgXcQ.mp3", "fileSizeBytes": 4321000, "downloadedFileUrl": "https://.../dQw4w9WgXcQ.mp3", "fileKey": ".../dQw4w9WgXcQ.mp3", "status": "available" },
    { "kind": "metadata", "filename": "dQw4w9WgXcQ.info.json", "fileSizeBytes": 245000, "downloadedFileUrl": "https://.../dQw4w9WgXcQ.info.json", "fileKey": ".../dQw4w9WgXcQ.info.json", "status": "available" }
  ],
  "status": "completed",
  "note": "Audio download link is retained for approximately 24h after delivery."
}

---

💰 Pricing & Monetization (Pay-Per-Event)

This Actor uses Apify's Pay-Per-Event (PPE) model with a No Success, No Charge guarantee:

Delivered output	Billing event	Launch price
Video (MP4/WebM)	video-download-success	About $5/TB delivered
Audio (MP3)	audio-download-success	About $5/TB delivered
Standalone metadata	metadata-download-success	$0.004 per delivered item
Standalone subtitles	subtitles-download-success	$0.002 per delivered item

• You are only charged when all of these hold: Gateway returns completed, the requested output files exist, and the Dataset row was written successfully.
• No success event is charged for failures, timeouts, cancellations, or missing output files.
• For billing, successful media bytes are accumulated within each Actor run and rounded up in 10 MB units. Several small files in one run share billing units; every run with successful media has a one-unit minimum.
• Minimal compute units: the Actor streams direct storage links without proxying raw bytes through the container.

The limited-time video and audio launch price applies across all Apify plan tiers. The live Apify Pricing tab is authoritative; other Store or platform usage draws from the same prepaid balance.

---

⚖️ Legal & Fair Use Disclaimer

This Actor is designed solely for archiving, offline viewing of authorized content, or educational and fair-use research. Please respect the copyright of creators and YouTube's Terms of Service when using this Actor.