YouTube 動画ダウンロード API
YouTubeの対応する公開URLを解析し、ダウンロード可能な動画・画像・音声と、機密項目を除去したプラットフォームデータを取得します。URL形式、レスポンス項目、エラー、実装例を掲載しています。
公開 YouTube URL を共通 REST Endpoint に送信すると、利用可能な動画・音声候補をすべて保持したレスポンスを返し、バックエンド側で形式を選択できます。
YouTube動画保存・ダウンロード機能を追加しながら、アプリ側では共通のメディア形式を維持できます。
安定したダウンロードメディアに加えてプラットフォーム固有項目が必要な場合に使用します。
エンドポイント
POST https://api.easydown.org/api/v1/platforms/youtube/parse
対応URL形式
youtube.com/watch?v={id}youtube.com/shorts/{id}youtube.com/live/{id}youtu.be/{id}
利用可能な例
https://www.youtube.com/watch?v=BiBY6TeIvJ4https://youtu.be/MEoxtFRfPochttps://www.youtube.com/shorts/xzOtM0x3_LU
このプラットフォームのレスポンス内容
videos[] にはプログレッシブ形式と動画のみのストリームが含まれます。分離音声は audios[] に入り、高画質 DASH は保存後に FFmpeg で結合する場合があります。
公開済みプラットフォームデータ項目
対象投稿の最終レスポンスに含まれるその他の公開項目も、機密情報を再帰的に除去したうえで保持します。以下の項目は現在の platformDataVersion 内で安定しています。
| 項目 | 型 | 説明 |
|---|---|---|
data.media | object | 正規化された画像、動画、音声、タイトル、サムネイル、再生時間。 |
data.platformDataVersion | string | YouTubeの公開データ契約バージョン。現在は1です。 |
data.platformData.videoDetails | object | 再生状態、形式、その他の公開メタデータです。 |
data.platformData.streamingData | object | 動画の再生候補、画質、コーデック、サイズ、メディアURLに関する情報です。 |
data.platformData.playabilityStatus | object | 再生状態、形式、その他の公開メタデータです。 |
data.platformData.microformat | object | 再生状態、形式、その他の公開メタデータです。 |
data.platformData.captions | object | 再生状態、形式、その他の公開メタデータです。 |
{
"status": 200,
"data": {
"media": {
"platform": "youtube",
"title": "公開投稿の例",
"thumbnail": "https://public-cdn.example/cover.jpg",
"duration": 18,
"images": [],
"videos": [
{
"url": "https://public-cdn.example/video.mp4",
"quality": "1080p",
"mimeType": "video/mp4",
"width": 1920,
"height": 1080,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"platformData": {
"videoDetails": {
"videoId": "BiBY6TeIvJ4",
"title": "Example public YouTube video",
"lengthSeconds": "42",
"channelId": "channel-id"
},
"streamingData": {
"formats": [
{
"itag": 18,
"mimeType": "video/mp4",
"qualityLabel": "360p",
"url": "https://media.example/video.mp4"
}
],
"adaptiveFormats": [
{
"itag": 140,
"mimeType": "audio/mp4",
"bitrate": 128000,
"url": "https://media.example/audio.m4a"
}
]
},
"playabilityStatus": {
"status": "OK"
}
},
"platformDataVersion": "1"
},
"msg": "success"
}ダウンロードとプロキシの注意点
バックエンドからブラウザー User-Agent、YouTube Referer、Origin、Range を付けて取得します。ストリームが解析サーバーの IP や地域に依存する場合があります。
制限と動作
再生リスト、チャンネル、コミュニティ投稿、非公開、メンバー限定、DRM、地域制限動画には対応しません。
公開コンテンツのみ対象です。非公開、削除済み、年齢・地域制限、ライブ配信、その他利用できないコンテンツは解析に失敗する場合があります。失敗時にクレジットは消費されません。
ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。認証、入力検証、権限、コンテンツ利用不可、メディアなし、外部サービス障害は課金されません。
トラブルシューティング
- 選択画質に音声がない場合は分離音声を結合します。
- 署名 URL が期限切れまたは 403 の場合は元 URL を再解析します。
- 地域制限がある公開メディアはアクセス可能なサーバー地域を使用します。
よくある質問
失敗したリクエストは課金されますか？
いいえ。ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。
正しい公開URLでも失敗するのはなぜですか？
投稿が削除済み、非公開、地域制限、ライブ、メディアなし、または外部サービスが一時的に利用できない可能性があります。
関連ガイド
対話型APIリファレンス
以下のcurl、JavaScript、Pythonの例とスキーマは、本番環境のOpenAPI 3.1契約から生成されます。
「Try it」パネルはapi.easydown.orgへ直接リクエストします。トークンはページのメモリだけに保持され、再読み込みすると消去されます。
試してみる
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/platforms/youtube/parse" \ -H "Content-Type: application/json" \ -d '{}'{ "status": 200, "data": { "media": { "platform": "tiktok", "title": "string", "thumbnail": "string", "duration": 0, "images": [ { "url": "http://example.com", "width": 0, "height": 0 } ], "videos": [ { "url": "http://example.com", "quality": "string", "mimeType": "string", "width": 0, "height": 0, "hasAudio": true, "source": "direct", "headers": { "property1": "string", "property2": "string" } } ], "audios": [ { "url": "http://example.com", "quality": "string", "mimeType": "string", "bitrate": 0, "source": "direct", "headers": { "property1": "string", "property2": "string" } } ] }, "platformData": { "videoDetails": {}, "streamingData": {}, "playabilityStatus": {}, "microformat": {}, "captions": {} }, "platformDataVersion": "1" }, "msg": "success"}