Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

API-Referenz

YouTube Transcript API

API-Schlüssel erstellen

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

Anfrage erstellen

Die 11 Zeichen lange ID aus der Video-URL, nicht die vollständige URL.

Leer lassen, um zuerst en-orig und danach en zu versuchen und eine Spur zurückzugeben. Alternativ einen bis 10 verschiedene Codes durch Kommas getrennt eingeben.

Beschriftungsspur auto
POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
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, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
Ergebnisse in der HTTP AntwortX-API-Key-Authentifizierung

Parameter

Senden source und video_id auf der obersten Ebene. Source-Optionen gehören in params. Optionale Felder können entfallen.

Anfrageinhalt

sourcestring / Erforderlich
Setzen Sie auf youtube_transcript.
video_idstring / Erforderlich
Das 11-Charakter YouTube Video ID, wie FUfGcZ092b0. Akzeptiert Buchstaben, Zahlen, Unterstriche und Bindestriche.
Genau 11 ZeichenStandard: Nicht eingestellt
Akzeptiertes Format^[A-Za-z0-9_-]{11}$
paramsobject / Optional
Settings für diese Anfrage.
Standard: {}
callback_urlstring · nullable / Optional
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.
Standard: Nicht eingestellt

Auswahl der Beschriftung

params.languagestring | array / Optional
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.
Standard: en-orig → en
params.autoboolean / Optional
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.
true oder falseStandard: true

Antwort

Realtime zurück status: done. Lesen Sie den Source Output auf results[0]; usage.credits die Ladung aufzeichnet.

Lesen Sie Segmente für Zeitstempeltext und fullText für das verknüpfte Transkript. Segmentstart und -ende sind Sekunden; languageCode und isAutoGenerated kennzeichnen die ausgewählte Spur.

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

Lassen Sie die Sprache weg, um en-orig zu bevorzugen, und greifen Sie auf en zurück, wobei Sie einen Track zurückgeben. Mit auto=true bevorzugt jeder angeforderte Code seine -orig-Spur, dann den einfachen Code; explizit -orig und auto=false bleiben genau. Arrays versuchen jede angeforderte Sprache und geben Spuren und Fehler in der Reihenfolge zurück. languageCode identifiziert den ausgewählten Track; requestedLanguageCode ist enthalten, wenn er sich unterscheidet.

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.

automatische Standardeinstellungen in true für automatische Beschriftungen. Legen Sie false für von Uploadern bereitgestellte Bildunterschriften fest. Der API schaltet niemals Beschriftungsquellen aus.

Der API liest vorhandene YouTube-Beschriftungen; er erzeugt keine neuen Transkripte. Die Standardantwort enthält normalisierten JSON-Text; Accept kann Klartext auswählen und X-Respond-With: markdown wählt Markdown. languageName kann null sein.

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.

Anfrage
{
  "source": "youtube_transcript",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
results[0]
{
  "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"
    }
  ]
}
Alle Antwortfelder
FeldBeschreibung
sourcestringDie angeforderte API-Quelle.
statusstringDies geschieht, wenn die Echtzeitanforderung erfolgreich ist.
created_atstringAntworterstellungszeit im Format ISO 8601.
usage.creditsnumberCredits, die für die anfrage berechnet werden, basierend auf ihrem plan.
results[0].videoIdstringDas angeforderte Video ID.
results[0].languageCodestringTatsächlich ausgewählter Beschriftungstrackcode, wie z. B. en-orig.
results[0].languageNamestring · nullableName der Sprache, wenn verfügbar.
results[0].requestedLanguageCodestring · optionalDer angeforderte Code, wenn er sich von languageCode unterscheidet, z. B. wenn en-orig ausgewählt wurde.
results[0].isAutoGeneratedbooleanOb die ausgewählten Untertitel automatisch generiert wurden.
results[0].segmentsarrayBeschriftungssegmente in chronologischer Reihenfolge.
results[0].segments[].startnumberSegmentstartzeit in Sekunden.
results[0].segments[].endnumberSegment-Endzeit in Sekunden.
results[0].segments[].textstringText der Bildunterschrift.
results[0].fullTextstringAlle Segmenttexte wurden in einem Transkript zusammengefügt.
results[0].tracksarray · optionalNur für Spracharrays. Verfügbare Tracks in Request-Reihenfolge; jeder hat die oben aufgeführten Einzelspurfelder.
results[0].errorsarray · optionalNur für Spracharrays. Fehlgeschlagene Sprachen in der Reihenfolge der Anfrage. Leer, wenn jeder Track erfolgreich ist.
results[0].errors[].languageCodestringDie angeforderte Sprache, die fehlgeschlagen ist.
results[0].errors[].codestringlanguage_unavailable, wenn der ausgewählte Track nicht existiert; retrieval_failed, wenn er nicht heruntergeladen oder analysiert werden konnte.
results[0].errors[].messagestringBeschreibung des Sprachversagens.

Die obigen Felder beschreiben die Standardantwort von JSON. JSON, Klartext und Markdown Formate.

Async gibt eine Auftragsbestätigung zurück; Batch gibt eine pro Auftrag zurück Video ID. Überprüfen Sie den Status jedes Jobs und rufen Sie seine Ergebnisse mit den zurückgegebenen Links ab.

Async & Batch-Lebenszyklus

Die Einreichung gibt eine Quittung zurück, keine Ergebnisse. Async erstellt einen Job; batch gibt einen separaten Job in queries[] Für jede akzeptierte Abfrage. Verfolgen und Abrufen jedes Jobs unabhängig.

Einreichen von data.flashdata.dev; lesen Sie den Jobstatus und die Ergebnisse von api.flashdata.dev mit dem gleichen X-API-Key. Die verknüpften API-Grundlagenbeispiele verwenden Python und cURL.

  1. 1. Speichern Sie den Job IDs

    Behalten Sie die Anforderungsfelder dieser Quelle bei, wenn Sie zu Async wechseln. Legen Sie für Batch jede Anfrage in das Abfrage-Array eines JSON-Objekts. Speichern Sie jeden zurückgegebenen Job ID.

    Async Anfrage und Empfang · Batch Anfragestelle

  2. 2. Kontrollstatus

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: Umfrage mit Verzögerung und Respekt Retry-After wenn vorhanden. completed: Ergebnisse holen. failed: Inspektion job.error.

    Lesen Sie job.status, nicht den Status der Eingangsbestätigung.

    Prüfstatus · Python und cURL

    Stellenstatus API-Referenz
  3. 3. Abrufergebnisse

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Nach Abschluss authentifizieren Sie das gelesene Ergebnis und holen dann den 302-Speicher URL ohne Ihren API-Schlüssel ab. Speichern Sie den JSON innerhalb von 24 Stunden nach Fertigstellung.

    Ergebnisse abrufen · Python und cURL · Antwortformate

    Ergebnis Download API Referenz

Das Abfragen und Abrufen vorhandener Ergebnisse verbraucht keine Abfragegutschriften. Ein Polling-Timeout storniert den Job nicht: Behalten Sie seinen ID, anstatt doppelt abrechenbare Arbeit einzureichen. Fehlercodes und Wiederholverhalten.

Webhooks bei Abschluss

Abonnieren pro Abfrage

Setz callback_url auf der obersten Ebene einer async-Anfrage oder In jeder Abfrage in einer Charge, außen params. Es ist keine separate Webhook-Registrierungsanforderung erforderlich. Realtime-Anfragen senden keine Rückrufe.

Verwenden Sie ein öffentliches HTTPS URL auf Port 443. FlashData POST eine Benachrichtigung für jeden Job, der erreicht wird completed oder failed; Das Ereignis enthält Links, nicht das Ergebnis selbst.

Bestätigung und Überprüfung

Rückkehr 2xx nach dauerhafter Annahme des Ereignisses. Dedupliziert von delivery_id, auch gesendet als X-Delivery-Id. Redirects werden nicht befolgt.

Fehlgeschlagene Lieferungen wiederholen sich mit exponentiellem Backoff, bis zu 8 Versuche insgesamt und höchstens 24 Stunden nach Fertigstellung. Führen Sie Umfragen als Rückfall.

Callbacks sind nicht signiert. Bestätigen Sie den Job ID, den Quell- und Terminalstatus durch die authentifizierter Statusendpunkt vor der Bearbeitung der Benachrichtigung. Die Lieferung ID dient der Deduplizierung, nicht dem Nachweis der Echtheit.

Beispiel Webhook Event und Felder
Illustrative Abschlussmeldung
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_transcript",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
FeldBeschreibung
delivery_idstringStabile Lieferkennung. Deduplizieren Sie Benachrichtigungen mit diesem Wert; es wird auch im X-Delivery-Id-Header gesendet.
idstringJob ID.
sourcestringAngeforderte Datenquelle.
statusstringvervollständigt oder fehlgeschlagen.
linksarrayStatus- und Ergebnislinks. Benachrichtigungen enthalten keinen Ergebnisinhalt oder einen API-Schlüssel.
links[].relstringSelbst oder Ergebnisse.
links[].hrefstringAbsolute Management API URL; Authentifizierung mit Ihrem API-Schlüssel.
links[].methodstringGET.

Full Webhook Vertrag und URL Einschränkungen

Bulk Dateiverarbeitung

Laden Sie ein Video ID pro Zeile hoch und erstellen Sie den Job Bulk mit der Quelle: youtube_transcript. Gemeinsame Optionen gelten für jede ID in der Datei.

Quellenoptionen: Sprache, Auto. Setzen Sie sie in Optionen, wenn Sie den Bulk-Job erstellen.

Holen Sie die fertige Sammlung als manifeste und gzip-komprimierte NDJSON Ergebnisteile ab. Datenquellen können auch Ergebnisteile in Ihren Cloud-Speicher liefern, indem Sie beim Erstellen des Bulk-Auftrags options.result_storage festlegen. Speichern Sie das Manifest und die Teile innerhalb von 24 Stunden nach Abschluss des gesamten Bulk-Auftrags.

Bulk Verarbeitung API · Python und cURL · Batch JSON Anfragen

Erstellen Sie einen Bulk-Workflow für diese Quelle · Pause, Wiederaufnahme und Wiederherstellung

Fehlerbehebung

Wenn der angeforderte Track nicht verfügbar ist, überprüfen Sie die Metadaten API's transcriptLanguages und fordern Sie eine unterstützte language/track explizit eingeben. Wenn Sie eine nicht verfügbare Auswahl unverändert wiederholen, wird dieser Track nicht erstellt.

Verfügbare Beschriftungssprachen mit Metadaten überprüfen. Eine neue Anforderung verwendet Abfrage-Credits; das Ändern eines Tracks ändert keinen bestehenden Job.

Für Authentifizierungs-, Balance-, Request-Format- und Rate-Limit-Fehler verwenden Sie die gemeinsame Fehlerreferenz. Ein Einreichungs-Timeout hat möglicherweise immer noch einen Job erstellt; Überprüfen Sie die vorhandene Arbeit, bevor Sie erneut versuchen.

Fehler und Statuscodes · Wann man es erneut versucht · Zinsbindungen

Schritt-für-Schritt Anleitung: Wählen Sie eine Transkriptsprache und Track

Preise

PläneNutzungssätzepro 1.000 StandardanfragenAbonnementsInklusive Credits pro Abrechnungszeitraum
Nutzungsabhängige Zahlung0,50 $Keine MonatsgebührBei Bedarf aufladen
Micro0,40 $49,00 $ / Monat1.000 Credits (50,00 $ von API Nutzung) enthalten
Starter0,35 $199,00 $ / Monat4.000 Credits (200,00 $ von API Nutzung) enthalten
Pro0,30 $499,00 $ / Monat10.000 Credits (500,00 $ von API Nutzung) enthalten
Scale0,25 $999,00 $ / Monat20.000 Credits (1.000,00 $ von API Nutzung) enthalten
Business0,20 $1.999,00 $ / Monat40.000 Credits (2.000,00 $ von API Nutzung) enthalten

Ein Kontotarif. Gemeinsames Guthaben für alle drei Produkte. Durch enthaltenes Guthaben gedeckte Nutzung wird nicht erneut berechnet.

Aktuelle Preise und Planlimits