Overview
Download video from any URL and return a temporary download link
Credits
Video: 3, Audio: 2
Providers
SDK Method
client.videoDownload(...)
Modes
The mode parameter is a preset that configures optimal provider routing for common use cases. You can also set individual parameters directly for fine-grained control.
Video
3 creditsDownload as MP4 video.
Full video+audio merged into MP4, up to 3 hours long. 5-60s on most sites; YouTube answers with a job_id first and takes 1-3 minutes, about 40 for a two-hour video.
Audio
2 creditsExtract audio only.
Audio track as MP3 or M4A. Faster, smaller file.
Parameters
urlstring
URL of the video or post containing a video. Send this, or job_id to collect a download in progress.
job_idstring
The job_id of an answer whose status was processing: send it instead of url to get the file once it is ready. Checking is free; the call that returns the file is charged.
qualityselect (default: 720)
Desired video quality (best available up to this resolution).
formatselect (default: mp4)
Output format.
Example Response
{
"success": true,
"data": {
"download_url": "https://cdn.example.com/downloads/abc123.mp4?X-Amz-Signature=...",
"expires_at": "2026-05-03T14:30:00Z",
"filename": "Example_Video_Title.mp4",
"filesize_mb": 22.1,
"duration_seconds": 245,
"quality": "720p",
"format": "mp4",
"title": "Example Video Title",
"thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
},
"metadata": {
"provider_used": "yt_dlp",
"providers_tried": [
"yt_dlp"
],
"response_time_ms": 12500,
"request_id": "req_v1d30dl"
},
"credits_used": 3
}Get Started
Create a Suprbrowser API key in your dashboard, then call the endpoint with your key in the Authorization header.