API de transcripciones de YouTube en Python: inicio en 5 minutos

Una petición, una transcripción

El camino más corto es un GET a /v1/transcripts/{videoId} con tu clave en la cabecera Authorization. La respuesta es JSON: id del vídeo, idioma, duración y lista de segmentos. No hace falta SDK; basta requests o httpx.

Elegir idioma y formato

Llama primero a /v1/transcripts/{videoId}/languages si el vídeo puede ser multilingüe, elige la pista y pasa ?lang= y ?format=. Pedir srt o vtt devuelve subtítulos listos para guardar; json conserva los segmentos estructurados.

Lotes y reintentos

Para listas, envía hasta 50 ids a /v1/transcripts en una llamada y lee los resultados por elemento. Añade timeout y un pequeño backoff exponencial: los fallos transitorios y los 429 se resuelven rápido, y cada respuesta trae un X-Request-ID para registrar.

Manejar los casos difíciles

Algunos vídeos no tienen subtítulos, otros son privados o están bloqueados por región. La API responde con un código tipado y un mensaje legible, así tu código decide según el código y no parseando texto. Registra el request id: es la vía más rápida a una solución.