Video Download API
Video Platform

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.

MP4WebMMKVMP3

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:

download-youtube-video.sh
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'
Response200 OK
{
"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:

GET /api/jobs/{job_id}
curl -X GET "https://api.endpoint-hidden-contact-us.com/v1/jobs/019b550b-da47-4d31-b764-242dfb16944e" \
-H "Authorization: Bearer YOUR_API_KEY"
Completed Job Response200 OK
{
"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.