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 "Authorization: Bearer YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/download?url=...', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await res.json();
const res = await fetch('https://api.cludz.net/v1/youtube/download?url=...', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await res.json();
import requests
url = "https://api.cludz.net/v1/youtube/download"
params = {"url": "https://youtu.be/..."}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 200,
"statusMessage": "Success",
"message": "Media downloaded successfully",
"data": {
"title": "Video Title",
"url": "https://download.url...",
"thumbnail": "https://thumbnail.url...",
"duration": 120,
"author": "Author Name"
}
}
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 "Authorization: Bearer YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/search?query=lofi&limit=5', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await res.json();
const res = await fetch('https://api.cludz.net/v1/youtube/search?query=lofi&limit=5', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await res.json();
import requests
url = "https://api.cludz.net/v1/youtube/search"
params = {"query": "lofi", "limit": 5}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 200,
"statusMessage": "Success",
"message": "Search result",
"data": {
"count": 5,
"list": [
{
"id": "videoId",
"title": "Video Title",
"url": "https://youtube.com/watch?v=...",
"thumbnail": "https://thumbnail.url...",
"duration": 120,
"views": 1000
}
]
}
}
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 "Authorization: Bearer YOUR_API_KEY"
const res = await fetch('https://api.cludz.net/v1/youtube/search/download?query=never gonna give you up', {
headers: { 'Authorization': 'Bearer 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: { 'Authorization': 'Bearer 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 = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
data = response.json()
Response
{
"statusCode": 200,
"statusMessage": "Success",
"message": "Media downloaded successfully",
"data": {
"title": "Video Title",
"url": "https://download.url...",
"thumbnail": "https://thumbnail.url...",
"duration": 120,
"author": "Author Name"
}
}