youtube-transcript-api är ett gratis Python-bibliotek med öppen källkod som hämtar undertexterna till en YouTube-video: pip install youtube-transcript-api, sedan YouTubeTranscriptApi().fetch(video_id). Det fungerar bra från din egen dator, men från en molnserver blockerar YouTube det ofta med RequestBlocked eller IpBlocked, och det hjälper inte för videor utan undertexter.
Vi körde det från en molnmaskin den 21 november 2026 och skickade sedan samma två videor genom vårt eget hostade API från samma maskin. Här är vad som hände, hur du använder biblioteket och när ett hostat API passar bättre.
Vad är youtube-transcript-api?
Det är ett Python-bibliotek av Jonas Depoix, på GitHub och PyPI, under MIT-licens. Aktuell version är 1.2.5, för Python 3.8 och senare.
- Det läser de undertexter YouTube redan har, kanalens egna eller YouTubes automatiska.
- Det behöver ingen API-nyckel och ingen headless-webbläsare.
- Det kan lista en videos undertextspråk, föredra ett språk framför ett annat och använda YouTubes maskinöversättning.
- Det formaterar utdata som text, JSON, SRT eller WebVTT och har ett kommandoradsverktyg.
Dess README är öppen med avvägningen: det använder en odokumenterad del av YouTubes webbspelare, så det finns "no guarantee that it won't stop working tomorrow".
Hur använder jag det?
pip install youtube-transcript-api
from youtube_transcript_api import YouTubeTranscriptApi
from youtube_transcript_api.formatters import SRTFormatter
ytt_api = YouTubeTranscriptApi()
# English if it exists, else German
transcript = ytt_api.fetch("aircAruvnKk", languages=["en", "de"])
for snippet in transcript:
print(snippet.start, snippet.text)
print(SRTFormatter().format_transcript(transcript))
På kommandoraden gör youtube_transcript_api aircAruvnKk --languages en --format json > transcript.json samma sak. README går igenom språklistor, översättning och resten.
Varför misslyckas det med IpBlocked på min server?
För att YouTube blockerar de flesta förfrågningar från molnleverantörer. Bibliotekets README säger det rakt ut: YouTube "has started blocking most IPs that are known to belong to cloud providers (like AWS, Google Cloud Platform, Azure, etc.)", så du kommer "most likely" att få RequestBlocked- eller IpBlocked-fel när koden är driftsatt. En hem-IP kan också blockeras efter för många förfrågningar.
Vi såg det själva. Den 21 november 2026 installerade vi version 1.2.5 på en molnmaskin och bad om två offentliga föreläsningar:
Samma maskin, samma två videor, 21 november 2026 (UTC).
Båda anropen gav IpBlocked efter ungefär 1,1 sekunder. En vanlig förfrågan till youtube.com från maskinen skickades vidare till Googles sida om "ovanlig trafik", så det var YouTube som nekade maskinen, inte ett fel i biblioteket.
README:ns lösning är proxyer, och den rekommenderar roterande residential-proxyer, eftersom YouTube spärrar statiska proxyer efter längre användning. Det fungerar, men det betyder ännu en betald tjänst, ännu ett konto och blockeringar att hålla koll på.
Vad mer kan stoppa det?
- Inga undertexter. Biblioteket läser undertexter; det transkriberar inte ljud. Avstängda undertexter ger
TranscriptsDisabled, och ett saknat språk gerNoTranscriptFound. - Åldersbegränsade videor. README säger att inloggning med cookies, som de kräver, är "currently not available" efter ändringar hos YouTube.
- Ändringar hos YouTube. Eftersom det använder ett odokumenterat gränssnitt kan en uppdatering hos YouTube bryta det tills en ny version kommer.
Inget av detta är ett skäl att undvika det för ett skript på din laptop. Det är ett skäl att planera för det innan du bygger in det i en produkt.
Vad kan jag använda i stället när det blockeras?
Ett hostat transkriptions-API som sköter hämtningen på sin sida. Vårt är YouTubeTranscript.devs API. Från samma molnmaskin, några minuter tidigare, samma två videor:
| Video | Längd | Tid | Ord | Tidsstämplade rader | Krediter |
|---|---|---|---|---|---|
| But what is a neural network? (3Blue1Brown) | 18:40 | 4,2 sekunder | 3 357 | 286 | 1 |
| 1. What is Computation? (MIT OpenCourseWare) | 43:06 | 4,2 sekunder | 6 363 | 887 | 1 |
| Samma video från 3Blue1Brown, begärd igen | 18:40 | 1,3 sekunder | 3 357 | 286 | 0 |
Så mätte vi: en förfrågan var till POST /api/v2/transcribe, bara undertexter och tidsstämplar på, tidtagen med curl från sändning till fullständigt svar. Krediterna är vad varje svar rapporterade. En körning var, så se tiderna som exempel.
Anropet från Python:
import requests
r = requests.post(
"https://www.youtubetranscript.dev/api/v2/transcribe",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"video": "aircAruvnKk", "mode": "auto", "format": {"timestamp": True}},
)
data = r.json()["data"]
for seg in data["transcript"]["segments"]:
print(seg["start"], seg["text"]) # start and end are in milliseconds
Avvägningen är kostnaden: biblioteket är gratis, API:et kostar 1 kredit per video med undertexter, med 10 gratis krediter i månaden och betalplaner från 5 dollar för 500. Med "mode": "auto" transkriberar det även videor utan undertexter, för 1 kredit per 2 minuter ljud. Det finns ett Python-SDK om du hellre slipper skriva förfrågan själv.
Hur integrerar jag ett transkriptions-API i min produkt?
Samma mönster fungerar oavsett API:
- Håll nyckeln på servern. Dina användare skickar en länk till din backend, och backenden anropar API:et. Lägg aldrig nyckeln i webbläsar- eller appkod.
- Ta emot alla länkformat. Skicka vidare länken som användaren skrev den; vårt tar fullständiga URL:er, youtu.be, Shorts, inbäddningar och rena ID:n (hela listan).
- Spara transkriptionen per video-ID. De flesta produkter ber om samma populära videor om och om igen. Hos oss kostar en transkription som ditt konto redan har ingenting att hämta igen, som tredje raden visar, men en lokal kopia är ännu snabbare.
- Behandla videor utan undertexter som ett jobb. Transkribering av ljud tar längre tid än en webbförfrågan bör vänta. Skicka
mode: "auto"med enwebhook_url, eller polla det returnerade jobb-ID:t, och visa användaren förloppet. - Använd batch när de är många. För en spellista, en kanal eller en backlogg, använd batch-endpointen i stället för en loop av enskilda anrop, så att du håller dig inom hastighetsgränsen.
API-dokumentationen beskriver varje fält, och vår guide till tal-till-text-API:et mäter träffsäkerhet och kostnad på ljud utan undertexter.
Vilket ska jag använda?
| Om du... | Använd |
|---|---|
| kör ett skript på din egen dator, några videor åt gången | youtube-transcript-api |
| driftsätter på en molnserver, en serverless-funktion eller i en produkt | Ett hostat API, eller biblioteket plus roterande residential-proxyer |
| hanterar videor utan undertexter | En tjänst som transkriberar ljud |
| hämtar hela spellistor eller kanaler | Ett hostat API med batch-endpoint |
Sammanfattning
- youtube-transcript-api är gratis, MIT-licensierat och enkelt:
YouTubeTranscriptApi().fetch(video_id). - På en molnserver blockerar YouTube det ofta; på vår molnmaskin gav båda videorna
IpBlockedefter ungefär 1,1 sekunder. Lösningen som föreslås är proxyer. - Det läser bara befintliga undertexter, och åldersbegränsade videor fungerar inte för närvarande.
- Ett hostat API gav samma videor från samma maskin på 4,2 sekunder vardera, för 1 kredit vardera, och hanterar även videor utan undertexter.
Vanliga frågor
Vad är youtube-transcript-api?+
Ett Python-bibliotek med öppen källkod (MIT-licens) som hämtar de undertexter YouTube redan har för en video, även automatiska, utan API-nyckel och utan webbläsare. Installera med pip install youtube-transcript-api och anropa YouTubeTranscriptApi().fetch(video_id).
Varför ger youtube-transcript-api RequestBlocked eller IpBlocked?+
För att YouTube blockerar de flesta förfrågningar från molnleverantörers IP-adresser och kan blockera alla IP-adresser som gör för många förfrågningar. Bibliotekets README säger det själv och föreslår roterande residential-proxyer. Från vår molnmaskin den 21 november 2026 gav båda videorna vi testade IpBlocked efter ungefär 1,1 sekunder.
Kan youtube-transcript-api transkribera en video utan undertexter?+
Nej. Det läser undertexter som redan finns. En video med avstängda undertexter ger TranscriptsDisabled, och en utan ditt språk ger NoTranscriptFound. För att få text från ljud behöver du en tal-till-text-tjänst.
Är youtube-transcript-api gratis?+
Ja, biblioteket är gratis och MIT-licensierat. Att köra det på en server innebär oftast att betala för proxyer, eftersom moln-IP-adresser blockeras.
Vad kan jag använda i stället för youtube-transcript-api på en server?+
Ett hostat transkriptions-API som sköter hämtningen åt dig. Från samma maskin där biblioteket blockerades gav YouTubeTranscript.devs API båda videorna på 4,2 sekunder vardera, för 1 kredit vardera, och en upprepad förfrågan på 1,3 sekunder gratis.
Hur integrerar jag ett transkriptions-API i min produkt?+
Håll API-nyckeln på din server, skicka videolänken till en endpoint, spara transkriptionen per video-ID så att du aldrig betalar två gånger, hantera videor utan undertexter som ett asynkront jobb med webhook och använd en batch-endpoint för många videor på en gång.