How to Get YouTube Transcripts in Python

youtube-transcript-api es un paquete de Python bien mantenido que obtiene los datos de subtítulos de YouTube directamente - sin clave de API, sin cuota de la YouTube Data API.

pip install youtube-transcript-api

Obtén una transcripción con un ID de video:

from youtube_transcript_api import YouTubeTranscriptApi

api = YouTubeTranscriptApi()
transcript = api.fetch("dQw4w9WgXcQ", languages=["en"])

for snippet in transcript:
    print(snippet.text, snippet.start, snippet.duration)

Esto funciona de forma fiable en una laptop. Al desplegarlo en un servidor en la nube, puede toparse con fallos reales y bien documentados - bloqueo de IP, PoTokenRequired, y un error de 'subtítulos deshabilitados' que no siempre es lo que parece. Consulta la lista de diagnóstico completa para las causas y soluciones exactas.

Obtén una clave gratis en el panel - 100 créditos gratis, sin tarjeta.

pip install requests

Sin pool de proxies, sin mantenimiento de bloqueos de IP - solo una petición HTTP:

import requests

response = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": "Bearer sk_live_..."},
)
result = response.json()

print(result["data"]["transcript"])
print(result["data"]["word_count"])

Una petición fallida devuelve un objeto de error en vez de lanzar una excepción específica de una librería, así que el mismo manejo de errores funciona en todos los endpoints.

{ "success": false, "code": "...", "message": "..." }

Iterar sobre una lista de IDs de video funciona igual - solo vigila el límite de peticiones por minuto de tu plan. Consulta la guía de límites de velocidad para la lógica de reintento y espera.