MCP docs › Tools › YouTube Downloader
YouTube Downloader
youtube_download fast Video, audio & downloads
Get downloadable media URLs and available formats/metadata for a YouTube video.
When to use. Getting direct media URLs and the available format/quality list for a YouTube video.
Not for. Transcripts (use youtube_transcript) or stats (use youtube_extract).
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
url |
string | yes | — | YouTube video URL. |
Returns
Media URLs plus a formats list.
Each row typically carries: title duration thumbnail formats download_url quality ext filesize
The response body is { status, count, fields, results }. Runs that exceed the inline wait return { status: "running", job_id, tool_flow } instead — see Jobs & errors.
Call it over MCP
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "youtube_download",
"arguments": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
}
}
Call it over the REST API
curl -X POST https://convertfleet.online/api/tool-run \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"dl_yt","params":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}}'
Both paths run the same job engine, enforce the same plan limits and count against the same monthly quota. See the REST API page.
Related tools
youtube_extractGetting stats/metadata for a YouTube video, or listing a channel's recent uploads. Auto-detects video vs channel from the URL.youtube_transcriptReading what was actually SAID in videos — summarising talks, mining podcasts/webinars, repurposing content, answering questions about a vid
JSON Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "YouTube video URL."
}
},
"additionalProperties": false,
"required": [
"url"
]
}