YouTube Transcript API

Eén verzoek erin, het volledige transcript eruit. Je betaalt alleen voor de video's die je ophaalt.

Snel aan de slag

Log in en maak een API-sleutel aan in het API-dashboard. Je krijgt 10 gratis credits (5 transcripten).
Stuur de sleutel mee in de X-API-Key-header met een YouTube-URL of video-ID.
Koop een creditpakket als je meer nodig hebt, of zet automatisch opwaarderen aan.

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: sv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'

Verzoek

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- of live-link). Gebruik dit of video_id.
video_id: De YouTube-video-ID van 11 tekens.
lang: Gewenste ondertiteltaal, bijvoorbeeld en, de of pt-BR. Standaard en. Ontbreekt die taal, dan krijg je het originele spoor terug en vermeldt het antwoord de echte taal.
format: json (segmenten met tijdstempels, standaard), text of srt.

import requests

response = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": "sv_live_your_key"},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=120,
)
print(response.json()["text"])

const response = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();

Antwoord

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "is_generated": false,
  "credits_used": 2,
  "credits_remaining": 98,
  "segments": [
    { "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
  ]
}

Fouten

401	invalid_key	Ontbrekende, verkeerde of ingetrokken API-sleutel.
400	invalid_input	De URL of video-ID kon niet worden gelezen.
402	insufficient_credits	Je saldo is lager dan 2 credits.
402	budget_exceeded	Je hebt de maandelijkse creditlimiet bereikt die je hebt ingesteld.
404	no_transcript	De video heeft geen ondertitels, of is privé, live of verwijderd. Niet gerekend.
429	rate_limited	Meer dan 60 verzoeken per minuut met één sleutel. Wacht het aantal seconden uit Retry-After.
502	upstream_error	YouTube antwoordde niet op tijd. Niet gerekend, probeer het later opnieuw.

Je saldo bekijken

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

Prijzen

Elk transcript kost 2 credits. Credits verlopen nooit. Pro-abonnees krijgen elke maand 100 bonuscredits.

Pakket	Credits	Transcripten	Prijs	Per transcript
Starter	100	50	US$ 4,49	US$ 0,090
Pro	500	250	US$ 13,99	US$ 0,056
Scale	2.000	1.000	US$ 37,99	US$ 0,038
Business	5.000	2.500	US$ 74,99	US$ 0,030

Automatisch opwaarderen, budgetten en meldingen

Automatisch opwaarderen koopt een pakket met je opgeslagen kaart zodra je saldo onder een door jou gekozen drempel zakt.
Een maandelijks opwaardeerbudget beperkt hoeveel automatisch opwaarderen mag uitgeven, en een maandelijkse creditlimiet stopt verzoeken zodra die bereikt is.
E-mailmeldingen laten je weten wanneer je saldo laag is, wanneer je 80% van je maandlimiet bereikt of wanneer een opwaardering mislukt.

Limieten en redelijk gebruik

60 verzoeken per minuut per sleutel, tot 5 actieve sleutels per account. De API geeft ondertitels terug die al op YouTube bestaan; hij zet geen audio om in tekst. Jij bent ervoor verantwoordelijk transcripten te gebruiken met respect voor de rechten van de video-eigenaren en de voorwaarden van YouTube.

Veelgestelde vragen

Betaal ik opnieuw voor dezelfde video?: Ja, elk geslaagd verzoek kost 2 credits, maar herhaalde video's worden binnen milliseconden uit onze cache beantwoord.
Wat gebeurt er als een video geen ondertitels heeft?: Je krijgt een no_transcript-fout en er worden geen credits afgeschreven.
Is het compatibel met andere transcript-API's?: Verzoek en antwoord volgen de gangbare opbouw met url, lang en segments, dus overstappen betekent meestal alleen de basis-URL en de sleutel aanpassen.