Downloader
YouTube
Download videos and audio from YouTube.
GET /v1/youtube/download
https://api.cludz.net/v1/youtube/download
Download a specific video by URL.
Query Parameters:
| Parameter | Required | Description | Type |
|---|---|---|---|
url | Yes | The valid YouTube video URL. | string |
format | No | mp4 (video) or mp3 (audio). Defaults to mp4. | string |
Example
curl "https://api.cludz.net/v1/youtube/download?url=https://youtu.be/..." \
-H "X-API-Key: YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/download?url=...', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
const res = await fetch('https://api.cludz.net/v1/youtube/download?url=...', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
import requests
url = "https://api.cludz.net/v1/youtube/download"
params = {"url": "https://youtu.be/..."}
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 202,
"statusMessage": "Accepted",
"message": "Download task created",
"data": {
"taskId": "tsk_123456789",
"status_url": "/v1/tasks/tsk_123456789"
}
}
This endpoint uses background tasks. Poll the
status_url or use the Tasks API to get the final downloaded media.GET /v1/youtube/search
https://api.cludz.net/v1/youtube/search
Search for videos on YouTube.
Query Parameters:
| Parameter | Required | Description | Type |
|---|---|---|---|
query | Yes | The search query string. | string |
limit | No | Number of results (max 5). Defaults to 1. | number |
Example
curl "https://api.cludz.net/v1/youtube/search?query=lofi&limit=5" \
-H "X-API-Key: YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/search?query=lofi&limit=5', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
const res = await fetch('https://api.cludz.net/v1/youtube/search?query=lofi&limit=5', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
import requests
url = "https://api.cludz.net/v1/youtube/search"
params = {"query": "lofi", "limit": 5}
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 202,
"statusMessage": "Accepted",
"message": "Search task created",
"data": {
"taskId": "tsk_123456789",
"status_url": "/v1/tasks/tsk_123456789"
}
}
This endpoint uses background tasks. Poll the
status_url or use the Tasks API to get the final search results.GET /v1/youtube/search/download
https://api.cludz.net/v1/youtube/search/download
Search for a video and download the first result immediately.
Query Parameters:
| Parameter | Required | Description | Type |
|---|---|---|---|
query | Yes | The search query string. | string |
format | No | mp4 or mp3. Defaults to mp4. | string |
Example
curl "https://api.cludz.net/v1/youtube/search/download?query=never%20gonna%20give%20you%20up" \
-H "X-API-Key: YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/search/download?query=never gonna give you up', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
const res = await fetch('https://api.cludz.net/v1/youtube/search/download?query=never gonna give you up', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await res.json();
import requests
url = "https://api.cludz.net/v1/youtube/search/download"
params = {"query": "never gonna give you up"}
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 202,
"statusMessage": "Accepted",
"message": "Download task created",
"data": {
"taskId": "tsk_123456789",
"status_url": "/v1/tasks/tsk_123456789"
}
}
This endpoint uses background tasks. Poll the
status_url or use the Tasks API to get the final search results.