AgentBodyAgentBody
ログイン

YouTube Shorts ダウンロード API

認証付き POST 1 回で任意の YouTube Shorts URL を保存済み MP4 に——最高 720p の画質セレクター、直接動画リンク、メタデータをきれいな JSON で。

  • 単一 REST エンドポイント
  • すべての Shorts 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 Shorts ダウンロード API を転用パイプライン、コンテンツ調査、保存システムに使う——Shorts URL を入れ、MP4 リンクを得る。

単一 REST エンドポイント

bearer API キーと Shorts URL を付けて POST /v1/youtube/video/download を呼びます。API が MP4 を保存し直接リンクを返します。ヘッドレスブラウザもフォーマット交渉もスクレイピング基盤も不要です。

すべての Shorts URL 形態

youtube.com/shorts/ リンク、youtu.be リンク、アプリ共有リンク、Short を指す watch URL がすべて解決します。統合側はユーザーが貼るものをそのまま受け付け、正規化ステップが 1 つ減ります。

画質セレクター

quality フィールドに 144p、240p、360p、480p、720p を渡します。毎回のリクエストが正確な出力を固定し、レスポンスが配送された画質、フォーマット、サイズを確認します。

正規化メタデータ

毎回のレスポンスは video_url に video_id、title、duration_seconds、format、quality、size_mb、video_content_type を組み合わせます。リクエストごとのパースなしで保存できる安定フィールドです。

冪等な課金書き込み

動画保存は従量課金です。再試行時に Idempotency-Key ヘッダーを送ると、中断されたレスポンスが同じ Short の二重課金になりません。同一キーの同一リクエストは元の結果を返します。

予測可能なエラーコード

ドキュメント化されたステータスコード：400 は無効なリクエスト、401 はキーの不足または誤り、409 は冪等性の競合、502/503/504 は一時的な上流の問題。各クラスは明確な修正または再試行アクションに対応します。

使い方

次のステップで YouTube Shorts ダウンロード API を呼び出します。キーを作成し、POST リクエストを構築し、返された MP4 リンクを処理します。

01

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成します。キーはサーバー側に保管し bearer トークンとして送信します。

02

リクエストを構築

必須の Shorts url と任意の quality を付けて /v1/youtube/video/download に POST を送信します。生成例は 5 つの言語での正確なリクエストを示します。

03

冪等キーを追加

再試行する可能性のあるすべてのダウンロードに Idempotency-Key ヘッダーを付けます。同一キーの同一リクエストは元のレスポンスを返し、再課金しません。

04

キーはサーバー側に

バックエンド、サーバーレス関数、定期ジョブからエンドポイントを呼びます。エンドユーザーがダウンロードをトリガーする場合は独自エンドポイントでプロキシしてください。

05

JSON レスポンスをパース

返された video_url、video_id、title、duration_seconds、format、quality、size_mb を読み取ります。リンクとメタデータを一緒に保存します。フィールドはリクエスト間で安定です。

06

エラーを正しく処理

400 はリクエストを修正し、401 は有効なキーを設定し、409 はドキュメント化された冪等キーの動作に従います。502/503/504 は同じキーの下でバックオフ付きで再試行します。

よくある質問

YouTube Shorts ダウンロード API とは何ですか？

認証付き POST エンドポイント /v1/youtube/video/download です。公開の YouTube Short 1 本を MP4 として保存し、正規化メタデータ——video_id、タイトル、再生時間、フォーマット、画質、サイズ——付きの直接動画リンクを構造化 JSON で返します。

API はどの Shorts URL 形式を受け付けますか？

youtube.com/shorts/VIDEO_ID リンク、youtu.be 短縮リンク、アプリ共有リンク、Short を指す標準 watch URL——すべて同じリクエスト構造で解決します。

最高画質は？

720p です。quality フィールドは 144p、240p、360p、480p、720p を受け付けます。このエンドポイントに 1080p や 4K のティアはありません。レスポンスは実際に配送された画質を報告します。

料金はどうなっていますか？

各動画保存はアカウントのクレジットで実行される従量課金の操作です。価格はゲートウェイが管理し、このページの固定数値ではありません。コンソールで確認し、冪等キーで再試行の二重課金を防いでください。

非公開または削除済みの Shorts をダウンロードできますか？

いいえ。エンドポイントは公開 Shorts のみを読み取ります。非公開、メンバー限定、削除済みのコンテンツは解決せず、制限を回避するための YouTube 認証情報も要求されません。

API エラーの処理方法は？

400 はリクエストを修正し、401 は bearer キーを修正し、409 はドキュメント化された冪等キーの動作に従います。502、503、504 は一時的な上流の障害として、同じキーの下でバックオフ付きで再試行してください。