Cómo evitar que YouTube bloquee tu IP al descargar subtítulos

Cómo evitar que YouTube bloquee tu IP al descargar subtítulos

Si estás descargando subtítulos de muchos vídeos de YouTube —por ejemplo, para transcribirlos, indexarlos o alimentar tu proyecto de asistente personal—, lo más eficaz es cambiar el patrón de descarga, no intentar forzar el acceso cuando YouTube empieza a limitarte.

Terminal mostrando configuración de yt-dlp para evitar bloqueos
Configuración recomendada para pausas entre descargas de subtítulos

YouTube aplica restricciones temporales cuando detecta demasiadas solicitudes desde una misma IP. El problema puede afectar a yt-dlp, youtube-transcript-api y otras herramientas, incluso aunque solo estés descargando texto y no vídeos completos.

1. Reduce la frecuencia de las solicitudes

  • Procesa los vídeos por lotes pequeños, en lugar de lanzar miles de solicitudes consecutivas.
  • Introduce pausas entre vídeos y aumenta la espera si aparecen errores HTTP 429, CAPTCHA o mensajes de verificación.
  • Guarda los subtítulos descargados en disco y consulta primero la caché antes de volver a solicitarlos.
  • Reintenta únicamente los vídeos que hayan fallado, no todo el lote.
  • Si una solicitud empieza a ser rechazada, detén el proceso en lugar de insistir: repetirla rápidamente suele empeorar la situación.

No existe un intervalo universal que garantice evitar los bloqueos; los límites pueden variar según el tipo de solicitud y el estado de la sesión.

2. Configuración específica para subtítulos en yt-dlp

yt-dlp dispone de la opción --sleep-subtitles, precisamente para introducir pausas entre descargas de subtítulos. Esta es una diferencia importante: --sleep-interval por sí solo no necesariamente introduce pausas entre las descargas de subtítulos.

En Windows, prueba primero con esta configuración conservadora:

yt-dlp --ignore-errors 
  --skip-download 
  --write-subs 
  --write-auto-subs 
  --sub-langs "es,es-419,es-ES" 
  --sleep-requests 2 
  --sleep-subtitles 10 
  --sleep-interval 5 
  --max-sleep-interval 15 
  --batch-file videos.txt

Donde videos.txt contiene una URL de YouTube por línea.

Ten presente lo siguiente:

  • Los valores son un punto de partida, no una garantía contra los bloqueos.
  • --sleep-subtitles 10 establece una espera de 10 segundos antes de cada descarga de subtítulos.
  • --sleep-requests 2 introduce pausas entre solicitudes durante la extracción.
  • --ignore-errors permite continuar con otros vídeos cuando alguno falla; no evita el bloqueo.
  • Si buscas subtítulos automáticos traducidos, puede ser necesario ajustar la estrategia: existen casos documentados de errores 429 específicos de esos subtítulos.

Puedes consultar las opciones actualizadas en el repositorio oficial de yt-dlp.

Diagrama de arquitectura de procesamiento de subtítulos escalable
Arquitectura robusta para descargar miles de subtítulos

3. Si ya te han bloqueado la IP

En ese caso, cambiar los parámetros no garantiza que puedas continuar inmediatamente:

  1. Detén las descargas y deja que se restablezca el acceso.
  2. Comprueba si puedes abrir vídeos y sus subtítulos normalmente en el navegador.
  3. Reanuda con una velocidad menor y sin procesos concurrentes.
  4. Si persiste el bloqueo, identifica si se trata de un límite temporal, un CAPTCHA o un requisito de autenticación.

No recomiendo cambiar repetidamente de IP ni rotar proxies para eludir el límite: puede complicar el diagnóstico y no resolver el problema de fondo.

4. Para descargar miles de subtítulos

Si estás montando una canalización de procesamiento de vídeos, haría algo más robusto que ejecutar yt-dlp sobre una lista enorme:

  • Una cola persistente de trabajos.
  • Una base de datos con el ID del vídeo, idioma, estado y fecha de descarga.
  • Caché de subtítulos ya obtenidos.
  • Un único trabajador de descarga, sin concurrencia inicial.
  • Pausa automática y reanudación manual cuando aparezcan errores 429.
  • Procesamiento local de los archivos descargados, sin volver a consultar YouTube.

Así puedes procesar miles de vídeos a lo largo del tiempo sin perder el trabajo realizado.

El coste del tiempo: una pausa de 20 segundos

Una pausa de 20 segundos entre cada descarga es bastante más prudente que encadenarlas inmediatamente, aunque no garantiza que YouTube no limite tu IP. Si necesitas descargar 1.000 subtítulos, solo las pausas de 20 segundos sumarían unas 5 horas y 33 minutos. Es un coste razonable si priorizas la estabilidad.

Si estás usando yt-dlp en Windows con esta pausa:

yt-dlp --skip-download --write-subs --write-auto-subs --sleep-subtitles 20 --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 15 --batch-file videos.txt

--sleep-subtitles 20 espera 20 segundos antes de cada descarga de subtítulos, mientras que --sleep-requests regula las pausas entre solicitudes durante la extracción. Un mismo vídeo puede requerir varias solicitudes, así que el intervalo entre vídeos no equivale necesariamente al intervalo entre todas las peticiones.

Mi recomendación sería comenzar así:

  • 20 segundos entre descargas de subtítulos.
  • Un solo proceso, sin descargas paralelas.
  • Caché para no descargar dos veces el mismo subtítulo.
  • Si aparece un HTTP 429, detener el lote y esperar antes de reanudarlo.

Una última precisión: si ya tienes la IP temporalmente limitada, añadir pausas no elimina necesariamente esa restricción; primero tendrás que esperar a que se restablezca el acceso.

Cálculo de tiempo necesario para descarga estable de subtítulos
El tiempo es la mejor inversión para evitar bloqueos

La paciencia es la mejor estrategia cuando trabajas con APIs que protegen su contenido. Invertir tiempo en configuraciones correctas ahorra horas de frustración y bloqueos repetidos.