YouTube Video Downloader

Data & APIs

Download YouTube videos by URL in various resolutions using a pay-per-use API with credit-based authentication and no charge on failed downloads. Use when users request to download YouTube videos, extract audio, or specify resolution requirements (360p, 480p, 720p, 1080p, best quality). Triggers on phrases like "download YouTube video", "download from YouTube", "save YouTube video", "extract YouTube audio", "download video in [resolution]".

Install

openclaw skills install youtube-downloader-skill

YouTube Video Downloader Skill

Download any YouTube video in various resolutions with a simple command. Supports 360p, 480p, 720p, 1080p, best quality, and audio-only extraction.

Quick Install

Just tell OpenClaw:

"Help me install this skill: https://clawhub.ai/jxyyjm/youtube-downloader-skill"

OpenClaw will ask you for an API Key. Follow these steps to get one:

That's it! You're ready to use the skill.

Usage

Once installed, just tell OpenClaw what you want. For example:

"Download this YouTube video: https://youtube.com/watch?v=dQw4w9WgXcQ"

"Download this video in 1080p: https://youtube.com/watch?v=xxxxx"

"Extract audio from this video: https://youtube.com/watch?v=xxxxx"

Supported resolutions: 360p, 480p, 720p (default), 1080p, best, audio-only.

Authentication

All API calls require an API Key in the Authorization header:

Authorization: Bearer sk-yt-xxxxx

Get your API Key at: https://skill.lordest.cn/?page=apikeys

Endpoints

POST /api/v1/download

Download a YouTube video.

Request:

{
  "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "resolution": "720"
}

Parameters:

  • youtube_url (required): YouTube video URL
  • resolution (optional): "360", "480", "720", "1080", "best", "audio". Default: "720"

Response (success):

{
  "success": true,
  "download_url": "https://oss-bucket.aliyuncs.com/skill/abc123/video.mp4",
  "video_title": "Video Title",
  "video_duration": 212,
  "file_size": 52428800,
  "resolution": "720",
  "processing_time": 45.2
}

GET /api/v1/balance

Check account status.

Response:

{
  "username": "user123"
}

GET /health

Health check (no authentication required).

Response:

{
  "status": "healthy",
  "service": "YouTube Video Downloader Service",
  "version": "1.0.0"
}

Error Codes

CodeMeaning
200Success
401Invalid or missing API Key
400Invalid request (bad URL, etc.)
500Server error

Example (curl)

# Download a video
curl -X POST https://skill.lordest.cn/api/v1/download \
  -H "Authorization: Bearer sk-yt-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"youtube_url": "https://youtube.com/watch?v=dQw4w9WgXcQ", "resolution": "720"}'

Example (Python)

import requests

API_KEY = "sk-yt-xxxxx"
BASE_URL = "https://skill.lordest.cn"

# Download
resp = requests.post(
    f"{BASE_URL}/api/v1/download",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"youtube_url": "https://youtube.com/watch?v=dQw4w9WgXcQ", "resolution": "720"}
)
data = resp.json()
if data["success"]:
    print(f"Download URL: {data['download_url']}")