Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

API-referentie

YouTube Transcript API

Een API-sleutel aanmaken

YouTube transcript tekst met tijdstempels en een volledig transcript ophalen. Automatische bijschriften worden standaard geselecteerd.

Stel een aanvraag samen

De ID van 11 tekens uit de video-URL, niet de volledige URL.

Laat leeg om eerst en-orig en daarna en te proberen en één spoor terug te geven. Of voer één tot 10 verschillende codes in, gescheiden door komma’s.

Nummer bijschrift 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))
Resultaten in de HTTP-responsX-API-Key-authenticatie

Parameters

Verzenden source en video_id op het bovenste niveau. Bronopties horen in params. Optionele velden kunnen worden weggelaten.

Aanvraaginhoud

sourcestring / Vereist
Instellen op youtube_transcript.
video_idstring / Vereist
De 11-karakter YouTube video ID, zoals FUfGcZ092b0. Accepteert letters, cijfers, onderstrepingen en koppeltekens.
Precies 11 tekensStandaard: Niet ingesteld
Geaccepteerd formaat^[A-Za-z0-9_-]{11}$
paramsobject / Optioneel
Settings voor dit verzoek.
Standaard: {}
callback_urlstring · nullable / Optioneel
Async en alleen batch. Publieke HTTPS voltooiing URL op poort 443, tot 2,048 tekens. Geen gebruikersgegevens of URL-fragment. Gebruik null of een lege tekenreeks zonder melding. In een batch, zet dit op elke query, buiten params.
Standaard: Niet ingesteld

Bijschriftselectie

params.languagestring | array / Optioneel
Omit for English (en-orig, dan en). Met auto=true probeert elke code eerst zijn -orig track, dan de gevraagde code. Expliciete -orig codes en auto=false blijven exact. Arrays-verzoek 1–10 verschillende talen.
Standaard: en-orig → en
params.autoboolean / Optioneel
true selecteert YouTube-gegenereerde ondertitels; false selecteert uploader-ondertitels. Dit selecteert bijschrift oorsprong, niet taaldetectie of nieuwe transcriptie.
true of falseStandaard: true

Antwoord

Realtime geeft terug status: done. Lees de bron uitvoer op results[0]; usage.credits neemt de aanklacht op.

Lees segmenten voor getimed tekst en fullText voor het samengevoegde transcript. Segment start en einde zijn seconden; languageCode en isAutoGenerated identificeren de geselecteerde track.

Lees het resultaat

Bewaar de succesvolle JSON respons als response.json. Sla dit op als read-response.py en voer python read-response.py uit. Het gebruikt alleen de standaardbibliotheek van Python en doet geen nieuw verzoek.

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

Geef taal de voorkeur aan en-orig en val terug naar en, terug een track. Met auto=true geeft elke gevraagde code de voorkeur aan de -orig track, dan de platte code; expliciet -orig en auto=false blijf precies. Arrays proberen elke gewenste taal en retourneren tracks en fouten in volgorde. languageCode identificeert de geselecteerde track; requestedLanguageCode is opgenomen wanneer het verschilt.

Controleer bij taallijsten in errors welke ondertitelsporen zijn mislukt. Als geen enkel spoor wordt opgehaald, mislukt het verzoek en worden gereserveerde credits teruggegeven. Een fout bij het uitlezen van de video of het overschrijden van de tijdslimiet laat het verzoek ook mislukken.

automatisch standaard naar true voor automatische bijschriften. Stel false in voor uploader-ondertitels. De API wisselt nooit van ondertitelbronnen.

De API leest bestaande YouTube bijschriften; het genereert geen nieuwe transcripten. Het standaard antwoord bevat genormaliseerde JSON tekst; Accept kan platte tekst selecteren en X-Respond-With: markdown selecteert Markdown. languageName kan null zijn.

Meerdere talen

Stuur een taalreeks om tracks en per-taal fouten te ontvangen. Dit voorbeeld toont Engels beschikbaar en Spaans niet beschikbaar.

Aanvraag
{
  "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 responsvelden
VeldOmschrijving
sourcestringDe gevraagde API bron.
statusstringgedaan wanneer het real-time verzoek slaagt.
created_atstringAanmaaktijd voor respons in ISO 8601-formaat.
usage.creditsnumberCredits in rekening gebracht voor het verzoek, op basis van uw plan.
results[0].videoIdstringDe gevraagde video ID.
results[0].languageCodestringWerkelijk geselecteerde bijschrift track code, zoals en-orig.
results[0].languageNamestring · nullableNaam van de taalweergave indien beschikbaar.
results[0].requestedLanguageCodestring · optionalDe gevraagde code als deze verschilt van languageCode, bijvoorbeeld en wanneer en-orig is geselecteerd.
results[0].isAutoGeneratedbooleanOf de geselecteerde bijschriften automatisch gegenereerd zijn.
results[0].segmentsarrayBijschrift segmenten in chronologische volgorde.
results[0].segments[].startnumberSegment starttijd in seconden.
results[0].segments[].endnumberSegment eindtijd in seconden.
results[0].segments[].textstringBijschrift tekst.
results[0].fullTextstringAlle segmenttekst is samengevoegd in een transcriptie.
results[0].tracksarray · optionalAlleen voor taalarrays. Beschikbare tracks in aanvraagvolgorde; elk heeft de bovengenoemde single-track velden.
results[0].errorsarray · optionalAlleen voor taalarrays. Foute talen in verzoekvolgorde. Leeg als elke track slaagt.
results[0].errors[].languageCodestringDe gewenste taal die faalde.
results[0].errors[].codestringlanguage_unavailable wanneer de geselecteerde track niet bestaat; retrieval_failed wanneer deze niet kon worden gedownload of ontleed.
results[0].errors[].messagestringBeschrijving van de taalfout.

De velden hierboven beschrijven het standaard JSON antwoord. JSON, platte tekst en Markdown-formaten.

Async geeft één opdrachtbon terug; batch geeft één per video ID. Controleer de status van elke taak en haal de resultaten ervan op met behulp van de teruggekeerde links.

Async & batch lifecycle

Indiening geeft een ontvangstbewijs terug, geen resultaten. Async creëert één taak; batch geeft een aparte taak terug in queries[] voor elke geaccepteerde vraag. Traceer en haal elke taak zelfstandig op.

Verzenden naar data.flashdata.dev; lees jobstatus en resultaten van api.flashdata.dev met dezelfde X-API-Key. De gekoppelde API basisvoorbeelden gebruiken Python en cURL.

  1. 1. De taak IDs opslaan

    De verzoekenvelden van deze bron behouden bij het overschakelen naar Async. Zet voor Batch elk verzoek in de query array van een JSON object. Bewaar elke teruggekeerde baan ID.

    Async verzoek en ontvangst · Batch-verzoeklichaam

  2. 2. Status controleren

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

    pending / processing: peiling met vertraging en respect Retry-After wanneer aanwezig. completed: resultaten halen. failed: inspectie job.error.

    Lees job.status, niet de status van het inzendingsbewijs.

    Controleer status · Python en cURL

    Job status API referentie
  3. 3. Resultaten ophalen

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

    Na voltooiing, authenticeer het resultaat gelezen, dan halen de 302 opslag URL zonder uw API sleutel. Bewaar de JSON binnen 24 uren na voltooiing.

    Resultaten · Python en cURL ophalen · Antwoordformaten

    Resultaat download API referentie

Bestudering en het ophalen van bestaande resultaten verbruiken geen query credits. Een polling timeout annuleert de taak niet: houd de ID in plaats van het indienen van dubbele factureerbare werk. Foutcodes en opnieuw proberen gedrag.

Webhooks bij voltooiing

Abonneren per query

Instellen callback_url op het hoogste niveau van een async-verzoek, of binnen elke query in een partij, buiten params. Er is geen afzonderlijk verzoek om webhook-registratie vereist. Realtime-verzoeken sturen geen terugbellers.

Gebruik een publieke HTTPS URL op poort 443. FlashData POST een melding voor elke taak bereiken completed of failed; het evenement bevat links, niet het resultaat zelf.

Bevestigen en verifiëren

Terugkeer 2xx na het duurzaam accepteren van de gebeurtenis. Dedupliceren door delivery_id, ook verzonden als X-Delivery-Id. Redirects worden niet gevolgd.

Mislukte leveringen opnieuw proberen met exponentiële backoff, tot 8 probeert totaal en maximaal 24 uren na voltooiing. Blijf peilen als een terugval.

De terugbellen zijn niet ondertekend. Bevestig de taak ID, bron- en terminalstatus via de geauthentiseerd status-eindpunt vóór de verwerking van de kennisgeving. De levering ID is voor deduplicatie, geen bewijs van authenticiteit.

Voorbeeld webhook event en velden
Kennisgeving van een indicatieve voltooiing
{
  "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"
    }
  ]
}
VeldOmschrijving
delivery_idstringStabiele leveringsidentificatiecode. Notificatieberichten dedupliceren met deze waarde; het wordt ook verzonden in de X-Delivery-Id header.
idstringJob ID.
sourcestringGevraagde databron.
statusstringvoltooid of mislukt.
linksarrayStatus en resultaat links. Meldingen bevatten geen resultaatinhoud of een API-sleutel.
links[].relstringzelf of resultaten.
links[].hrefstringAbsolute Management API URL; authenticeer met je API sleutel.
links[].methodstringGET.

Volledige webhook contract en URL beperkingen

Bulk-bestandsverwerking

Upload één video ID per regel en maak de Bulk job met bron: youtube_transcript. Gedeelde opties zijn van toepassing op elke ID in het bestand.

Bronopties: taal, auto. Zet ze in opties bij het aanmaken van de Bulk-taak.

Haal de voltooide collectie op als een manifeste en gzip-gecomprimeerde NDJSON resultaatdelen. Databronnen kunnen ook resultaatonderdelen leveren aan uw cloudopslag door options.result_storage in te stellen bij het aanmaken van de Bulk-taak. Bewaar het manifest en onderdelen binnen 24 uren nadat de volledige Bulk-taak is voltooid.

Bulk verwerking API · Python en cURL · Batch JSON verzoeken

Bouw een Bulk workflow voor deze bron · Pauze, hervatten en herstellen

Foutherstel

Als de gevraagde track niet beschikbaar is, moet u de transcriptLanguages van de Metadata API controleren en expliciet een ondersteund language/track-type aanvragen. Een niet-beschikbare selectie ongewijzigd herhalen zal die track niet aanmaken.

Beschik over beschikbare ondertiteltalen met Metadata. Een nieuw verzoek maakt gebruik van query credits; het veranderen van een track verandert geen bestaande job.

Gebruik de gedeelde foutreferentie voor authenticatie, saldo, verzoek-formaat en snelheidslimietfouten. Een inzending timeout kan nog steeds een baan hebben gecreëerd; controleer bestaand werk voordat opnieuw te proberen.

Fouten en statuscodes · Wanneer opnieuw proberen · Maximumtarieven

Stapsgewijze handleiding: Kies een transcripttaal en track

Prijzen

PlannenGebruikspercentagesper 1.000 standaardaanvragenAbonnementenInclusief credits per facturatieperiode
Betalen naar gebruikUS$ 0,50Geen maandelijkse kostenOpwaarderen wanneer nodig
MicroUS$ 0,40US$ 49,00 / maand1.000 credits (US$ 50,00 of API usance) inclusief
StarterUS$ 0,35US$ 199,00 / maand4.000 credits (US$ 200,00 of API usance) inclusief
ProUS$ 0,30US$ 499,00 / maand10.000 credits (US$ 500,00 of API usance) inclusief
ScaleUS$ 0,25US$ 999,00 / maand20.000 credits (US$ 1.000,00 of API usance) inclusief
BusinessUS$ 0,20US$ 1.999,00 / maand40.000 credits (US$ 2.000,00 of API usance) inclusief

Eén accountabonnement. Gedeelde credits voor alle drie de producten. Gebruik dat door inbegrepen credits wordt gedekt, wordt niet opnieuw in rekening gebracht.

Lopende prijzen en maxima van het plan