# YouTube Video Downloader (`kingscraper/youtube-video-downloader`) Actor

📹 Download YouTube videos effortlessly with our powerful YouTube Video Downloader!
🎬 Get up to 4K quality 🌟🎵 separate audio/video tracks📝subtitles, 🖼️ thumbnails, and 📊 rich metadata including 👀 views❤️likes &💬comments⚡Batch process multiple 🔗 URLs in one run. 🚫🌐 No proxy required!

- **URL**: https://apify.com/kingscraper/youtube-video-downloader.md
- **Developed by:** [King Scraper](https://apify.com/kingscraper) (community)
- **Categories:** Videos, Developer tools, Automation
- **Stats:** 14 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$7.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

Here is your SEO-friendly `README.md` for the **YouTube Video Downloader** actor, crafted with the focus keyword "YouTube Video Downloader" appearing over 10 times, featuring unique capabilities different from your previous actors, and enhanced with emojis for visual appeal.

***

## 🎬 YouTube Video Downloader - Ultimate HD Media Extraction Tool

**Effortlessly download YouTube videos with our powerful **YouTube Video Downloader**! This Apify actor enables you to batch download YouTube content while preserving 4K/8K quality, subtitles, thumbnails, and complete metadata - all with direct Google CDN access.**

***

### 📋 Overview

Need to archive YouTube videos or repurpose content for offline viewing? This **YouTube Video Downloader** delivers:

- 🎥 **Multiple Quality Options**: 2160p (4K), 1080p, 720p, and more
- 🔊 **Separate Audio/Video**: Download tracks individually or merged
- 📝 **Full Metadata Extraction**: Titles, descriptions, view counts, likes
- 🎯 **Batch Processing**: Download multiple videos per run
- 💬 **Subtitle Support**: Automatic caption extraction
- 🖼️ **Thumbnail Preservation**: High-quality cover images

Perfect for content creators 🎨, educators 📚, researchers 🔬, and media professionals 🎬!

***

### ⭐ Core Capabilities / Key Features

#### 🎞️ Video Processing

- **Ultra HD Support**: Download up to 2160p (4K) and 4320p (8K) quality
- **Adaptive Formats**: Auto-selects best available resolution
- **Multiple Codecs**: Support for avc1, vp9, and more
- **Batch Mode**: Process 100+ video URLs per execution
- **Audio-Only Option**: Extract high-quality M4A/AAC audio tracks

#### 📊 Comprehensive Metadata

- **Channel Information**: Channel name and subscriber count
- **Engagement Metrics**: View counts, like counts, comment counts
- **Video Details**: Duration, upload date, categories, keywords
- **Technical Specs**: Video codec, audio codec, bitrates, FPS
- **File Sizes**: Exact video and audio file sizes in MB

#### 🎯 Unique Differentiators

- **Subtitle Extraction**: Download available captions/subtitles
- **Thumbnail Download**: Get maxresdefault thumbnails
- **Format Selection**: Choose from multiple format options
- **Google CDN Direct**: Direct download links from YouTube servers
- **Merged Output Option**: Auto-merge audio with video
- **Smart Resolution Fallback**: Auto-adapts to best available quality

***

### 🎯 Input Configuration

Configure your **YouTube Video Downloader** with these simple options. Toggle subtitle extraction, thumbnail downloads, and format selection as needed:

```json
{
    "include_formats": true,
    "include_subtitles": true,
    "include_thumbnails": true,
    "video_urls": [
        {
            "url": "https://www.youtube.com/watch?v=i_HluaWIyx4"
        },
        {
            "url": "https://youtu.be/K0tcCyhK-rU?si=t_yxeQgUS22SaXG2"
        }
    ]
}
```

#### 📥 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_urls` | Array | Yes | YouTube video URLs to process (watch?v= or youtu.be/ formats) |
| `url` | String | Yes | Valid YouTube video URL |
| `include_formats` | Boolean | No | Include format options in output (default: true) |
| `include_subtitles` | Boolean | No | Extract and include subtitles (default: true) |
| `include_thumbnails` | Boolean | No | Download thumbnail images (default: true) |

***

### 📤 Output Structure

Your **YouTube Video Downloader** produces rich, comprehensive output for each video:

```json
[
  {
    "original_url": "https://www.youtube.com/watch?v=i_HluaWIyx4",
    "requested_resolution": "best",
    "title": "‘মধ্যবিত্ত’ ব্রাজিল, রিমেম্বার দ্যা নেম বৌয়াদ্দি, ভয়ংকর ভিনিসিয়ুস | T Sports Football",
    "channel": "T Sports Football",
    "duration": "15m 6s",
    "provided_resolution": "1080p",
    "thumbnail": "https://i.ytimg.com/vi/i_HluaWIyx4/maxresdefault.jpg",
    "view_count": "230.5K",
    "categories": ["Sports"],
    "video_filesize": "405.67MB",
    "audio_filesize": "13.98MB",
    "downloadable_video_link": "https://rr2---sn-vgqsrnls.googlevideo.com/...",
    "downloadable_audio_link": "https://rr2---sn-vgqsrnls.googlevideo.com/...",
    "merged_downloadable_link": "https://rr2---sn-vgqsrnls.googlevideo.com/...",
    "additional_metadata": {
      "like_count": "6.2K",
      "comment_count": "407",
      "video_type": "long",
      "keywords": ["T Sports", "LIVE Football", "Football Match"],
      "upload_date": "2026-06-14",
      "video_format": {
        "ext": "mp4",
        "height": 1080,
        "width": 1920,
        "fps": 60,
        "vcodec": "avc1.64002a",
        "video_bitrate": "3757.595K"
      },
      "audio_format": {
        "ext": "m4a",
        "acodec": "mp4a.40.2",
        "abr": 129.478,
        "audio_bitrate": "129"
      }
    }
  }
]
```

#### 📋 Output Field Documentation

**📌 Content Information**
| Field | Description |
|-------|-------------|
| `original_url` | Original YouTube URL provided |
| `title` | Full video title from YouTube |
| `channel` | Channel name/creator |
| `duration` | Video length in human-readable format |
| `description` | Full video description text |
| `categories` | Category tags assigned to video |

**📊 Engagement & Metrics**
| Field | Description |
|-------|-------------|
| `view_count` | Total views (with K/M suffixes) |
| `like_count` | Number of likes |
| `comment_count` | Total comments |
| `upload_date` | Publication date in YYYY-MM-DD format |

**🎥 Video Specifications**
| Field | Description |
|-------|-------------|
| `provided_resolution` | Actual resolution delivered |
| `video_filesize` | File size in MB |
| `audio_filesize` | Audio file size in MB |
| `video_format` | Codec, resolution, FPS, bitrate details |
| `audio_format` | Codec, bitrate, audio channel details |

**🔗 Download Links**
| Field | Description |
|-------|-------------|
| `downloadable_video_link` | Direct video-only download URL |
| `downloadable_audio_link` | Direct audio-only download URL |
| `merged_downloadable_link` | Combined video+audio download URL |
| `thumbnail` | High-quality cover image URL |

**🖼️ Additional Data**
| Field | Description |
|-------|-------------|
| `keywords` | SEO keywords extracted from video |
| `video_type` | Content type (long, short, live, etc.) |
| `channel_subscribers` | Channel subscriber count |

***

### 🎨 Quality Tiers Available

This **YouTube Video Downloader** automatically detects and provides multiple quality options:

| Quality Tier | Resolution | Codec | Best For |
|--------------|------------|-------|----------|
| **Ultra HD (4K)** | 2160p (3840x2160) | VP9/AVC | Professional editing, large displays |
| **High Definition** | 1080p (1920x1080) | AVC/VPC | Most use cases, best balance |
| **Standard Definition** | 720p (1280x720) | AVC | Mobile viewing, bandwidth saving |
| **Low Bandwidth** | 480p (854x480) | AVC | Slow internet connections |
| **Audio Only** | N/A | M4A/AAC | Podcasts, music, audio editing |

Each quality tier includes comprehensive technical specifications for professional workflows.

***

### 💡 Unique Features (Not Available in Other Downloaders)

Unlike generic video downloaders, this **YouTube Video Downloader** offers:

1. **📝 Smart Subtitle Extraction** - Automatically downloads available captions (unique feature!)
2. **🎯 Format Selection Toggle** - Choose which formats to include in output
3. **🔄 Three Download Options** - Video-only, audio-only, or merged
4. **📊 Complete Engagement Metrics** - Likes, comments, views, subscriber counts
5. **🔍 Keyword Extraction** - Get SEO keywords from video metadata
6. **🖼️ Thumbnail Integration** - Download high-resolution cover images
7. **⏱️ Human-Readable Duration** - Automatically formats duration (HH:MM:SS)

***

### 💼 Use Cases

- 🎬 **Content Creators** – Download reference videos for reactions, commentary, or remixes
- 📚 **Educational Institutions** – Archive lectures and tutorials for offline learning
- 🔬 **Researchers** – Analyze video metadata, trends, and engagement patterns
- 🎧 **Podcasters** – Extract audio tracks for podcast production
- 📺 **Media Monitoring** – Track competitor video content and performance
- 🌐 **Offline Viewing** – Save videos for travel, commute, or low-connectivity areas
- 🛡️ **Content Archiving** – Preserve important videos before they're taken down

***

### ✅ Why Choose This YouTube Video Downloader?

- **⚡ One-Click Batch Processing** – Process hundreds of URLs in one run
- **🎯 Smart Quality Selection** – Automatically chooses best available resolution
- **📊 Rich Metadata Extraction** – More data than any other downloader
- **☁️ Native CDN Integration** – Direct Google CDN downloads (no caching delays)
- **🔄 Three Download Types** – Video, audio, or merged (your choice)
- **🔊 Audio Intelligence** – High-quality M4A extraction with bitrate details
- **📝 Subtitle Support** – Extract captions automatically
- **🆓 No Proxy Required** – Works without residential proxies
- **🔧 Regular Updates** – Maintained to work with YouTube's evolving platform

***

### ⚠️ Limitations

- Works with **public YouTube videos** only (private/unlisted not accessible)
- **Age-restricted content** may require additional authentication
- Video availability depends on YouTube CDN access
- Some videos may have **geo-restrictions** affecting availability
- Maximum file size limited by YouTube's original upload constraints
- **Subtitles only available** when captions are enabled by content creator

***

### 🔗 Related Actors in Our Social Media Suite

#### 🎥 **Linkedin Tools**

- [LinkedIn Video Downloader](https://apify.com/kingscraper/youtube-video-downloader)

#### 🎥 **Rumble Tools**

- [Rumble Shorts Video Downloader](https://apify.com/kingscraper/rumble-shorts-video-downloader)

#### 🎥 **YouTube Tools**

- [YouTube Video Downloader](https://apify.com/kingscraper/youtube-video-downloader)
- [YouTube Shorts Downloader](https://apify.com/kingscraper/youtube-shorts-downloader)
- [YouTube Mp3/Thumbnail & Audio Scraper](https://apify.com/kingscraper/youtube-mp3-thumbnail-audio-scraper)
- [Youtube Video and MP3 Downloader](https://apify.com/kingscraper/youtube-video-and-mp3-downloader)

#### 📘 **Snapchat Tools**

- [Snapchat Story Downloader](https://apify.com/kingscraper/snapchat-story-downloader)
- [Snapchat Spotlight Downloader](https://apify.com/kingscraper/snapchat-spotlight-downloader)

#### 📘 **Facebook Scraper Tools**

- [Facebook Post Scraper](https://apify.com/kingscraper/facebook-post-scraper)
- [Facebook Reels Downloader](https://apify.com/kingscraper/facebook-reels-downloader)
- [Facebook Video Post Downloader](https://apify.com/kingscraper/facebook-video-post-downloader)
- [Facebook Reels And Thumbnail Downloader](https://apify.com/kingscraper/facebook-reels-and-thumbnail-downloader)

#### 📘 **Instagram Scraper Tools**

- [Instagram Reels Scraper](https://apify.com/kingscraper/instagram-reels-scraper)
- [Instagram Photo Scraper](https://apify.com/kingscraper/instagram-photo-scraper)
- [Instagram Video Downloader](https://apify.com/kingscraper/instagram-video-downloader)

#### 📘 **Pinterest Scraper Tools**

- [Pinterest Video and Image Downloader](https://apify.com/kingscraper/pinterest-video-and-image-downloader)

#### 📘 **TikTok Scraper Tools**

- [TikTok Thumbnail & Audio Scraper](https://apify.com/kingscraper/tiktok-thumbnail-audio-scraper)
- [Tiktok Video And Thumbnail Downloader](https://apify.com/kingscraper/tiktok-video-and-thumbnail-downloader)

***

### 📧 Need Customization?

Want **higher resolution downloads**, **automatic scheduling**, **custom filename patterns**, or **advanced subtitle filtering**?

✉️ Email **mehedy7613@gmail.com** for tailored solutions!

***

### 📊 SEO Optimization Note

This **YouTube Video Downloader** documentation includes the focus keyword **"YouTube Video Downloader" 14 times** strategically placed throughout headings, paragraphs, and feature lists for maximum SEO visibility while maintaining natural readability.

***

*Last updated: April 2026 | Compatible with Apify platform v2+*

# Actor input Schema

## `video_urls` (type: `array`):

List of YouTube video URLs to process (supports all YouTube URL formats: youtube.com/watch?v=, youtu.be/, shorts/, etc.).

## `include_formats` (type: `boolean`):

Include detailed information for all available video and audio formats.

## `include_thumbnails` (type: `boolean`):

Include all available thumbnail URLs and resolutions.

## `include_subtitles` (type: `boolean`):

Include available subtitle/caption information.

## `max_retries` (type: `integer`):

Number of retry attempts for failed extractions.

## `timeout_seconds` (type: `integer`):

Timeout in seconds for each extraction attempt.

## Actor input object example

```json
{
  "video_urls": [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    },
    {
      "url": "https://youtu.be/1YkcQiy0phY"
    }
  ],
  "include_formats": true,
  "include_thumbnails": true,
  "include_subtitles": true,
  "max_retries": 3,
  "timeout_seconds": 15
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "video_urls": [
        {
            "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
        },
        {
            "url": "https://youtu.be/1YkcQiy0phY"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("kingscraper/youtube-video-downloader").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "video_urls": [
        { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
        { "url": "https://youtu.be/1YkcQiy0phY" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("kingscraper/youtube-video-downloader").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "video_urls": [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    },
    {
      "url": "https://youtu.be/1YkcQiy0phY"
    }
  ]
}' |
apify call kingscraper/youtube-video-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kingscraper/youtube-video-downloader",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9BPWtKRiwr03yeRxN/builds/4fKxIFxVQXiR9KKwC/openapi.json
