# FlashData YouTube Download API

Muaturun video atau audio YouTube ke penyimpanan awan anda. BAHASA Pilih resolusi, format dan durasi klip, kemudian lacak pekerjaan asinkron melalui penyelesaian.

Referensi boonical: https://flashdata.dev/ms/docs/sources/youtube_download
Diulas: 2026-10-23

Titik akhir Ukur: POST https://data.flashdata.dev/v1/queries
Pengesahan: X-API-Key: YOUR_API_KEY
Mode: [Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md)

Izin sumber yang dibutuhkan: youtube_download

Megantikan YOUR_API_KEY dengan kunci API yang memiliki izin sumber ini dan kredit yang tersedia. Permintaan run run pada server atau agen host anda.

[Otentikasi Gagal](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md)

[unduh satu video dan sahkan pengiriman](https://flashdata.dev/ms/docs/guides/download-video-recipe/reference.md)

[API muat turun video YouTube — contoh Python](https://github.com/flashdatadev/youtube-video-download-api)

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

## Upn permintaan

### 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>

## Parameter

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

### Badan permintaan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Ditetapkan untuk youtube_download.  |
| <a id="parameter-video_id"></a> video_id | string | Ya | Tidak Diset | Karakter 11-karakter YouTube video ID, seperti FUfGcZ092b0. 280 Terima huruf, angka, underscore dan tanda hubung. Panjang Min: 11. Panjang maksimum: 11. Corak: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Ya | — | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tak ada | Tidak Diset | Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.  |

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

### Video & audio

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-download_type"></a> params.download_type | string | Tak ada | "audio_video" | audio_video gabungkan video dan audio; video pilih video saja; audio pilih audio saja. Dibenarkan: "audio_video", "video", "audio". Panjang Min: 1. Panjang maksimum: 11. |
| <a id="parameter-params-video_quality"></a> params.video_quality | string | Tak ada | "<=720" | Pemilihan resolusi video. \"Omit\" untuk unduhan audio-saja. Memungkinkan: "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". Panjang Min: 1. Panjang maksimum: 40. |
| <a id="parameter-params-fps"></a> params.fps | string | Tak ada | Tidak Diset | Kekangan Frame-rate: >=, <= atau == diikuti dengan nilai dari 1 ke 240. \"Omit\" untuk unduhan audio-saja. Panjang Min: 1. Panjang maksimum: 6. Corak: ^(?:>=\|<=\|==)(?:[1-9]\d?\|1\d\d\|2[0-3]\d\|240)$ |
| <a id="parameter-params-audio_language"></a> params.audio_language | string | Tak ada | "default" | Pemilihan trek audio. Applise untuk audio_video dan audio. "default", "original". Panjang Min: 1. Panjang maksimum: 8. |
| <a id="parameter-params-audio_quality"></a> params.audio_quality | string | Tak ada | "best" | Audio berbasis-saja bitrate dalam kbps, atau terbaik. Pilihan angka angka harus dikirim sebagai string. Omit untuk unduhan video. Dibenarkan: "best", "320", "256", "192", "128". Panjang Min: 1. Panjang maksimum: 10. |
| <a id="parameter-params-output_format"></a> params.output_format | string | Tak ada | mp4 (video) / m4a (audio) | Video: mp4, webm atau mkv. Audio: m4a, mp3 atau opus. Dibenarkan: "mp4", "webm", "mkv", "m4a", "mp3", "opus". Panjang Min: 1. Panjang maksimum: 10. |
| <a id="parameter-params-yt_dlp_format"></a> params.yt_dlp_format | string | Tak ada | Tidak Diset | Pemilih format lanjutan dari 1 ke 1,024 karakter setelah pemangkasan spasi. Karakter kontrol jardin ditolak. Diskronds video_quality, fps dan audio_language, yang nilai-nilainya kemudian diabaikan; format output dan kliping masih berlaku. Panjang Min: 1. Panjang maksimum: 1024. |
| <a id="parameter-params-upload_metadata"></a> params.upload_metadata | boolean | Tak ada | false | upload data metadata berkas JSON di samping berkas media dalam penyimpanan Anda.  |

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

### Klipping Kliping Kliping

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-start_at"></a> params.start_at | string | Tak ada | Tidak Diset | Masa mula klip dalam format H:MM:SS atau HH:MM:SS, dari 00:00:00 hingga 12:00:00. Nilai lalai ialah 00:00:00 apabila hanya end_at diberikan. Panjang Min: 1. Panjang maksimum: 8. Corak: ^\d{1,2}:[0-5]\d:[0-5]\d$ |
| <a id="parameter-params-end_at"></a> params.end_at | string | Tak ada | Tidak Diset | Klip klip Klip berakhir dalam format H:MM:SS atau HH:MM:SS, hingga 12:00:00. Pasti lebih lambat dari start_at. Panjang Min: 1. Panjang maksimum: 8. Corak: ^\d{1,2}:[0-5]\d:[0-5]\d$ |

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

### Destinasi Penyimpanan WARGA

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-storage"></a> params.storage | object | Ya | — | Destinasi untuk berkas media yang telah selesai. Hanya ladang penyimpanan terdaftar yang diterima.  |
| <a id="parameter-params-storage-storage_type"></a> params.storage.storage_type | string | Ya | — | Penyedia penyimpanan barang: s3, s3_compatible, oss, gcs, azure, cos, bos atau tos.  |
| <a id="parameter-params-storage-storage_url"></a> params.storage.storage_url | string | Ya | — | Nama ember atau wadah yang tidak kosong, hingga karakter 1,024. Ruang angkasa yang mengelilinginya telah dihapus. Untuk s3, gunakan nama baldi AWS yang valid tanpa URL atau jalur folder; folder termasuk dalam object_prefix.  |
| <a id="parameter-params-storage-object_prefix"></a> params.storage.object_prefix | string | Tak ada | "YYYYMMDD" | Awalan Object-key, 1 ke karakter 512. Setiap segmen dipisahkan garis miring menerima huruf ASCII, digit, titik, underscore dan tanda hubung; segmen kosong, . dan .. ditolak. Tidak ada garis miring terkemuka. Ruang putih yang mengelilingi dan satu jejak miring dihilangkan. YYYYYMMDD menggunakan tanggal unggah UTC, termasuk dalam archive/YYYYMMDD.  |
| <a id="parameter-params-storage-access_key"></a> params.storage.access_key | string | Tak ada | — | Kunci akses untuk S3, S3-compatible, OSS, COS, BOS atau TOS; dipasangkan dengan secret_key.  |
| <a id="parameter-params-storage-secret_key"></a> params.storage.secret_key | string | Tak ada | — | Kunci rahasia untuk S3, S3-compatible, OSS, COS, BOS atau TOS.  |
| <a id="parameter-params-storage-endpoint_url"></a> params.storage.endpoint_url | string | Tak ada | — | Titik akhir HTTPS Publik untuk penyimpanan kompatibel S3 atau OSS. COS, BOS dan TOS menghasilkannya dari daerah.  |
| <a id="parameter-params-storage-region"></a> params.storage.region | string | Tak ada | — | Aquired untuk COS, BOS dan TOS; juga memasok untuk S3 dan S3-compatible downloads. Nama - nama ember baldi baldi dari COS termasuk APPID.  |
| <a id="parameter-params-storage-service_account"></a> params.storage.service_account | object | Tak ada | — | Akun layanan GCS: project_id, client_email dan PEM private_key.  |
| <a id="parameter-params-storage-account_name"></a> params.storage.account_name | string | Tak ada | — | Nama akun penyimpanan Azure. Use the container nama dalam storage_url.  |
| <a id="parameter-params-storage-sas_token"></a> params.storage.sas_token | string | Tak ada | — | Azure yang dapat ditulis dengan kata sandi dan tanda tangan.  |

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

## Baca hasilnya

Setelah pekerjaan selesai, simpan JSON dari link hasil sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ia membaca rincian berkas tanpa mengunduh media atau membuat permintaan lain.

### 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))
```

## Pengiriman sampel command

Contoh terrekam; bidang dan hitungan bergantung pada sumber dan masukan yang diminta.
```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"
    }
  ]
}
```

## Medan tanggapan palsu

| Ukrainian | Jenis | Keterangan |
| --- | --- | --- |
| id | string | download pekerjaan ID. |
| source | string | youtube_download. |
| status | string | Bertangguh ketika pekerjaan diterima. |
| created_at | string | Waktu penciptaan Job freak tooling dalam format ISO 8601. |
| usage.credits | number | 0 pada pengiriman. Unduhan-unduhan telah dibebankan oleh volume data yang disampaikan setelah selesai. |
| links | array | ** Ikuti self link untuk status pekerjaan dan link hasil untuk keluaran selesai. |
| links[].rel | string | Kegandirian atau hasil. |
| links[].href | string | URL pertanyaan untuk ditanya dengan pertanyaan yang sama API Kuncinya. |
| links[].method | string | GET. |

- Muaturun dijalankan sebagai pekerjaan latar belakang. Tanggapan subsider hab berisi pekerjaan ID; tidak berisi berkas media. Ikuti status pekerjaan sampai selesai, lalu ambil hasil yang menggambarkan file yang dikirimkan ke penyimpananmu. Transmited download ke /v1/queries atau /v1/queries/batch; /v1/queries/realtime tidak menerima permintaan unduhan.

## Format respons

Sambutan menggunakan JSON secara default. Memikul format lain dengan header opsional ini.

- Accept: application/json (default) OR atau ORANG text/plain. Teks Plain menyajikan bidang yang sama dalam tata letak yang dapat dibaca dan diindentasi.
- X-Respond-With: markdown. Jangan sampai tidak sesuai dengan bidang asli. Markdown bekerja dengan baik format respon.

Markdown format manifes download; file media tetap mempertahankan format asli mereka. Penerimaan dan status kerja mendukung Accept saja.

Bidang-bidang di bawah ini menggambarkan respon JSON baku.

[Contoh format permintaan dan tanggapan](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#completed-results)

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

## Destinasi Penyimpanan WARGA

Pengunduhan job tunggal dan Batch membutuhkan params.storage; Bulk Penggunaan unduhan niaga options.storage. storage_url baldi atau nama wadah. Kelayakan pasokan dengan akses menulis dan menyimpannya di server Anda.

### s3

Bekalan access_key dan secret_key dengan akses tulis. Wadison Set wilayah ke wilayah AWS ember Anda.

```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

Bekalan access_key, secret_key dan HTTPS umum endpoint_url. Kelayakan Set wilayah sebagaimana diperlukan oleh penyedia Anda; Cloudflare R2 menggunakan auto.

```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

Bekalan account_name dan sas_token, sebuah wadah SAS dengan izin penulisan (sp termasuk w), sumber daya sr=c, expiry se, versi sv dan tanda tangan sig. storage_url adalah nama wadah. Jangan kirim endpoint_url, access_key atau 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

Bekalan access_key, secret_key dan wilayah: bj, su atau hkg. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.

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

### cos

Bekalan access_key, secret_key dan wilayah ap-*, seperti ap-hongkong. storage_url harus termasuk akhiran APPID. Jangan sesekali mengirim endpoint_url; ini berasal dari wilayah.

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

### gcs

Bekalan service_account dengan project_id, client_email (sebuah alamat .gserviceaccount.com), dan PEM private_key dari akun layanan Anda. Akun itu pasti punya akses untuk menulis ke ember. Jangan kirim access_key, secret_key, wilayah atau 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

Bekalan access_key, secret_key dan wilayah ember umum 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

Bekalan access_key, secret_key dan wilayah dengan awalan cn-, ap-, eu- atau us-. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.

```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>

## Asas API

Waaswan permintaan pembangun dan contoh di atas menggunakan parameter sumber ini. Andaikata menggunakan contoh Python dan cURL di bawah ini untuk penyerahan bersama, status dan langkah hasil. Tubuh Batch adalah sebuah objek JSON yang berisi kueri; setiap item mengembalikan pekerjaannya sendiri ID.

- [Permintaan dan penerimaan Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)

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

- [Periksa status pekerjaan](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#status)

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

- [Hasil yang telah selesai](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Permintaan Batch JSON](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)
- [API pemprosesan Bulk](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md)
- [Bina aliran kerja Bulk untuk sumber ini](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md?source=youtube_download#playground)
- [BukaAPI Pelanggan oleh:](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian hasil Pengundian

- [Terima dan sahkan pelengkapan webhooks](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#webhooks)

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

## Penerjemahan Masalah

- [Ralat dan kod status](https://flashdata.dev/ms/docs/errors/reference.md#status-codes)
- [Bila hendak mencoba lagi](https://flashdata.dev/ms/docs/errors/reference.md#retries)

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

## Penyerahan Fail

Download tidak mendukung realtime.

Media telah diunggah ke penyimpanan terkonfigur Anda; hasil JSON menggambarkan berkas-berkas tersebut. Media swasta menggunakan autentikasi penyimpanan Anda. Hasil JSON hasil akhir 24 jam setelah selesai; media mengikuti kebijakan retensi penyimpanan anda.

## API yang berkaitan dengan anak - anak

- [YouTube Data Meta Video API](https://flashdata.dev/ms/docs/sources/youtube_metadata/reference.md)
- [YouTube Transcript API](https://flashdata.dev/ms/docs/sources/youtube_transcript/reference.md)
