# FlashData YouTube Captions API

Erişim tarihi: YouTube sıraları zamanlanmış metin ve tam bir transkript olarak sıralayın. Taklit edilen komutlar varsayılan olarak seçilir.

Canonical referans: https://flashdata.dev/tr/docs/sources/youtube_captions
İnceleme: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Kimlik doğrulama: X-API-Key: YOUR_API_KEY
Modes Modes: [Realtime](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md)

Gerekli kaynak izni izni: youtube_captions

Değişimi Değiştir YOUR_API_KEY Biriyle birlikte API Bu kaynak izni ve mevcut kredilere sahip anahtar. sunucunuzda veya acente ev sahibinizde yükleme talepleri.

[Varsayılan kimlik doğrulamayı ayarlayın](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)

[Erişim süreleri silinmiş](https://flashdata.dev/tr/docs/guides/timestamped-captions-recipe/reference.md)

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

## Bir istek gönder

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

## Parametreler

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

### İstek gövdesi

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Evet Evet Evet | — | youtube_captions'a ayarlayın.  |
| <a id="parameter-video_id"></a> video_id | string | Evet Evet Evet | Set Not set Not set | 11-character YouTube video ID, FUfGcZ092b0 gibi. Mektupları kabul eder, sayılar, işaretler ve hipnozlar. Min uzunluğu: 11. Max uzunluğu: 11. Desen: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Hayır yok hayır | {} | Settings bu istek için.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Hayır yok hayır | Set Not set Not set | Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.  |

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

### Caption Selection

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string \| array | Hayır yok hayır | en-orig → en | İngilizce için (en-orig, sonra). Auto=true ile, her kod ilk önce -veyaig takip etmeye çalışır, sonra istenen kodu. Explicit -orig kodları ve auto=false tam olarak kalır. Diziler 1–10 farklı diller talep eder. Omit en-orig'i tercih etmek ve geri dönmek, bir yol geri dönmek. Auto=true ile, her kod ilk önce -veyaig takip etmeye çalışır, sonra talep edilen kodu; açık -veyaig kodları ve auto=false tam olarak kalır. Dizinlerin Dizileri 1–10 Farklı kodlar her talep edilen dili deneyin ve parçaları geri döndürür ve talep emrinde dil hataları. languageCode Seçilmiş pisti tanımlayın; requestedLanguageCode İstenen koddan farklı olduğu zaman dahil edilir. |
| <a id="parameter-params-auto"></a> params.auto | boolean | Hayır yok hayır | false | true, YouTube-provided kuyrukları seçer; false yüklemeleyici-provided captions. Bu, isimsiz kökenini seçer, dil tespiti veya yeni transkripsiyon değil.  |

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

## Sonuç okuyun

JSON yanıtını response.json olarak kurtarın. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Sadece Python'un standart kütüphanesini kullanır ve yeni bir istek yapmaz.

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

## Örnek yanıt

Kayıt örneği; alanlar ve sayılar kaynağına bağlıdır ve talep edilen girdiye bağlıdır.
```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"
}
```

## Birden çok dil dili

Bir dil dizisini parçaları almak ve dil hataları için gönderin. Bu örnek, İngilizce'nin mevcut olmadığını ve İspanyolca olmadığını gösteriyor.

```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"
    }
  ]
}
```

## Yanıt alanları

| Field | Tür Türü Tipi | Description Description Description |
| --- | --- | --- |
| source | string | Talep edilen API kaynağı. |
| status | string | Gerçek zamanlı istek başarılı olduğunda yapılır. |
| created_at | string | ISO 8601 formatındaki arama süresi. |
| usage.credits | number | Krediler talep için ücretlendirilir, planınıza göre. |
| results[0].videoId | string | İstenen video ID. |
| results[0].languageCode | string | Actual selected caption track code, örneğin en-orig. |
| results[0].languageName | string · nullable | Dil ekran adı mevcut olduğunda. |
| results[0].requestedLanguageCode | string · optional | languageCode'dan farklı olduğu zaman istenen kod, örneğin en-orig seçildiğinde. |
| results[0].isAutoGenerated | boolean | Seçilmiş kuyruklar otomatik olarak üretilseydi. |
| results[0].segments | array | chronolojik düzenindeki kıvrım segmentleri. |
| results[0].segments[].start | number | Segment saniyeler içinde zaman başlar. |
| results[0].segments[].end | number | Segment saniyeler içinde son kez. |
| results[0].segments[].text | string | Caption text. |
| results[0].fullText | string | Tüm segment metni bir transkriptine katıldı. |
| results[0].tracks | array · optional | Dil dizileri için sadece. Talep emrinde mevcut parçalar; her biri yukarıda listelenen tek yol alanları vardır. |
| results[0].errors | array · optional | Dil dizileri için sadece. İstek siparişinde başarısız diller. Her pist başarılı olduğunda boş. |
| results[0].errors[].languageCode | string | Başarısız olan talep edilen dil. |
| results[0].errors[].code | string | language_unavailable Seçilmiş takip mevcut olmadığında; retrieval_failed Ne zaman indirilemeyecek veya parsed edilemezdi. |
| results[0].errors[].message | string | Dilin başarısızlığının tanımı. |

- API, YouTube'da zaten mevcut olan satırları okur. Yeni transkriptler yaratmaz veya otomatik ve yükleyici ayarlar arasında geri düşer.
- Bir dize dili tek yönlü yanıt tutar. Bir dizi, hatta ["en"], üst düzey languageCode, segmentler ve fullText yerine parçaları ve hataları döndürür. Her pist bu alanları içerir. auto her dil için geçerlidir.
- Dil dizilerinde alınamayan altyazı parçalarını görmek için errors alanını kontrol edin. Hiçbir altyazı parçası alınamazsa istek başarısız olur ve ayrılan krediler iade edilir. Video verisi çıkarılamadığında veya istek süresi dolduğunda da istek başarısız olur.
- Gerçek zamanlı, async, toplu ve toplu için kullanılabilir. Bulk ihracat JSONL'u video başına bir kayıtla kalır, parçaları ve hataları da dahil. Accept ve X-Respond-With her zamanki gibi uygulanır.

## Yanıt biçimleri

Yanıtlar JSON'u varsayılan olarak kullanır. Bu opsiyonel başlıkları ile başka bir format seçin.

- Accept: application/json (varsayılan) veya veya veya text/plain. Plain text aynı alanları okunabilir, okunabilir bir düzende sunar.
- X-Respond-With: markdown. Orijinal alanlarda başlangıç bırakın. Markdown, yanıt formatı ile çalışır.

Markdown gerçek zamanlı sorgular ve tamamlanmış sonuçlar için mevcuttur.

Aşağıdaki alanlar varsayılan JSON yanıtını tanımlar.

[İstek ve yanıt formatı örnekleri](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#headers)

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

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

## API temelleri

Yukarıdaki istek oluşturucu ve örnekler bu kaynağın parametrelerini kullanır. Python ve cURL örneklerini paylaşılan teslimiyet, durum ve sonuç adımları için kullanın. Bir Batch vücut, sorgu içeren bir JSON nesnedir; her öğe kendi işini döndürür ID.

- [Async isteği ve makbuz](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)

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

- [Check job status](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#status)

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

- [Erişim tamamlanmış sonuçlar](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON talep ediyor](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)
- [Bulk işleme API’si](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md)
- [Bu kaynak için bir Bulk iş akışı inşa edin](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md?source=youtube_captions#playground)
- [Müşteri Açık API](https://flashdata.dev/docs/openapi.json)

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

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

## Tamamlanan bildirimleri tamamlayın

- [Satın alın ve doğrulama webhooks](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#webhooks)

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

## Sorun Giderme

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md#status-codes)
- [Yeniden deneme ne zaman](https://flashdata.dev/tr/docs/errors/reference.md#retries)

## İlgili APIs

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