動画ダウンロード API ドキュメント

EasyDown REST API プラットフォームガイド

YouTube 動画ダウンロード API

公開 YouTube URL を共通 REST Endpoint に送信すると、利用可能な動画・音声候補をすべて保持したレスポンスを返し、バックエンド側で形式を選択できます。

EasyDown YouTube 動画ダウンロード API で、公開動画、Shorts、リプレイ URL から動画、音声、サムネイル、再生時間、画質情報を取得します。

YouTube 動画取得 API · YouTube Shorts ダウンロード API

API Token を作成API 料金を見るWeb ダウンローダー

本番 REST Endpoint

POST https://api.easydown.org/api/v1/parse

対応する公開 URL 形式

youtube.com/watch?v={id}youtu.be/{id}youtube.com/shorts/{id}youtube.com/live/{id}

実際のリクエスト例

https://www.youtube.com/shorts/xzOtM0x3_LU?feature=share

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/shorts/xzOtM0x3_LU?feature=share"}'

プラットフォーム固有レスポンス例

共通レスポンス外形は一定で、プラットフォームに応じてメディア配列と属性が入ります。

メディアの返却動作

videos[] にはプログレッシブ形式と動画のみのストリームが含まれます。分離音声は audios[] に入り、高画質 DASH は保存後に FFmpeg で結合する場合があります。

{
  "status": 200,
  "data": {
    "platform": "youtube",
    "title": "Example youtube public post",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "duration": 24,
    "images": [],
    "videos": [
      {
        "url": "https://cdn.example.com/video.mp4",
        "quality": "1080p video-only",
        "mimeType": "video/mp4",
        "width": 1080,
        "height": 1920,
        "hasAudio": false,
        "source": "direct"
      }
    ],
    "audios": [
      {
        "url": "https://cdn.example.com/audio.m4a",
        "quality": "128kbps",
        "mimeType": "audio/mp4"
      }
    ]
  },
  "msg": "success"
}

ダウンロードとプロキシ規則

バックエンドからブラウザー User-Agent、YouTube Referer、Origin、Range を付けて取得します。ストリームが解析サーバーの IP や地域に依存する場合があります。

推奨バックエンドリクエストヘッダー

User-Agent: Mozilla/5.0 Referer: https://www.youtube.com/ Origin: https://www.youtube.com/ Range: bytes=0-

非対応・利用できない内容

再生リスト、チャンネル、コミュニティ投稿、非公開、メンバー限定、DRM、地域制限動画には対応しません。

利用権限のある公開メディアだけを処理してください。EasyDown はプライバシー設定、DRM、削除済みコンテンツ、プラットフォーム制限を回避しません。

プラットフォーム固有のトラブル対処

選択画質に音声がない場合は分離音声を結合します。

署名 URL が期限切れまたは 403 の場合は元 URL を再解析します。

地域制限がある公開メディアはアクセス可能なサーバー地域を使用します。

REST 連携フロー

  1. 1

    Private API Token を作成し、このプラットフォームを権限で許可します。

  2. 2

    完全な公開投稿 URL を共通 Endpoint に POST します。

  3. 3

    images、videos、audios から必要項目を選びバックエンド経由で取得します。

関連プラットフォーム API ドキュメント

TikTok

TikTok 動画ダウンロード API

Instagram

Instagram ダウンロード API：リール・動画・写真

Twitter / X

Twitter / X 動画ダウンロード API

Threads

Threads 動画・画像ダウンロード API

Bilibili

Bilibili 動画ダウンロード API

Xiaohongshu / RedNote

Xiaohongshu / RedNote メディアダウンロード API

EasyDown のその他の利用方法

AI Agent では MCP Endpoint、手動の公開メディア処理では Web ツールを利用できます。

プラットフォーム MCP ガイド

Download API に関する質問

YouTube Download API はどの URL に対応しますか？

対応する公開単体投稿形式は youtube.com/watch?v={id}, youtu.be/{id}, youtube.com/shorts/{id}, youtube.com/live/{id} です。再生リスト、チャンネル、コミュニティ投稿、非公開、メンバー限定、DRM、地域制限動画には対応しません。

YouTube Download API はどのメディアを返しますか？

videos[] にはプログレッシブ形式と動画のみのストリームが含まれます。分離音声は audios[] に入り、高画質 DASH は保存後に FFmpeg で結合する場合があります。

返された YouTube メディア URL はどう取得しますか？

バックエンドからブラウザー User-Agent、YouTube Referer、Origin、Range を付けて取得します。ストリームが解析サーバーの IP や地域に依存する場合があります。

YouTube API の課金方法は？

画像、動画、音声 URL を一件以上返した成功リクエストは 1 credit です。失敗、非対応、認証エラー、空結果は課金されません。