# Youtube Video Downloader (`scrapers-hub/youtube-video-downloader`) Actor

🎥 YouTube Video Downloader ⬇️ — fast, secure tool to save videos in HD/4K as MP4 or MP3 for offline access. ✅ Download playlists, captions & thumbnails. ⚡️ Batch support, clean UI. Use for your own content or with permission. Perfect for creators, educators & teams.

- **URL**: https://apify.com/scrapers-hub/youtube-video-downloader.md
- **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### 🎥 YouTube Video Downloader Pro: The Ultimate Enterprise Solution for High-Fidelity Batch Media Extraction 🚀📊

In the relentless landscape of modern digital media, raw video data is the primary fuel for content innovation, AI training, and strategic marketing 🔥🎬. The YouTube Video Downloader Pro is a professional-grade, industrial-strength extraction engine meticulously engineered to bridge the gap between restricted platform APIs and the high-fidelity media files required by global organizations ⚙️🔗. By deploying the YouTube Video Downloader Pro, data scientists, media archivists, and marketing agencies can transcend the limitations of standard browsing and establish an autonomous pipeline for creative asset management and competitive research with surgical precision 📈🎯

The YouTube Video Downloader Pro serves as a robust, non-invasive bridge between the vast, unstructured environment of public video content and the refined, high-fidelity databases required by modern Business Intelligence (BI) tools 🗄️🧠. This documentation offers an exhaustive deep-dive into the technical framework, operational methodologies, and strategic utilities of the YouTube Video Downloader Pro 🌐📘

#### 🏗️ 1. Technical Architecture of the YouTube Video Downloader Pro⚙️

The core engineering of the YouTube Video Downloader Pro is built upon a resilient, multi-layered browser-simulation infrastructure specifically optimized for the heavy media environment of YouTube 🧩📡. Unlike standard tools that rely on fragile official APIs with restrictive quotas ⚠️, the YouTube Video Downloader Pro utilizes a proprietary parsing engine that interacts directly with the platform's public-facing metadata layers 🛠️🔐. This ensures that the YouTube Video Downloader Pro can extract data even from the most high-traffic viral content without interruption 🚀🔒

### Input
```json
{
  "startUrls":[
    "https://www.youtube.com/watch?v=XqZsoesa55w&ab_channel=PinkfongBabyShark-Kids%27Songs%26Stories",
    "https://www.youtube.com/watch?v=PsNyag6JGv4&ab_channel=RedBull",
    "https://www.youtube.com/watch?v=ctEksNz7tqg&ab_channel=RedBull"
  ],
  
}
````

#### output

```json
[
  {
    "sourceUrl": "https://www.youtube.com/watch?v=y-k9CQMJcRQ",
    "downloadUrl": "https://rr2---sn-bg5hxxo2ivox-q5jr.googlevideo.com/videoplayback?expire=1767011376&ei=0B9SabrGNsLCmLAPlKm3yAY&ip=37.111.194.58&id=o-AEh9aKElXwH9FKFb-1Ekr7Cixy1iED7U6uuxKxNu0pcf&itag=160&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=390&met=1766989776%2C&mh=8E&mm=31%2C26&mn=sn-bg5hxxo2ivox-q5jr%2Csn-qxaeenlz&ms=au%2Conr&mv=m&mvi=2&pl=24&rms=au%2Cau&initcwndbps=595000&bui=AYUSA3ADomFhK4Y0QeYXFWv5GkIFi5wtLUrgaxgJQ2lLt-cGaTbpbFvys_xOEZMLmBZWHK8I1c0CP0P9&spc=wH4Qq2IijYDI&vprv=1&svpuc=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=257214&dur=24.920&lmt=1696096487312854&mt=1766989500&fvip=3&keepalive=yes&fexp=51552689%2C51565116%2C51565682%2C51580968&c=ANDROID&txp=553C434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAM08ea7rR1TmKAeY1sgNzsim27HwOz9zp5Z9KnkAnxHIAiEA4oPe3KMATUpQqLtBH8CUnle4ahxUAG6bbsLsnVS-GC0%3D&lsparams=cps%2Cmet%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRgIhANvysb4bVhkPh-6K8oreqqnuwCQS8NFnttBwo86FaQGBAiEAseBZp-iOu6ytN2e38eGuBwLQA3Ui39TuH-ixGhwJWEU%3D"
  }
  .....
]
```

#### ⚙️ Systems Optimization & Logic 🧠⚡

Asynchronous Interaction Parsing 🔄
The YouTube Video Downloader Pro identifies and catalogs video metadata and high-resolution media URIs simultaneously, ensuring maximum speed during extraction cycles ⚡🏎️

DOM Synchronization & Content Verification 🧩
To maintain complete data fidelity, the YouTube Video Downloader Pro waits for specific network-idle states before capturing deep metrics and verifying that the generated link is active 🛡️✅

Dynamic Stream Selection 🎞️
The YouTube Video Downloader Pro features an advanced decision layer that evaluates all available streams to select the exact resolution and bitrate requested by the user 🏷️🔍

Resource Prioritization 💾
The YouTube Video Downloader Pro selectively targets high-value JSON fragments, significantly reducing computational overhead while maximizing download quality 📉🚀

#### 🌟 2. Strategic Features of the YouTube Video Downloader Pro

The YouTube Video Downloader Pro is distinguished by its ability to extract "silent" media points that are often invisible to the average observer. Below are the functional pillars that define the power of the YouTube Video Downloader Pro: 💎 🔓

🔒 Zero-API Dependency Discovery: The YouTube Video Downloader Pro functions entirely as an independent observer. It never requires official API keys or restricted developer tokens, protecting your projects from platform quotas. 🕵️‍♂️ 🛡️

📄 Lossless Quality Preservation: Captures media in its original uploaded resolution through the YouTube Video Downloader Pro's advanced direct-link retrieval layer. 🏷️ 📡

🏢 Bulk Batch Processing: Simply provide a list of URLs, and the YouTube Video Downloader Pro will automatically crawl and download the entire batch with incredible efficiency. 📊 📈

🖼️ HD Media Mapping: The YouTube Video Downloader Pro finds the highest resolution source URIs and caption tracks, perfect for building enterprise-grade visual archives. 🎨 📸

⚡ Extreme Concurrency Support: Engineered to handle massive requests, the YouTube Video Downloader Pro can process approximately 100 videos in under 5 minutes. 🚀 🌌

📊 Unified Data Schema: Every result from the YouTube Video Downloader Pro is normalized into a clean, flattened structure ready for immediate database ingestion. 📁 💾

#### 🛡️ 3. The Stealth-Audit Security Protocol of the YouTube Video Downloader Pro

In the high-security environment of professional web architecture, platforms employ highly sensitive AI-driven bot-detection. The YouTube Video Downloader Pro stays ahead with a multi-layered stealth defense system that ensures uninterrupted operation and consistent data flow. 🤺 🔒

🎭 Pseudo-User Fingerprinting: Every session of the YouTube Video Downloader Pro is assigned a unique browser signature—including Canvas fingerprints and WebGL signatures—to mimic a legitimate organic visitor. 🎭 💻

🚫 Rate-Limit Resilience: The YouTube Video Downloader Pro features adaptive sleep timers that expand and contract based on the server's response headers to prevent IP flagging. ⏳ 🚦

🛡️ Residential Proxy Synergy: By funneling requests through a global network of home-based IP addresses, the YouTube Video Downloader Pro makes its traffic indistinguishable from standard human traffic. 🏠 🌎

🌍 Global Access Discovery: Use the YouTube Video Downloader Pro to see specific trending content or localized descriptions that are restricted to certain geographic regions. 📍 🗺️

#### 📊 4. Schema Mapping & Data Field Intelligence

The output generated by the YouTube Video Downloader Pro is designed for mathematical precision and ease of use in high-end Business Intelligence (BI) tools. 📋 🧪
| Category                  | Fields Extracted by YouTube Video Downloader Pro | Analytical Value 💡                               |
| ------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Institutional Identity 🆔 | sourceUrl, channelName, videoId                  | Fundamental source classification                 |
| Media Assets 🎬           | downloadUrl, thumbnailUrl, quality               | Direct asset acquisition and management           |
| Engagement 📈             | viewCount, likeCount, commentCount               | Viral coefficient and audience resonance auditing |
| Content ✍️                | title, description, tags                         | Semantic analysis and keyword extraction          |
| Metadata ⏱️               | duration, uploadDate, category                   | Content frequency and timing optimization         |
| Automation Tags 🔗        | userData (Custom injection)                      | Data lineage and internal ID mapping              |

#### 📈 5. Enterprise Use Cases for the YouTube Video Downloader Pro

Elite marketing firms, PR agencies, and tech startups leverage the YouTube Video Downloader Pro to build a 360-degree view of their competitive landscape and asset library. 🏆 🏢

🎯 Creative Content Auditing
Utilize the YouTube Video Downloader Pro to download and analyze the visual aesthetic of the top 100 competitors in your niche. The YouTube Video Downloader Pro allows you to see which visual styles and hooks are driving the highest engagement density. 🕵️‍♀️ 🎨

📊 Competitive Messaging Research
Before launching a new campaign, use the YouTube Video Downloader Pro to audit the feedback and messaging on high-performance videos from competing brands. The YouTube Video Downloader Pro provides the raw video data needed to identify recurring customer pain points. 📉 🔍

🚀 Lead Generation & High-Intent Monitoring
Automatically scan thousands of public descriptions using the YouTube Video Downloader Pro to find every brand or service mentioned. The YouTube Video Downloader Pro helps you identify high-intent prospects who are actively discussing niche solutions your business provides. 🤝 💸

📉 Crisis Detection & Narrative Monitoring
Monitor the spread of specific keywords or brand mentions across a network of media using the YouTube Video Downloader Pro. By extracting text and media at scale, the YouTube Video Downloader Pro acts as an early-warning system. 🚨 🛡️

🏢 AI Training & NLP Dataset Construction
Feed the high-resolution assets and clean text results from the YouTube Video Downloader Pro directly into your custom Computer Vision or Large Language Models (LLMs). The YouTube Video Downloader Pro provides massive, niche-specific datasets for predictive modeling. 🤖 🧠

🛠️ 6. Technical Integration Workflows for the YouTube Video Downloader Pro
The YouTube Video Downloader Pro is a developer-first tool, designed to integrate seamlessly with modern CI/CD pipelines and automated marketing stacks. 🔗 💻

🔄 Webhook Synchronization: Configure the YouTube Video Downloader Pro to send an instant POST request to your server as soon as a media audit is finalized. 📡 🔔

🤖 Cloud Sync Pipelines: Automatically push every file extracted by the YouTube Video Downloader Pro to Google Drive, Dropbox, or a private AWS S3 bucket. ☁️ 📤

📊 Visualization Ready: Since the YouTube Video Downloader Pro outputs clean CSV/JSON, you can plug the data directly into Tableau or Looker for real-time reporting. 📈 📉

#### 🧠 7. Unique Predictive Analytics Strategies

Beyond basic downloading, the YouTube Video Downloader Pro allows for "Forward-Looking" strategies that give your business an unfair advantage: 🔮 ⚡

Visual Aesthetic Shifts: Use the YouTube Video Downloader Pro to monitor changes in visual branding. A sudden shift in color palettes or video pacing often signals an upcoming rebranding effort. 🎨 🎖️

Keyword Density Evolution: Use the YouTube Video Downloader Pro to track how audience vocabulary has shifted within descriptions, signaling changes in your target demographic. 🗣️ 🔍

Engagement Decay Mapping: By tracking a post over several days with the YouTube Video Downloader Pro, you can determine the exact "half-life" of viral content in your niche. 📉 📉

#### 🛡️ 8. Advanced Anti-Detection & Scalability

The YouTube Video Downloader Pro is engineered for high-volume enterprise operations where millions of entries need to be audited across global markets. 🌍 🚀

🎭 Hardware Footprint Rotation: The YouTube Video Downloader Pro constantly changes its virtual hardware profile—spoofing RAM, CPU cores, and GPU signatures—making it indistinguishable from organic devices. 💻 📱

🌍 Proxy Pool Diversification: Supports massive rotating residential proxy pools, ensuring the YouTube Video Downloader Pro achieves a 99.9% success rate regardless of volume. 🏠 🌎

⏳ Smart Throttling Logic: To protect the integrity of the data source, the YouTube Video Downloader Pro automatically adjusts its request velocity based on server response time. ⚖️ ⏱️

#### ❓ 9. Frequently Asked Questions (FAQ)

🏢 Can the YouTube Video Downloader Pro see private account content?

No. The YouTube Video Downloader Pro is strictly for public transparency. If the content is not publicly accessible, the YouTube Video Downloader Pro will not extract it. 🔒 🔢

📅 Does it extract the original image resolution?

Yes. The YouTube Video Downloader Pro bypasses standard web previews to find the original source URL for both thumbnails and high-res media. ✅ 🏷️

♾️ Is there a limit on the number of links?

The YouTube Video Downloader Pro shatters limitations. Whether you need 10 items or 10,000, the tool processes the collection with surgical precision. 🚀 🌌

📂 What output formats are available?

The YouTube Video Downloader Pro delivers results in JSON, CSV, and Excel (XLSX). 📁 💾

#### 🛡️ 10. Compliance & Ethical Framework

Using the YouTube Video Downloader Pro comes with a commitment to professional data ethics and responsible usage. ⚖️ 🤝

🏛️ Public Data Protocol: The YouTube Video Downloader Pro only extracts content that users and brands have explicitly shared for the purpose of being viewed. 📖 🔓

🚦 Rate Limit Adherence: The YouTube Video Downloader Pro is designed to be a "considerate visitor," maintaining optimal traffic patterns to protect server integrity. 🚦 🛡️

⚖️ Data Privacy Alignment: The YouTube Video Downloader Pro focuses on engagement metrics and public content; it does not harvest non-public personal information or private messages. 🔒 🛡️

🤝 Strategic Integrity: We advocate for using the YouTube Video Downloader Pro for competitive transparency and academic research within legal boundaries. 🏛️ ⚖️

#### 🏁 11. Conclusion: Master the Visual Data Economy

In the data-driven landscape, those who can observe and archive their environment most accurately win. The YouTube Video Downloader Pro is the ultimate bridge between unstructured social noise and clear, strategic business intelligence. It eliminates the manual work of searching and replaces it with a streamlined, automated, and intelligent data pipeline. 🌟 🏆

Whether you are a startup looking for your first viral hook, an agency building a regional lead list, or a researcher tracking the history of social video, the YouTube Video Downloader Pro is your most reliable partner. By choosing the YouTube Video Downloader Pro, you are investing in a scalable intelligence strategy that will serve your organization for years to come. 🚀📈

#### 🚀 Get Started with the YouTube Video Downloader Pro Today!

Are you ready to revolutionize your social media asset management? The YouTube Video Downloader Pro is waiting for your first list of links. If you need a custom configuration for the YouTube Video Downloader Pro or help setting up a cloud-based schedule, our technical team is here to support you. 🤝 ✨

# Actor input Schema

## `startUrls` (type: `array`):

List of YouTube video or shorts URLs.

## `quality` (type: `string`):

Select the desired video resolution. The actor will find the best match at or below this quality.

## `format` (type: `string`):

Select the preferred file format (container). Note: Some formats may not be available for all videos.

## `filenameTemplate` (type: `string`):

Choose how the output filename should be structured in the metadata.

## `proxyConfiguration` (type: `object`):

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.youtube.com/shorts/y-k9CQMJcRQ"
    }
  ],
  "quality": "720",
  "format": "mp4",
  "filenameTemplate": "title",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.youtube.com/shorts/y-k9CQMJcRQ"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers-hub/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 = {
    "startUrls": [{ "url": "https://www.youtube.com/shorts/y-k9CQMJcRQ" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers-hub/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 '{
  "startUrls": [
    {
      "url": "https://www.youtube.com/shorts/y-k9CQMJcRQ"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scrapers-hub/youtube-video-downloader --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Youtube Video Downloader",
        "description": "🎥 YouTube Video Downloader ⬇️ — fast, secure tool to save videos in HD/4K as MP4 or MP3 for offline access. ✅ Download playlists, captions & thumbnails. ⚡️ Batch support, clean UI. Use for your own content or with permission. Perfect for creators, educators & teams.",
        "version": "0.1",
        "x-build-id": "LnWg9JRPI4Qcpa217"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapers-hub~youtube-video-downloader/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapers-hub-youtube-video-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapers-hub~youtube-video-downloader/runs": {
            "post": {
                "operationId": "runs-sync-scrapers-hub-youtube-video-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapers-hub~youtube-video-downloader/run-sync": {
            "post": {
                "operationId": "run-sync-scrapers-hub-youtube-video-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "YouTube Video URLs",
                        "type": "array",
                        "description": "List of YouTube video or shorts URLs.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "quality": {
                        "title": "Preferred Quality",
                        "enum": [
                            "144",
                            "240",
                            "360",
                            "480",
                            "720",
                            "1080",
                            "1440",
                            "2160"
                        ],
                        "type": "string",
                        "description": "Select the desired video resolution. The actor will find the best match at or below this quality.",
                        "default": "720"
                    },
                    "format": {
                        "title": "Preferred Format",
                        "enum": [
                            "mp4",
                            "webm",
                            "mkv",
                            "mov",
                            "avi",
                            "flv",
                            "mp3",
                            "m4a",
                            "aac",
                            "wav"
                        ],
                        "type": "string",
                        "description": "Select the preferred file format (container). Note: Some formats may not be available for all videos.",
                        "default": "mp4"
                    },
                    "filenameTemplate": {
                        "title": "Name your file with",
                        "enum": [
                            "title",
                            "uploader",
                            "timestamp",
                            "id"
                        ],
                        "type": "string",
                        "description": "Choose how the output filename should be structured in the metadata.",
                        "default": "title"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your crawler.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```