docs/integrations/block-integrations/video/download.md
This block downloads videos from URLs, supporting a wide range of video platforms and direct links.
<!-- END MANUAL -->Download video from URL (YouTube, Vimeo, news sites, direct links)
The block uses yt-dlp, a powerful video downloading library that supports over 1000 websites. It accepts a URL, quality preference, and output format, then downloads the video while merging the best available video and audio streams for the selected quality. Quality options: best (highest available), 1080p/720p/480p (maximum resolution at that height), audio_only (extracts just the audio track).
<!-- END MANUAL -->| Input | Description | Type | Required |
|---|---|---|---|
| url | URL of the video to download (YouTube, Vimeo, direct link, etc.) | str | Yes |
| quality | Video quality preference | "best" | "1080p" | "720p" | "480p" | "audio_only" | No |
| output_format | Output video format | "mp4" | "webm" | "mkv" | No |
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| video_file | Downloaded video (path or data URI) | str (file) |
| duration | Video duration in seconds | float |
| title | Video title from source | str |
| source_url | Original source URL | str |