# FlashData YouTube Download API

YouTubeビデオまたはオーディオをクラウドストレージにダウンロードします。 解像度、フォーマット、クリップの所要時間を選択し、完了して非同期ジョブを追跡します。

キャニシニカル参照: https://flashdata.dev/ja/docs/sources/youtube_download
レビュー: 2026-10-23

エンドポイント: POST https://data.flashdata.dev/v1/queries
認証: X-API-Key: YOUR_API_KEY
モード: [Async](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ja/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/ja/docs/reference/bulk-processing/reference.md)

必要なソース権限: youtube_download

YOUR_API_KEYをAPIキーに置き換え、このソースの許可と利用可能なクレジットを持っています。 サーバやエージェントホストのリクエストを実行します。

[認証の設定](https://flashdata.dev/ja/docs/guides/headers-and-authentication/reference.md)

[1つのビデオをダウンロードし、配達を検証](https://flashdata.dev/ja/docs/guides/download-video-recipe/reference.md)

[YouTube 動画ダウンロード API — Python サンプル](https://github.com/flashdatadev/youtube-video-download-api)

<a id="quickstart"></a>

## リクエストを送信

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_download",
    "video_id": "jNQXAC9IVRw",
    "params": {
        "download_type": "audio_video",
        "video_quality": "<=720",
        "output_format": "mp4",
        "storage": {
            "storage_type": "s3",
            "storage_url": "your-media-bucket",
            "access_key": "YOUR_ACCESS_KEY",
            "secret_key": "YOUR_SECRET_KEY",
            "region": "us-east-1",
        },
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY",
      "region": "us-east-1"
    }
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## パラメーター

<a id="parameters-group-0"></a>

### リクエストボディ

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | はい はい | — | youtube_downloadに設定します。  |
| <a id="parameter-video_id"></a> video_id | string | はい はい | 設定なし | 11-character YouTubeビデオID、FUfGcZ092b0などの。 手紙、数字、アンダースコア、ハイフンを受け入れる。 最少の長さ: 11。 最高長さ: 11。 パターン:^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | はい はい | — | この要求のためのSettings。  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | ノーザン | 設定なし | Asyncとバッチだけ。 パブリック HTTPS エントリーフォーム URL 港に 443まで、 2,048 文字。 ユーザーの資格情報や URL フラグメントはありません。 Omit は、通知なしの null または空の文字列を使用します。 バッチでは、各クエリで、外部のパラメータで設定します。  |

<a id="parameters-group-1"></a>

### ビデオ&オーディオ

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-download_type"></a> params.download_type | string | ノーザン | "audio_video" | audio_videoはビデオとオーディオをマージします。ビデオはビデオのみを選択します。オーディオは音声のみを選択します。 許可される: "audio_video"、"video"、"audio"。 最少の長さ: 1。 最高長さ: 11。 |
| <a id="parameter-params-video_quality"></a> params.video_quality | string | ノーザン | "<=720" | ビデオ解像度の選択。 音声のみダウンロード用Omit 許可される: "best", "worst", "<=144", "==144", ">=144", "<=360", "==360", ">=360", "<=480", "==480", ">=480", "<=720", "==720", ">=720", "<=1080", "==1080", ">=1080", "<=1440", "==1440", ">=1440", "<=2160", "==2160", ">=2160", "<=4320", "==4320", ">=4320". 最少の長さ: 1。 最高長さ: 40。 |
| <a id="parameter-params-fps"></a> params.fps | string | ノーザン | 設定なし | フレームレート制約: >=、<=、=== は、1 から 240 に値が続く。 音声のみダウンロード用Omit 最少の長さ: 1。 最高長さ: 6。 パターン: ^(?:>=\|<=\|==)(?:[1-9]\d?\|1\d\d\|2[0-3]\d\|240)$ |
| <a id="parameter-params-audio_language"></a> params.audio_language | string | ノーザン | "default" | 可聴周波トラックの選択。 audio_video とオーディオに適用されます。 許可される: "default"、"original"。 最少の長さ: 1。 最高長さ: 8。 |
| <a id="parameter-params-audio_quality"></a> params.audio_quality | string | ノーザン | "best" | kbps の可聴周波だけビットレート、またはベスト。 数値選択は文字列として送信する必要があります。 ビデオのダウンロードのためのOmit. 許可される: "best"、"320"、"256"、"192"、"128"。 最少の長さ: 1。 最高長さ: 10。 |
| <a id="parameter-params-output_format"></a> params.output_format | string | ノーザン | mp4 (video) / m4a (audio) | ビデオ:mp4、webmまたはmkv。 可聴周波:m4a、mp3またはオプス。 許可される: "mp4"、"webm"、"mkv"、"m4a"、"mp3"、"opus"。 最少の長さ: 1。 最高長さ: 10。 |
| <a id="parameter-params-yt_dlp_format"></a> params.yt_dlp_format | string | ノーザン | 設定なし | 1 から 1,024 文字までの高度なフォーマットセレクター。 制御文字は拒否されます。 値を無視するvideo_quality、fps、audio_languageをオーバーライドします。 出力形式とクリップはまだ適用されます。 最少の長さ: 1。 最高長さ: 1024。 |
| <a id="parameter-params-upload_metadata"></a> params.upload_metadata | boolean | ノーザン | false | ストレージのメディアファイルと一緒にメタデータJSONファイルをアップロードします。  |

<a id="parameters-group-2"></a>

### クリップ

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-start_at"></a> params.start_at | string | ノーザン | 設定なし | クリップはH:MM:SSかH:MM:SSのフォーマット、00:00:00からの12:00:00に始まります。 end_atのみが供給されると、00:00:00にデフォルト値を設定します。 最少の長さ: 1。 最高長さ: 8。 パターン:^\d{1,2}:[0-5]\d:[0-5]\d$ |
| <a id="parameter-params-end_at"></a> params.end_at | string | ノーザン | 設定なし | H:MM:SS または HH:MM:SS 形式のクリップエンド、12:00:00 まで。 start_atよりも後続する必要があります。 最少の長さ: 1。 最高長さ: 8。 パターン:^\d{1,2}:[0-5]\d:[0-5]\d$ |

<a id="parameters-group-3"></a>

### 保管先

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-storage"></a> params.storage | object | はい はい | — | 完成したメディアファイルの宛先。 リストされた記憶分野だけを受け入れます。  |
| <a id="parameter-params-storage-storage_type"></a> params.storage.storage_type | string | はい はい | — | ストレージプロバイダ: s3, s3_compatible, oss, gcs, azure, cos, bos または tos.  |
| <a id="parameter-params-storage-storage_url"></a> params.storage.storage_url | string | はい はい | — | 1,024文字までの非空バケットまたはコンテナ名。 空白を外します。 s3 では、URL やフォルダーパスなしで有効な AWS の Bucket 名を使用します。フォルダーは object_prefix にあります。  |
| <a id="parameter-params-storage-object_prefix"></a> params.storage.object_prefix | string | ノーザン | "YYYYMMDD" | Object-key 接頭辞、1 から 512 文字。 それぞれのスラッシュ区切りセグメントは、ASCII文字、数字、ドット、アンダースコア、ハイフン、空のセグメント、および . が拒否されます。 急激なスラッシュはありません。 空白とスラッシュの1つを囲む。 YYYMMDDは、archive/YYYYMMDD.に含まれるUTCのアップロード日を使用します。  |
| <a id="parameter-params-storage-access_key"></a> params.storage.access_key | string | ノーザン | — | S3、S3互換、OSS、COS、BOS、TOS、secret_keyと組み合わせたアクセスキー。  |
| <a id="parameter-params-storage-secret_key"></a> params.storage.secret_key | string | ノーザン | — | S3、S3互換、OSS、COS、BOS、TOSの秘密鍵。  |
| <a id="parameter-params-storage-endpoint_url"></a> params.storage.endpoint_url | string | ノーザン | — | S3互換ストレージまたはOSS用のパブリックHTTPSエンドポイント。 COS、BOS、TOSは地域から導き出します。  |
| <a id="parameter-params-storage-region"></a> params.storage.region | string | ノーザン | — | COS、BOS、TOS、S3、S3互換ダウンロードも対応可能です。 COS バケット名には、APPID が含まれます。  |
| <a id="parameter-params-storage-service_account"></a> params.storage.service_account | object | ノーザン | — | GCSサービスアカウント:project_id、client_email、PEM private_key。  |
| <a id="parameter-params-storage-account_name"></a> params.storage.account_name | string | ノーザン | — | Azureストレージアカウント名。 storage_urlのコンテナ名を使用します。  |
| <a id="parameter-params-storage-sas_token"></a> params.storage.sas_token | string | ノーザン | — | 書き込み可能 Azure コンテナ SAS と expiry とシグネチャ。  |

<a id="response"></a>

## 結果を読む

ジョブが完了したら、response.json として結果リンクから JSON を保存します。 これをread-response.pyとして保存し、python read-response.pyを実行します。 メディアをダウンロードしたり、別のリクエストをしたりすることなく、ファイルの詳細を読みます。

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {name: result.get(name) for name in (
    "file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## サンプル投稿

記録された例; フィールドとカウントは、ソースと要求された入力に依存します。
```json
{
  "id": "job_d265c693-950e-40bf-a13e-a432044d99ba",
  "source": "youtube_download",
  "status": "pending",
  "usage": {
    "credits": 0
  },
  "created_at": "2026-09-16T07:51:13.139Z",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba/results",
      "method": "GET"
    }
  ]
}
```

## 応答分野

| フィールド | 種類 | 説明: |
| --- | --- | --- |
| id | string | ID をダウンロードします。 |
| source | string | youtube_download.の特長 |
| status | string | 求人受付時に終了します。 |
| created_at | string | ISO 8601 形式のジョブ作成時間。 |
| usage.credits | number | 0 を投稿します。 ダウンロードは、完了後、データ量を配信していただきます。 |
| links | array | ジョブの状態と完了した出力の結果リンクのセルフリンクに従ってください。 |
| links[].rel | string | 自己または結果。 |
| links[].href | string | URL は同じ API キーと照会するためです。 |
| links[].method | string | GET.の特長 |

- ダウンロードはバックグラウンドジョブとして実行されます。 送信応答には、ジョブIDが含まれています。メディアファイルには含まれません。 ジョブのステータスを補完するまでフォローし、保存先のファイルを記述する結果を取得します。 /v1/queries または /v1/queries/batch にダウンロードを送信してください。 /v1/queries/realtime はダウンロードリクエストを受け入れません。

## レスポンス形式

応答はデフォルトでJSONを使用します。 これらのオプションヘッダーで別の形式を選択します。

- Accept: application/json (デフォルト) または text/plain. プレーンテキストは、読みやすいレイアウトで同じフィールドを提示します。
- X-Respond-With: markdown. 元のフィールドにアンセットを残します。 Markdownは、応答形式のいずれかで動作します。

Markdownは、ダウンロードマニフェストをフォーマットします。メディアファイルは元の形式を保持します。 Accept のみサポートとジョブステータスのサポート

下のフィールドは、デフォルトのJSON応答を記述します。

[リクエストとレスポンスの形式例](https://flashdata.dev/ja/docs/guides/response-formats/reference.md#completed-results)

<a id="storage"></a>

## 保管先

シングルジョブとBatchのダウンロードには、params.storageが必要です。 Bulkはoptions.storageをダウンロードします。 storage_urlは、バケットまたはコンテナ名です。 書き込みアクセスで認証情報を提供し、サーバーに保管します。

### s3

access_keyとsecret_keyを書き込みアクセスで供給します。 Bucket の AWS 領域に地域を設定します。

```json
{
  "storage_type": "s3",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1"
}
```

### s3_compatibleの特長

access_key、secret_key、および公開HTTPS endpoint_urlを供給して下さい。 プロバイダーが要求する地域を設定します。 Cloudflare R2は自動を使用します。

```json
{
  "storage_type": "s3_compatible",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com",
  "region": "auto"
}
```

### azure

account_name と sas_token を、コンテナ SAS に書き込み権限 (sp には w が含まれています)、リソース sr=c、 expiry se、バージョン sv とシグネチャ sig を供給します。 storage_url はコンテナ名です。 endpoint_url、access_key、secret_keyを送らないで下さい。

```json
{
  "storage_type": "azure",
  "storage_url": "your-media-container",
  "account_name": "yourstorageaccount",
  "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE"
}
```

### bos

access_key、secret_keyおよび地域:bj、suまたはhkg。 省略時は、地域からエンドポイントが誘導されます。 ドットなしの Bucket 名を使用してください。

```json
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
```

### cos

access_key、secret_keyおよびap-*領域を、ap-hongkongのような供給して下さい。storage_urlはAPPIDのサフィックスを含まなければなりません。 endpoint_urlを送らないでください。それは地域から派生しています。

```json
{
  "storage_type": "cos",
  "storage_url": "your-media-bucket-1234567890",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "ap-hongkong"
}
```

### gcs

ソリューション service_account とりあえず project_id, client_email (a ) .gserviceaccount.com アドレス)、およびPEM private_key サービスアカウントから。 このアカウントは、 Bucket へのアクセスを記述する必要があります。 access_key、secret_key、地域またはendpoint_urlを送信しないでください。

```json
{
  "storage_type": "gcs",
  "storage_url": "your-media-bucket",
  "service_account": {
    "project_id": "your-project-id",
    "client_email": "uploader@your-project-id.iam.gserviceaccount.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n"
  }
}
```

### oss

access_key、secret_key、バケット領域の公開HTTPS endpoint_urlを供給します。

```json
{
  "storage_type": "oss",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com"
}
```

### tos

access_key、secret_keyおよび地域をcn、ap-、eu-またはus-接頭辞と供給して下さい。 省略時は、地域からエンドポイントが誘導されます。 ドットなしの Bucket 名を使用してください。

```json
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}
```

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API の基本

上記のビルダーと例は、このソースのパラメーターを使用します。 Python と cURL の例を以下に使用して、共有の投稿、ステータス、結果の手順を実行します。 Batch ボディは、クエリを含む JSON オブジェクトです。各項目は独自のジョブ ID を返します。

- [Asyncリクエストとレシート](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [ジョブステータスの確認](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [完了した結果を取得する](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON リクエスト](https://flashdata.dev/ja/docs/reference/batch-and-bulk/reference.md#batch)
- [Bulk 処理 API](https://flashdata.dev/ja/docs/reference/bulk-processing/reference.md)
- [Bulkのワークフローをこのソースにビルドする](https://flashdata.dev/ja/docs/reference/bulk-processing/reference.md?source=youtube_download#playground)
- [顧客OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## 完了通知

- [完了のWebhooksを受信し、確認する](https://flashdata.dev/ja/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## トラブルシューティング

- [エラーとステータスコード](https://flashdata.dev/ja/docs/errors/reference.md#status-codes)
- [再試行するとき](https://flashdata.dev/ja/docs/errors/reference.md#retries)

<a id="delivery"></a>

## ファイルデリバリー

ダウンロードはリアルタイムに対応していません。

設定したストレージにメディアがアップロードされます。その結果、JSONはそれらのファイルを記述します。 プライベートメディアは、ストレージ認証を使用します。 JSON 結果は、完了後 24 時間を期限切れます。メディアは、保存ポリシーに従います。

## 関連API

- [YouTubeビデオメタデータAPI](https://flashdata.dev/ja/docs/sources/youtube_metadata/reference.md)
- [YouTube Transcript API](https://flashdata.dev/ja/docs/sources/youtube_transcript/reference.md)
