YouTube Video Download API
Download YouTube videos including standard videos, Shorts, and multiple URL formats. Supports various quality options from 360p to 4K, with audio extraction capabilities.
Supported Features
- Standard YouTube videos
- YouTube Shorts
- Multiple URL format support
- Quality selection (360p to 4K)
- Audio extraction (MP3)
- Playlist support
Quick start example
Download YouTube videos with a simple API call. Here's how to get started:
curl --request GET \--url 'https://api.endpoint-hidden-contact-us.com/v1/video/download?query=https://youtube.com/watch?v=VIDEO_ID' \--header 'x-api-key: YOUR_API_KEY'
{"job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"}
Use the job_id to check the download status via the Jobs endpoint.
Job completed response
What you get when the download is ready
Once the job completes, retrieve the full response using the job_id. Here's an example of a completed YouTube video download:
curl -X GET "https://api.endpoint-hidden-contact-us.com/v1/jobs/019b550b-da47-4d31-b764-242dfb16944e" \-H "Authorization: Bearer YOUR_API_KEY"
{"id": "019b550b-da47-4d31-b764-242dfb16944e","success": true,"status": "CompletedJob","endpoint": "/api/video/download","created_at": "2025-12-25T10:26:38.790691Z","started_at": "2025-12-25T10:26:38.794956Z","duration_ms": 19677,"args": {"query": "https://www.youtube.com/watch?v=i6TFNxgi7p4","video_format": "mp4","download_type": "video","video_quality": "best","async": false},"result": {"metadata": {"title": "Example YouTube Video Title","duration": 127,"thumbnail": "https://example.com/thumbnail.jpg","resolution": "1920x1080","view_count": 125430,"like_count": 8542,"channel_id": "xxxxxx","description": "Video description from YouTube...","upload_date": 1760832000},"response": "https://s3.domain.com/videos/00b2b9fb-0d26-468b-8c14-d07c22161992.mp4"}}
result.response
Direct S3 URL to download the processed video file. Cached and ready for immediate access.
result.metadata
Rich metadata including title, duration, thumbnails, view counts, and more.
duration_ms
Processing time in milliseconds. Most jobs complete in under 30 seconds.
status
Job status: PendingJob, RunningJob, or CompletedJob.
Why use our YouTube video download API
Built for reliability, speed, and ease of integration
Live processing
Real-time extraction of YouTube videos with async job tracking
High reliability
99.9% uptime with automatic failover and error handling
Multiple formats
Support for MP4, WebM, MKV, MP3 with quality options
Start downloading YouTube videos today
Get your API key and start integrating our YouTube video download API into your application.