YouTube API Quota Exceeded: Causes and Fixes

Cada proyecto de Google Cloud recibe por defecto una cuota de la YouTube Data API v3 de 10 000 unidades por día, que se restablece a medianoche hora del Pacífico: no hay transferencia de saldo ni forma de activar un restablecimiento anticipado. La cuota se controla por proyecto, no por clave de API, así que generar una segunda clave del mismo proyecto no te da un segundo grupo de cuota.

Cada llamada a la API cuesta unidades, no solicitudes, y los costos son desiguales. Aquí está el panorama completo de los endpoints que realmente usan los desarrolladores:

A 100 unidades por búsqueda, un proyecto puede agotar toda su cuota diaria después de solo 100 llamadas de búsqueda, antes de descargar un solo subtítulo. Esta es la forma más común en que los proyectos pequeños chocan con el límite: no hicieron 10 000 solicitudes, hicieron unos cientos de solicitudes caras. En cambio, videos.list, channels.list y playlistItems.list son baratas, a 1 unidad cada una: si ya conoces el ID de un video, canal o lista de reproducción, esas llamadas apenas afectan el presupuesto diario.

1. Abre Google Cloud Console para el proyecto vinculado a tu clave de API.
2. Ve a APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Esto muestra tu uso actual frente a las consultas por día y los límites por minuto, actualizado con un pequeño retraso en lugar de en tiempo real.

Si ya estás cerca del límite antes de haber hecho 10 000 solicitudes, esta vista te confirma que es el problema de las llamadas caras mencionado arriba, no un error.

Ambos devuelven un 403, y en conversaciones informales suelen agruparse como "errores de cuota", pero son problemas distintos con soluciones distintas:

• quotaExceeded (motivo: dailyLimitExceeded) - tu proyecto usó toda su asignación diaria de unidades. Nada lo soluciona salvo esperar el restablecimiento de medianoche hora del Pacífico, reducir el costo por llamada, o conseguir la aprobación de un aumento de cuota.
• rateLimitExceeded - estás enviando solicitudes demasiado rápido en una ventana corta, independientemente de tu total diario. Es un problema de ritmo, no de presupuesto; consulta nuestra guía de límite de tasa para saber cómo manejarlo correctamente con retroceso.

1. Usa caché de forma agresiva. La cuota se cobra por llamada a la API, no por solicitud de cara al usuario: si vuelves a obtener repetidamente los subtítulos del mismo video, guarda el resultado en caché (incluso una simple caché en memoria con TTL) en lugar de volver a llamar a la API para datos que no cambian minuto a minuto.
2. Evita search.list cuando funcione una búsqueda directa por ID. Si ya tienes el ID de un video, canal o lista de reproducción, la llamada .list correspondiente cuesta 100 veces menos que una búsqueda.
3. Agrupa las búsquedas por ID. videos.list acepta hasta 50 IDs separados por comas por llamada por el mismo costo de 1 unidad que un solo ID: obtener 50 videos de uno en uno en lugar de en lote es 50 veces más caro sin ningún motivo.
4. Solicita un aumento de cuota una vez que tengas uso de producción real que lo justifique, mediante el formulario de auditoría y extensión de cuota de YouTube API Services enlazado desde la página de cuota de Cloud Console. Espera una revisión manual, no una aprobación instantánea.
5. Usa una API de transcripción que no consuma tu propia cuota de YouTube. La API de GetYouTubeTranscript obtiene transcripciones contra su propia infraestructura en lugar de actuar como intermediaria de captions.download con tu clave, así que no hay un límite diario de 10 000 unidades que gestionar, solo el límite de tasa de solicitudes propio del plan.

cURL:

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Node.js:

const res = await fetch(
  "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ",
  { headers: { Authorization: `Bearer ${process.env.GETYOUTUBETRANSCRIPT_API_KEY}` } }
);
const { data } = await res.json();
console.log(data.transcript);

Python:

import os, requests

res = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['GETYOUTUBETRANSCRIPT_API_KEY']}"},
)
print(res.json()["data"]["transcript"])

Esto cuesta 1 crédito en tu plan de GetYouTubeTranscript, no unidades de la cuota de la YouTube Data API de tu proyecto de Google Cloud. Obtén 100 créditos gratis, sin tarjeta requerida, desde el panel, o consulta la documentación completa de la API.