# FlashData YouTube Captions API

Ambil judul YouTube sebagai teks yang distempel waktu dan transkrip penuh. Pemutakhiran - terjemahan yang disediakan dipilih secara baku.

Referensi kanonikal: https://flashdata.dev/id/docs/sources/youtube_captions
Diulas: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Autentikasi: X-API-Key: YOUR_API_KEY
Mode: [Realtime](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md)

Izin sumber yang diperlukan: youtube_captions

Ganti kunci YOUR_API_KEY dengan kunci API yang memiliki hak sumber ini dan kredit yang tersedia. Jalankan permintaan pada server atau agen host.

[Atur otentikasi](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)

[Ambil taktimestamp takarir](https://flashdata.dev/id/docs/guides/timestamped-captions-recipe/reference.md)

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

## Kirim permintaan

### Python

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

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_captions",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": False,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    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/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_captions",
  "video_id": "dQw4w9WgXcQ",
  "params": {
    "language": "en",
    "auto": false
  }
}
FLASHDATA_JSON
```

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

## Parameter

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

### Isi permintaan

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Set ke youtube_captions.  |
| <a id="parameter-video_id"></a> video_id | string | Ya | Tak ditata | Karakter 11-YouTube video ID, seperti FUFFGCZ092b0. Menerima surat, nomor, garis bawah dan tanda hubung. Panjang Min: 11. Panjang Max: 11. Pola: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Tidak | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tidak | Tak ditata | Async dan batch saja. Publik HTTPS pelengkapan URL di port 443, sampai 2,048 karakter. Tak ada kredensial pengguna atau fragmen URL. Omit, gunakan null atau string kosong untuk tanpa pemberitahuan. Dalam batch, set ini pada setiap query, di luar param.  |

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

### Pemilihan judul

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string \| array | Tidak | en-orig → en | Abaikan untuk Inggris (en-orig, kemudian en). Dengan auto = true, tiap kode mencoba trek -orig yang pertama, maka kode yang diminta. Eksplisit -orig kode dan auto = false tetap tepat. Permintaan array 1–10 bahasa yang berbeda. Abaikan untuk lebih memilih en-orig dan kembali ke en, kembali satu trek. Dengan auto = true, setiap kode mencoba trek -orig yang pertama, maka kode yang diminta; eksplisit -orig kode dan auto = false tetap tepat. Larik kode 1–10 berbeda mencoba setiap bahasa yang diminta dan kembali trek dan bahasa kesalahan permanen dalam urutan permintaan. languageCode mengidentifikasi trek yang dipilih; requestedLanguageCode disertakan ketika berbeda dari kode yang diminta. |
| <a id="parameter-params-auto"></a> params.auto | boolean | Tidak | false | true memilih YouTube-terjemahan yang dihasilkan; false memilih uphavder-disediakan captions. Ini memilih asal dari judul, bukan bahasa deteksi atau transkripsi baru.  |

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

## Baca hasilnya

Simpan respon JSON sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan Python perpustakaan standar dan tidak membuat permintaan baru.

### 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 = {
    "tracks": result.get("tracks", [result]),
    "errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Contoh respons

Contoh direkam; ruas dan jumlah bergantung pada sumber dan masukan yang diminta.
```json
{
  "source": "youtube_captions",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "languageName": null,
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 1.36,
          "end": 3.04,
          "text": "[♪♪♪]"
        },
        {
          "start": 18.64,
          "end": 21.880000000000003,
          "text": "♪ We're no strangers to love ♪"
        },
        {
          "start": 22.64,
          "end": 26.96,
          "text": "♪ You know the rules\nand so do I ♪"
        },
        {
          "start": 27.04,
          "end": 31.04,
          "text": "♪ A full commitment's\nwhat I'm thinking of ♪"
        },
        {
          "start": 31.12,
          "end": 35.08,
          "text": "♪ You wouldn't get this\nfrom any other guy ♪"
        },
        {
          "start": 35.16,
          "end": 39.52,
          "text": "♪ I just wanna tell you\nhow I'm feeling ♪"
        },
        {
          "start": 40.52,
          "end": 42.92,
          "text": "♪ Gotta make you understand ♪"
        },
        {
          "start": 43,
          "end": 45.12,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 45.2,
          "end": 47.080000000000005,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 47.32,
          "end": 51.12,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 51.48,
          "end": 53.48,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 53.6,
          "end": 55.52,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 55.72,
          "end": 59.36,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        },
        {
          "start": 60.8,
          "end": 64.8,
          "text": "♪ We've known each other\nfor so long ♪"
        },
        {
          "start": 64.88,
          "end": 69.03999999999999,
          "text": "♪ Your heart's been aching\nbut you're too shy to say it ♪"
        },
        {
          "start": 69.12,
          "end": 72.96000000000001,
          "text": "♪ Inside we both know\nwhat's been going ♪"
        },
        {
          "start": 73.36,
          "end": 77.2,
          "text": "♪ We know the game\nand we're gonna play it ♪"
        },
        {
          "start": 77.4,
          "end": 82.04,
          "text": "♪ And if you ask me\nhow I'm feeling ♪"
        },
        {
          "start": 82.4,
          "end": 85.24000000000001,
          "text": "♪ Don't tell me\nyou're too blind to see ♪"
        },
        {
          "start": 85.32,
          "end": 87.27999999999999,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 87.36,
          "end": 89.32,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 89.44,
          "end": 93.72,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 93.8,
          "end": 95.6,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 95.76,
          "end": 98,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 98.08,
          "end": 102.04,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        },
        {
          "start": 102.2,
          "end": 104.12,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 104.28,
          "end": 106.36,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 106.48,
          "end": 110.08,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 110.76,
          "end": 112.72,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 112.8,
          "end": 114.68,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 114.96,
          "end": 118.76,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        },
        {
          "start": 119.84,
          "end": 122.96,
          "text": "♪ (Ooh, give you up) ♪"
        },
        {
          "start": 123.72,
          "end": 127.36,
          "text": "♪ (Ooh, give you up) ♪"
        },
        {
          "start": 128.48,
          "end": 130.11999999999998,
          "text": "♪ Never gonna give,\nnever gonna give ♪"
        },
        {
          "start": 130.24,
          "end": 131.56,
          "text": "♪ (Give you up) ♪"
        },
        {
          "start": 132.48,
          "end": 134.23999999999998,
          "text": "♪ Never gonna give,\nnever gonna give ♪"
        },
        {
          "start": 134.36,
          "end": 135.92000000000002,
          "text": "♪ (Give you up) ♪"
        },
        {
          "start": 136.76,
          "end": 141.07999999999998,
          "text": "♪ We've known each other\nfor so long ♪"
        },
        {
          "start": 141.2,
          "end": 145.2,
          "text": "♪ Your heart's been aching\nbut you're too shy to say it ♪"
        },
        {
          "start": 145.28,
          "end": 149.12,
          "text": "♪ Inside we both know\nwhat's been going ♪"
        },
        {
          "start": 149.52,
          "end": 153.20000000000002,
          "text": "♪ We know the game\nand we're gonna play it ♪"
        },
        {
          "start": 153.36,
          "end": 158.04000000000002,
          "text": "♪ I just wanna tell you\nhow I'm feeling ♪"
        },
        {
          "start": 158.64,
          "end": 161.32,
          "text": "♪ Gotta make you understand ♪"
        },
        {
          "start": 161.4,
          "end": 163.36,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 163.44,
          "end": 165.64,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 165.72,
          "end": 169.72,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 169.8,
          "end": 171.64,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 171.8,
          "end": 173.96,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 174.04,
          "end": 177.6,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        },
        {
          "start": 178.2,
          "end": 180.24,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 180.32,
          "end": 182.44,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 182.52,
          "end": 186.64,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 186.72,
          "end": 188.72,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 188.84,
          "end": 190.72,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 190.84,
          "end": 195.2,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        },
        {
          "start": 195.28,
          "end": 197.12,
          "text": "♪ Never gonna give you up ♪"
        },
        {
          "start": 197.2,
          "end": 199.24,
          "text": "♪ Never gonna let you down ♪"
        },
        {
          "start": 199.4,
          "end": 203.12,
          "text": "♪ Never gonna run around\nand desert you ♪"
        },
        {
          "start": 203.36,
          "end": 205.6,
          "text": "♪ Never gonna make you cry ♪"
        },
        {
          "start": 205.68,
          "end": 207.84,
          "text": "♪ Never gonna say goodbye ♪"
        },
        {
          "start": 207.92,
          "end": 211.32,
          "text": "♪ Never gonna tell a lie\nand hurt you ♪"
        }
      ],
      "fullText": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules\nand so do I ♪ ♪ A full commitment's\nwhat I'm thinking of ♪ ♪ You wouldn't get this\nfrom any other guy ♪ ♪ I just wanna tell you\nhow I'm feeling ♪ ♪ Gotta make you understand ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪ ♪ We've known each other\nfor so long ♪ ♪ Your heart's been aching\nbut you're too shy to say it ♪ ♪ Inside we both know\nwhat's been going ♪ ♪ We know the game\nand we're gonna play it ♪ ♪ And if you ask me\nhow I'm feeling ♪ ♪ Don't tell me\nyou're too blind to see ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪ ♪ (Ooh, give you up) ♪ ♪ (Ooh, give you up) ♪ ♪ Never gonna give,\nnever gonna give ♪ ♪ (Give you up) ♪ ♪ Never gonna give,\nnever gonna give ♪ ♪ (Give you up) ♪ ♪ We've known each other\nfor so long ♪ ♪ Your heart's been aching\nbut you're too shy to say it ♪ ♪ Inside we both know\nwhat's been going ♪ ♪ We know the game\nand we're gonna play it ♪ ♪ I just wanna tell you\nhow I'm feeling ♪ ♪ Gotta make you understand ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪"
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:46.290Z"
}
```

## Beberapa bahasa

Kirim suatu array bahasa untuk menerima trek dan kesalahan bahasa permanen. Contoh ini menunjukkan bahasa Inggris tersedia dan Spanyol tidak tersedia.

```json
{
  "source": "youtube_captions",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": false
  }
}
```

`results[0]`:

```json
{
  "videoId": "jNQXAC9IVRw",
  "isAutoGenerated": false,
  "tracks": [
    {
      "videoId": "jNQXAC9IVRw",
      "languageCode": "en",
      "languageName": null,
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 0,
          "end": 1.5,
          "text": "Hello world."
        }
      ],
      "fullText": "Hello world."
    }
  ],
  "errors": [
    {
      "languageCode": "es",
      "code": "language_unavailable",
      "message": "Uploader-provided subtitles not available for language: es"
    }
  ]
}
```

## Ruas respon

| Ruas | Jenis | Deskripsi |
| --- | --- | --- |
| source | string | Sumber yang diminta API. |
| status | string | dilakukan ketika permintaan realtime sukses. |
| created_at | string | Waktu pembuatan respon dalam format ISO 8601. |
| usage.credits | number | Kredit dikenakan biaya untuk permintaan, berdasarkan rencana Anda. |
| results[0].videoId | string | Video yang diminta ID. |
| results[0].languageCode | string | Kode jalur judul yang dipilih sebenarnya, seperti en- orig. |
| results[0].languageName | string · nullable | Nama tampilan bahasa ketika tersedia. |
| results[0].requestedLanguageCode | string · optional | Kode yang diminta ketika berbeda dari languageCode, misalnya en ketika en- orig dipilih. |
| results[0].isAutoGenerated | boolean | Apakah judul yang dipilih dihasilkan secara otomatis. |
| results[0].segments | array | Segmen judul dalam urutan kronologis. |
| results[0].segments[].start | number | Segmen mulai waktu dalam detik. |
| results[0].segments[].end | number | Segmen akhir waktu dalam hitungan detik. |
| results[0].segments[].text | string | Teks judul. |
| results[0].fullText | string | Semua teks segmen bergabung ke dalam transkrip. |
| results[0].tracks | array · optional | Untuk arrays bahasa saja. Trek yang tersedia dalam urutan permintaan; masing-masing memiliki ruas tunggal-trek terdaftar di atas. |
| results[0].errors | array · optional | Untuk arrays bahasa saja. Gagal bahasa dalam urutan permintaan. Kosong ketika setiap trek sukses. |
| results[0].errors[].languageCode | string | Bahasa yang diminta gagal. |
| results[0].errors[].code | string | language_unavailable ketika trek yang dipilih tidak ada; retrieval_failed ketika tidak dapat diunduh atau diurai. |
| results[0].errors[].message | string | Deskripsi kegagalan bahasa. |

- API sudah membaca takarir yang sudah tersedia di YouTube. Ini tidak menghasilkan transkrip baru atau jatuh kembali antara otomatis dan uphagder disediakan takarir.
- Sebuah bahasa string menyimpan respon single-track. Sebuah array, bahkan ["en"], mengembalikan trek dan kesalahan daripada level atas languageCode, segmen dan fullText. Setiap trek meliputi orang-orang lapangan. Mobil diterapkan ke setiap bahasa.
- Untuk daftar bahasa, periksa errors untuk melihat trek yang gagal. Jika tidak ada trek yang berhasil diambil, permintaan gagal dan kredit yang dicadangkan dikembalikan. Kegagalan ekstraksi video dan tenggat permintaan yang terlampaui juga menyebabkan permintaan gagal.
- Tersedia untuk real time, async, batch dan massive. ekspor Bulk tetap JSONL dengan satu rekaman per video, termasuk trek dan kesalahannya. Accept dan X-Respond-With berlaku seperti biasa.

## Format respons

Respon menggunakan JSON secara baku. Pilih format lain dengan header opsional ini.

- Accept: application/json (baku) atau text/plain. Teks biasa menyajikan ruas yang sama dalam tata letak yang dapat dibaca, tidak terbaca.
- X-Respond-With: markdown. Tinggalkan unset untuk bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk kueri realtime dan hasil selesai.

Bidang di bawah ini menjelaskan respon baku JSON.

[Permohonan dan contoh format respon](https://flashdata.dev/id/docs/guides/response-formats/reference.md#headers)

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

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

## Dasar-dasar API

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

- [Async permintaan dan tanda terima](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#async)

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

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

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

- [Mengambil hasil selesai](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#results)
- [permintaan Batch JSON](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md#batch)
- [API pemrosesan Bulk](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md)
- [Bangun Bulk alur kerja bagi sumber ini](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md?source=youtube_captions#playground)
- [Pelanggan OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian

- [Menerima dan memverifikasi pelengkapan webhooks](https://flashdata.dev/id/docs/guides/async-batch/reference.md#webhooks)

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

## Permasalahan menarik

- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md#status-codes)
- [Kapan untuk mencoba lagi](https://flashdata.dev/id/docs/errors/reference.md#retries)

## Terkait APIs

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