YouTube Shorts Downloader - Advanced Filters

Overview

An Apify actor for downloading YouTube Shorts with extensive control over output formats and quality. It downloads video, extracts audio, and fetches thumbnails, supporting multiple resolutions and formats for each. It includes features to bypass geo-restrictions and provides detailed file metadata.

Key Features

• Video Download: Fetches videos in resolutions from 360p to 1920p. Supports MP4, MKV, WebM, and AVI formats.
• Audio Extraction: Can download audio-only tracks in MP3, M4A, AAC, OPUS, OGG, FLAC, or WAV format, with bitrate options from 128 to 320 kbps.
• Thumbnail Handling: Downloads and converts thumbnails to JPG, PNG, or WebP. Allows custom dimensions or preset resolutions.
• Geo-Restriction Bypass: Uses Apify's proxy infrastructure to access region-locked content.
• Metadata Analysis: Returns detailed technical information about the downloaded media, including codec, resolution, bitrate, and sample rate.
• Storage: Provides permanent download links via the Apify Key-Value Store.

How to Use

Configure the actor using input parameters. The actor processes the provided YouTube Shorts URLs and outputs download links and metadata.

Input Configuration

The primary input is a JSON object. At minimum, provide an array of video URLs.

Basic Example:

{
  "video_urls": [
    { "url": "https://www.youtube.com/shorts/sOxloXyOAKA" }
  ],
  "desired_resolution": "1080p"
}

Advanced Example (with filters):

{
  "use_key_value_store": true,
  "video_urls": [
    { "url": "https://www.youtube.com/shorts/sOxloXyOAKA" }
  ],
  "desired_resolution": "1080p",
  "video_format": "mp4",
  "audio_format": "mp3",
  "audio_quality": "320",
  "download_audio_only": false,
  "thumbnail_format": "png",
  "thumbnail_resolution": "1080p"
}

Key Input Parameters:
* video_urls (Array, Required): List of objects containing url keys for YouTube Shorts.
* desired_resolution (String): Target resolution (e.g., "720p", "1080p"). Defaults to the highest available.
* video_format (String): Output container format (mp4, mkv, webm, avi).
* audio_format (String): Format for audio extraction (mp3, m4a, aac, opus, ogg, flac, wav).
* audio_quality (String): Bitrate in kbps for audio (128, 192, 256, 320).
* download_audio_only (Boolean): Set to true to download audio tracks without video.
* thumbnail_format (String): Format for thumbnail download (jpg, png, webp).
* thumbnail_resolution (String): Target thumbnail size (e.g., "1080p") or a custom "widthxheight" string.
* use_key_value_store (Boolean): If true, provides persistent download links via Apify's Key-Value Store.

Output

The actor returns a dataset where each item corresponds to a processed video URL. Output includes:
* Download Links: URLs for the downloaded video, audio, and thumbnail files.
* Metadata: Technical details about the media (codec, resolution, duration, bitrate, etc.).
* Storage Information: When use_key_value_store is enabled, the apifyStorageUrl provides a stable link to the files.

Example Output Item:

{
  "url": "https://www.youtube.com/shorts/sOxloXyOAKA",
  "videoDownloadUrl": "https://api.apify.com/v2/key-value-stores/.../video.mp4",
  "audioDownloadUrl": "https://api.apify.com/v2/key-value-stores/.../audio.mp3",
  "thumbnailDownloadUrl": "https://api.apify.com/v2/key-value-stores/.../thumbnail.png",
  "metadata": {
    "video": { "format": "mp4", "resolution": "1080p", "codec": "avc1.64002a", "bitrate": "1500kbps" },
    "audio": { "format": "mp3", "bitrate": "320kbps", "sampleRate": "44100 Hz" }
  },
  "apifyStorageUrl": "https://api.apify.com/v2/key-value-stores/..."
}