AgentBodyAgentBody
ログイン

YouTube 動画ダウンロード API

1回の POST で公開 YouTube 動画を MP4 としてダウンロード。レスポンスは永久的なダウンロード URL と動画メタデータを返します。

  • 1回の POST、1つの MP4
  • 画質パラメータ
  • 永久的なダウンロード URL
  • すべての公開リンク形式
  • 冪等キーサポート
  • サーバーサイドキー必須
ツールAPIAgent

リクエスト例

API ドキュメントを見る 完全な API リファレンス 
curl -X POST "https://api.agentbody.io/v1/youtube/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"quality":"144p","url":"YOUR_URL"}'

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Downloaded YouTube media link and normalized public video metadata.

{
  "duration_seconds": 180,
  "format": "mp4",
  "quality": "720p",
  "size_mb": 15.2,
  "title": "Example Video",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_content_type": "video/mp4",
  "video_id": "dQw4w9WgXcQ",
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/dQw4w9WgXcQ.mp4"
}

機能特徴

youtube.video_download 操作は1つの公開 YouTube 動画を MP4 ファイルとして保存します。サーバーが API キーを保持；エンドポイントは1回の呼び出しで永久的なダウンロード URL を返します。

1回の POST、1つの MP4

POST /v1/youtube/video/download に公開動画 URL と画質設定を送信します。成功した 200 は動画タイトル、再生時間、サムネイル、ファイルサイズ、永久的なダウンロード URL を返します。

画質パラメータ

ユースケースに必要な解像度をリクエストします。API は選択した画質でソース動画が提供するものを提供し、出力時に再エンコードしません。

永久的なダウンロード URL

URL は期限切れの CDN リダイレクトではなく、完全に保存されたファイルを指しています。どのサーバー、どの IP、いつでもダウンロード可能です。

すべての公開リンク形式

watch ページ、youtu.be ショートリンク、Shorts URL、埋め込みはすべて同じ動画に解決されます。非公開・削除済み・年齢制限動画は構造化されたエラーを返します。

冪等キーサポート

Idempotency-Key ヘッダーを渡すと、ネットワーク再試行が2回目のダウンロードや課金をトリガーしません。ゲートウェイはキーで重複を排除します。

サーバーサイドキー必須

エンドポイントはサーバーが保持する AgentBody API キーが必要です。バックエンド経由で呼び出しをルーティングし、キーをクライアントバンドルに出荷しないでください。

使い方

3ステップで API に YouTube 動画ダウンロードを統合。

01

API キーを取得

無料 AgentBody アカウントを作成し、ダッシュボードから API キーを生成します。

02

動画 URL を POST

/v1/youtube/video/download に POST リクエストと公開動画 URL、画質設定を送信します。安全な再試行のために Idempotency-Key ヘッダーを含めます。

03

ダウンロードリンクを受信

200 は永久的な MP4 URL とタイトル、再生時間、サムネイル、ファイルサイズを返します。直接ダウンロードするか、ストレージパイプラインに渡します。

よくある質問

YouTube 動画ダウンロード API はどのように動作しますか？

/v1/youtube/video/download に POST リクエストと公開動画 URL、画質設定を送信します。API は動画を MP4 ファイルとして保存し、タイトル、再生時間、サムネイル、ファイルサイズ付きの永久的なダウンロード URL を返します。

どの画質オプションがありますか？

API はリクエストした画質で、ソース動画が提供する解像度を提供します。すべての動画がすべての解像度を持つわけではありません——レスポンスはアップロードに実際に含まれるものを反映します。

ダウンロード URL は期限切れになりますか？

いいえ。URL は一時的な CDN リダイレクトではなく完全に保存されたファイルを指しているため、呼び出し後はどのサーバー、どのネットワークからでも機能します。

どの動画をダウンロードできますか？

公開動画のみ。非公開、削除済み、年齢制限、地域制限の動画はエラーを返し、課金されません。

課金はどのように行われますか？

各成功したダウンロードは、ゲートウェイ管理価格で AgentBody 残高から固定金額を消費します。失敗は課金されません；再試行時の重複課金を避けるために Idempotency-Key ヘッダーを使用してください。

ファイルサイズや長さの制限はありますか？

非常に長い動画は、毎回のダウンロードを予測可能な固定価格に保つ上流のコストガードによって拒否される場合があります。一般的なアップロードや Shorts は問題なく処理されます。