# FlashData YouTube Transcript API

Erişim tarihi: YouTube transkriptleri ve tam bir transkript. Otomatik kuyruklar varsayılan olarak seçilir.

Canonical referans: https://flashdata.dev/tr/docs/sources/youtube_transcript
İ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_transcript

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)

[Bir transkript dili seçin ve takip edin](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#captions)

<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_transcript",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": True,
    },
}

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_transcript",
  "video_id": "dQw4w9WgXcQ",
  "params": {
    "language": "en",
    "auto": true
  }
}
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_transcript'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 | true | 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_transcript",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "languageName": null,
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0.32,
          "end": 14.58,
          "text": "[Music]"
        },
        {
          "start": 18.8,
          "end": 25.96,
          "text": "We're no strangers to"
        },
        {
          "start": 21.8,
          "end": 29.119,
          "text": "love. You know the rules and so do"
        },
        {
          "start": 25.96,
          "end": 30.279,
          "text": "I. I feel commitments from what I'm"
        },
        {
          "start": 29.119,
          "end": 34.36,
          "text": "thinking"
        },
        {
          "start": 30.279,
          "end": 39.559,
          "text": "of. You wouldn't get this from any other"
        },
        {
          "start": 34.36,
          "end": 43.12,
          "text": "guy. I just want to tell you how I'm"
        },
        {
          "start": 39.559,
          "end": 45.84,
          "text": "feeling. Got to make you understand."
        },
        {
          "start": 43.12,
          "end": 49.2,
          "text": "Never going to give you up. I'm going to"
        },
        {
          "start": 45.84,
          "end": 53.32000000000001,
          "text": "let you down. I'm going to run around"
        },
        {
          "start": 49.2,
          "end": 56.399,
          "text": "and desert you. I'm going to make"
        },
        {
          "start": 53.32,
          "end": 59.879,
          "text": "you say goodbye."
        },
        {
          "start": 56.399,
          "end": 64.04,
          "text": "Tell a lie and hurt"
        },
        {
          "start": 59.879,
          "end": 67.2,
          "text": "you. We've known each other for so"
        },
        {
          "start": 64.04,
          "end": 70.56,
          "text": "long. Your heart's been aching, but"
        },
        {
          "start": 67.2,
          "end": 72.60000000000001,
          "text": "you're too shy to say we don't know"
        },
        {
          "start": 70.56,
          "end": 77.799,
          "text": "what's been going"
        },
        {
          "start": 72.6,
          "end": 81.479,
          "text": "on. We know the game and we're going to"
        },
        {
          "start": 77.799,
          "end": 84.56,
          "text": "play. If you ask me how I'm"
        },
        {
          "start": 81.479,
          "end": 88.32,
          "text": "feeling, don't tell me your truth. to"
        },
        {
          "start": 84.56,
          "end": 88.32000000000001,
          "text": "see. I will give"
        },
        {
          "start": 89.88,
          "end": 94.72,
          "text": "you"
        },
        {
          "start": 91.72,
          "end": 94.72,
          "text": "around"
        },
        {
          "start": 95,
          "end": 99.04,
          "text": "you. I will say"
        },
        {
          "start": 99.56,
          "end": 106.759,
          "text": "goodbye and hurt you. I will give"
        },
        {
          "start": 103.99,
          "end": 108.6,
          "text": "[Music]"
        },
        {
          "start": 106.759,
          "end": 115.92,
          "text": "you"
        },
        {
          "start": 108.6,
          "end": 115.92,
          "text": "around you. I will leave you. I will say"
        },
        {
          "start": 116.439,
          "end": 121.079,
          "text": "goodbye and hurt you."
        },
        {
          "start": 128.319,
          "end": 132.56,
          "text": "Never going to give. Never going to"
        },
        {
          "start": 129.759,
          "end": 134,
          "text": "give."
        },
        {
          "start": 132.56,
          "end": 136.8,
          "text": "Never going to give. Never going to"
        },
        {
          "start": 134,
          "end": 141.04,
          "text": "give."
        },
        {
          "start": 136.8,
          "end": 143.68,
          "text": "We've known each other for so long."
        },
        {
          "start": 141.04,
          "end": 147.51999999999998,
          "text": "Your heart's been aching, but you're too"
        },
        {
          "start": 143.68,
          "end": 148.52,
          "text": "shy to say it. We both know what's been"
        },
        {
          "start": 147.52,
          "end": 152.239,
          "text": "going"
        },
        {
          "start": 148.52,
          "end": 157.8,
          "text": "on. We know the game and we're going to"
        },
        {
          "start": 152.239,
          "end": 161.36,
          "text": "play it. I just want to tell you how I'm"
        },
        {
          "start": 157.8,
          "end": 163.92000000000002,
          "text": "feeling. Got to make you understand."
        },
        {
          "start": 161.36,
          "end": 166.8,
          "text": "Never going to give you up. Never going"
        },
        {
          "start": 163.92,
          "end": 171.28,
          "text": "to let you down. Never going to run"
        },
        {
          "start": 166.8,
          "end": 171.28,
          "text": "around and desert you. Heat."
        },
        {
          "start": 172.33,
          "end": 182.76,
          "text": "[Music]"
        },
        {
          "start": 178.76,
          "end": 182.76,
          "text": "Heat. Heat. Heat."
        },
        {
          "start": 183.39,
          "end": 195.2,
          "text": "[Music]"
        },
        {
          "start": 191.04,
          "end": 197.76,
          "text": "Never going to tell a lie and hurt you."
        },
        {
          "start": 195.2,
          "end": 200.64,
          "text": "Never going to give you up. Never going"
        },
        {
          "start": 197.76,
          "end": 204.239,
          "text": "to let you down. Never going to run"
        },
        {
          "start": 200.64,
          "end": 206.83999999999995,
          "text": "around and desert you. Never going to"
        },
        {
          "start": 204.239,
          "end": 211.879,
          "text": "make you cry. Never going to say"
        },
        {
          "start": 206.84,
          "end": 211.879,
          "text": "goodbye. Never going to say goodbye."
        }
      ],
      "fullText": "[Music] We're no strangers to love. You know the rules and so do I. I feel commitments from what I'm thinking of. You wouldn't get this from any other guy. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. I'm going to let you down. I'm going to run around and desert you. I'm going to make you say goodbye. Tell a lie and hurt you. We've known each other for so long. Your heart's been aching, but you're too shy to say we don't know what's been going on. We know the game and we're going to play. If you ask me how I'm feeling, don't tell me your truth. to see. I will give you around you. I will say goodbye and hurt you. I will give [Music] you around you. I will leave you. I will say goodbye and hurt you. Never going to give. Never going to give. Never going to give. Never going to give. We've known each other for so long. Your heart's been aching, but you're too shy to say it. We both know what's been going on. We know the game and we're going to play it. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. Never going to let you down. Never going to run around and desert you. Heat. [Music] Heat. Heat. Heat. [Music] Never going to tell a lie and hurt you. Never going to give you up. Never going to let you down. Never going to run around and desert you. Never going to make you cry. Never going to say goodbye. Never going to say goodbye."
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:44.040Z"
}
```

## 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_transcript",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
```

`results[0]`:

```json
{
  "videoId": "jNQXAC9IVRw",
  "isAutoGenerated": true,
  "tracks": [
    {
      "videoId": "jNQXAC9IVRw",
      "languageCode": "en-orig",
      "requestedLanguageCode": "en",
      "languageName": null,
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0,
          "end": 1.5,
          "text": "Hello world."
        }
      ],
      "fullText": "Hello world."
    }
  ],
  "errors": [
    {
      "languageCode": "es",
      "code": "language_unavailable",
      "message": "Auto-generated 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_transcript#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 Captions API](https://flashdata.dev/tr/docs/sources/youtube_captions/reference.md)
- [YouTube Video Metadata API](https://flashdata.dev/tr/docs/sources/youtube_metadata/reference.md)
