# FlashData YouTube Transcript API

Abrufen von YouTube Transkripttext mit Zeitstempeln und einem vollständigen Transkript. Automatische Beschriftungen werden standardmäßig ausgewählt.

Kanonische Referenz: https://flashdata.dev/de/docs/sources/youtube_transcript
Überarbeitet: 2026-10-23

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

Erforderliche Berechtigung für die Quelle: youtube_transcript

Ersetzen Sie YOUR_API_KEY durch einen API-Schlüssel, der über diese Quellberechtigung und verfügbare Credits verfügt. Führen Sie Anfragen auf Ihrem Server oder Agent-Host aus.

[Authentifizierung einrichten](https://flashdata.dev/de/docs/guides/headers-and-authentication/reference.md)

[Wählen Sie eine Transkriptsprache und Track](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md#captions)

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

## Senden Sie eine Anfrage

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

## Parameter

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

### Anfrageinhalt

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Setzen Sie auf youtube_transcript.  |
| <a id="parameter-video_id"></a> video_id | string | Ja | Nicht eingestellt | Das 11-Charakter YouTube Video ID, wie FUfGcZ092b0. Akzeptiert Buchstaben, Zahlen, Unterstriche und Bindestriche. Min. Länge: 11. Maximale Länge: 11. Muster: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Nein | {} | Settings für diese Anfrage.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nein | Nicht eingestellt | Async und Batch nur. Öffentliche HTTPS Fertigstellung URL auf Port 443, bis zu 2,048 Zeichen. Keine Benutzeranmeldeinformationen oder URL-Fragment. Verwenden Sie null oder einen leeren String für keine Benachrichtigung. Setzen Sie dies in einem Batch auf jede Abfrage, außerhalb von Params.  |

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

### Auswahl der Beschriftung

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string \| array | Nein | en-orig → en | Weglassen für Englisch (en-orig, dann en). Mit auto=true versucht jeder Code zuerst seine -Orig-Spur, dann den angeforderten Code. Explizite -orig-Codes und auto=false bleiben genau. Arrays fordern 1–10 unterschiedliche Sprachen an. Lassen Sie es aus, en-orig zu bevorzugen und fallen Sie zurück zu en und geben Sie einen Track zurück. Mit auto=true versucht jeder Code zuerst seinen -orig-Track, dann den angeforderten Code; explizite -orig-Codes und auto=false bleiben exakt. Arrays von 1–10 unterschiedlichen Codes versuchen jede angeforderte Sprache und geben Spuren und pro Sprache Fehler in der Reihenfolge der Anfrage zurück. languageCode identifiziert die ausgewählte Spur; requestedLanguageCode ist enthalten, wenn sie sich vom angeforderten Code unterscheidet. |
| <a id="parameter-params-auto"></a> params.auto | boolean | Nein | true | true wählt YouTube-generierte Untertitel aus; false wählt von Uploadern bereitgestellte Untertitel aus. Dies wählt den Ursprung der Beschriftung aus, nicht die Spracherkennung oder neue Transkription.  |

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

## Lesen Sie das Ergebnis

Speichern Sie die erfolgreiche JSON-Antwort als response.json. Speichern Sie dies als read-response.py und führen Sie Python read-response.py aus. Es verwendet nur die Standardbibliothek von Python und stellt keine neue Anforderung.

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

## Beispielantwort

Aufgezeichnetes Beispiel; Felder und Zählungen hängen von der Quelle und der angeforderten Eingabe ab.
```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"
}
```

## Mehrere Sprachen

Senden Sie ein Sprach-Array, um Tracks und pro-Sprach-Fehler zu erhalten. Dieses Beispiel zeigt Englisch verfügbar und Spanisch nicht verfügbar.

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

## Antwortfelder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| source | string | Die angeforderte API-Quelle. |
| status | string | Dies geschieht, wenn die Echtzeitanforderung erfolgreich ist. |
| created_at | string | Antworterstellungszeit im Format ISO 8601. |
| usage.credits | number | Credits, die für die anfrage berechnet werden, basierend auf ihrem plan. |
| results[0].videoId | string | Das angeforderte Video ID. |
| results[0].languageCode | string | Tatsächlich ausgewählter Beschriftungstrackcode, wie z. B. en-orig. |
| results[0].languageName | string · nullable | Name der Sprache, wenn verfügbar. |
| results[0].requestedLanguageCode | string · optional | Der angeforderte Code, wenn er sich von languageCode unterscheidet, z. B. wenn en-orig ausgewählt wurde. |
| results[0].isAutoGenerated | boolean | Ob die ausgewählten Untertitel automatisch generiert wurden. |
| results[0].segments | array | Beschriftungssegmente in chronologischer Reihenfolge. |
| results[0].segments[].start | number | Segmentstartzeit in Sekunden. |
| results[0].segments[].end | number | Segment-Endzeit in Sekunden. |
| results[0].segments[].text | string | Text der Bildunterschrift. |
| results[0].fullText | string | Alle Segmenttexte wurden in einem Transkript zusammengefügt. |
| results[0].tracks | array · optional | Nur für Spracharrays. Verfügbare Tracks in Request-Reihenfolge; jeder hat die oben aufgeführten Einzelspurfelder. |
| results[0].errors | array · optional | Nur für Spracharrays. Fehlgeschlagene Sprachen in der Reihenfolge der Anfrage. Leer, wenn jeder Track erfolgreich ist. |
| results[0].errors[].languageCode | string | Die angeforderte Sprache, die fehlgeschlagen ist. |
| results[0].errors[].code | string | language_unavailable, wenn der ausgewählte Track nicht existiert; retrieval_failed, wenn er nicht heruntergeladen oder analysiert werden konnte. |
| results[0].errors[].message | string | Beschreibung des Sprachversagens. |

- Der API liest Bildunterschriften, die bereits auf YouTube verfügbar sind. Es generiert keine neuen Transkripte oder fällt zwischen automatischen und von Uploadern bereitgestellten Bildunterschriften zurück.
- Eine String-Sprache hält die Single-Track-Antwort. Ein Array, sogar ["en"], gibt Spuren und Fehler anstelle von languageCode, Segmenten und fullText zurück. Jeder Track enthält diese Felder. auto gilt für jede Sprache.
- Prüfen Sie bei Spracharrays errors, um fehlgeschlagene Spuren zu erkennen. Wird keine Spur abgerufen, schlägt die Anfrage fehl und reservierte Credits werden erstattet. Auch Fehler bei der Videoextraktion oder eine Zeitüberschreitung führen zum Fehlschlag.
- Verfügbar für Echtzeit, Async, Batch und Bulk. Bulk Exporte bleiben JSONL mit einem Datensatz pro Video, einschließlich seiner Spuren und Fehler. Accept und X-Respond-With gelten wie gewohnt.

## Antwortformate

Antworten verwenden standardmäßig JSON. Wählen Sie ein anderes Format mit diesen optionalen Headern.

- Accept: application/json (Ausfall) oder text/plain. Klartext präsentiert die gleichen Felder in einem lesbaren, eingerückten Layout.
- X-Respond-With: markdown. Lassen Sie unset für Originalfelder. Markdown funktioniert mit beiden Antwortformaten.

Markdown steht für Echtzeit-Abfragen und abgeschlossene Ergebnisse zur Verfügung.

Die folgenden Felder beschreiben die Standardantwort von JSON.

[Beispiele für das Anforderungs- und Antwortformat](https://flashdata.dev/de/docs/guides/response-formats/reference.md#headers)

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

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

## API-Grundlagen

Der Request Builder und die obigen Beispiele verwenden die Parameter dieser Quelle. Verwenden Sie die Beispiele Python und cURL unten für gemeinsame Eingabe-, Status- und Ergebnisschritte. Ein Batch-Body ist ein JSON-Objekt, das Abfragen enthält; jedes Element gibt seinen eigenen Job ID zurück.

- [Async Anfrage und Empfang](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#async)

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

- [Jobstatus überprüfen](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#status)

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

- [Abrufen abgeschlossener Ergebnisse](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON Anfragen](https://flashdata.dev/de/docs/reference/batch-and-bulk/reference.md#batch)
- [API für Bulk-Verarbeitung](https://flashdata.dev/de/docs/reference/bulk-processing/reference.md)
- [Erstellen Sie einen Bulk-Workflow für diese Quelle](https://flashdata.dev/de/docs/reference/bulk-processing/reference.md?source=youtube_transcript#playground)
- [Kunden-OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Abschlussmeldungen

- [Empfangen und Verifizieren von Abschluss-Webhooks](https://flashdata.dev/de/docs/guides/async-batch/reference.md#webhooks)

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

## Fehlerbehebung

- [Fehler und Statuscodes](https://flashdata.dev/de/docs/errors/reference.md#status-codes)
- [Wann man es erneut versucht](https://flashdata.dev/de/docs/errors/reference.md#retries)

## Verwandte APIs

- [YouTube Captions API](https://flashdata.dev/de/docs/sources/youtube_captions/reference.md)
- [YouTube Video Metadaten API](https://flashdata.dev/de/docs/sources/youtube_metadata/reference.md)
