Clave API de YouTube: cómo conseguirla y qué paga la cuota diaria
Una clave API de YouTube son cuatro pasos en la consola de Google Cloud: crear un proyecto, activar YouTube Data API v3, abrir Credentials y crear la clave. Solo lee datos públicos. Subir un vídeo, leer tus propias analíticas o responder a un comentario exige OAuth 2.0, y lo que de verdad te limita es la cuota diaria.
Todo lo que viene a continuación se leyó en la documentación de la YouTube Data API el 10 de noviembre de 2026.
Cómo conseguir una clave API de YouTube
Necesitas una cuenta de Google. Abrir la consola es gratis; la YouTube Data API en sí no tiene precio por llamada, solo cuota.
- Abre la consola de Google Cloud y crea un proyecto, o selecciona uno que ya tengas.
- Abre la API Library y activa YouTube Data API v3. Si no está activada, cada petición responde con un 403 tengas las credenciales que tengas.
- Abre la página Credentials.
- Selecciona Create credentials > API key. La clave aparece al instante.
- Selecciona Restrict key antes de publicar nada.
Las palabras de Google sobre ese último punto: «Restrict the key before using it in production.» Importan dos restricciones. Una restricción de API limita la clave a la YouTube Data API, así que una clave filtrada no se puede gastar en otros servicios de Google. Una restricción de aplicación la limita a las IP de tu servidor, a tus referentes HTTP o a la firma de tu app.
La clave va en la petición como parámetro de URL:
curl "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID&key=YOUR_API_KEY"
Lo que significa que viaja en URLs, en logs de servidor y en el historial del navegador. Dala por pública en cuanto esté en código de cliente, y deja todo lo que te cueste cuota real detrás de tu propio backend.
Clave API u OAuth: las credenciales de YouTube que de verdad necesitas
Aquí es donde la mayoría pierde una tarde. La clave no es un login. Identifica tu proyecto para la facturación y la cuota, no a un usuario.
Google enuncia la regla con claridad: «Use an API key for requests that only retrieve public data, such as public video metadata or search results.» Para todo lo demás, tu aplicación «must use the OAuth 2.0 protocol».
| Lo que quieres hacer | Método | Credencial |
|---|---|---|
| Leer las vistas y el título de un vídeo público | videos.list |
Clave de API |
| Buscar vídeos públicos | search.list |
Clave de API |
| Leer los suscriptores de un canal público | channels.list |
Clave de API |
| Subir un vídeo | videos.insert |
OAuth 2.0 |
| Actualizar o borrar tu propio vídeo | videos.update, videos.delete |
OAuth 2.0 |
| Responder a un comentario | comments.insert |
OAuth 2.0 |
| Poner una miniatura | thumbnails.set |
OAuth 2.0 |
Leer tu propio canal con mine=true |
channels.list |
OAuth 2.0 |
O sea: si buscaste una clave API de YouTube porque quieres un bot que suba tus vídeos, la clave no es lo que necesitas. Necesitas un ID de cliente OAuth, una pantalla de consentimiento, un refresh token y, en cuanto pases de usuarios de prueba, la revisión de verificación de Google. El ID de cliente se crea en la misma página Credentials: Create credentials > OAuth client ID, y luego elige el tipo de aplicación.
La mitad de ese trabajo que son los tokens es igual en todas las redes, y es la parte que sigue rompiéndose meses después. Los access tokens de redes sociales cubre el refresh, la caducidad y las desconexiones silenciosas en cada plataforma.
Qué paga la cuota diaria
YouTube no cuenta llamadas, cuenta unidades. La documentación describe la asignación por defecto en tres pools:
- 100 llamadas a
search.listal día. - 100 llamadas a
videos.insertal día. - 10 000 unidades al día para el resto de endpoints.
Los costes en unidades que importan, sacados directamente de la tabla de cuota:
| Método | Coste en unidades | Qué hace |
|---|---|---|
videos.list |
1 | Leer metadatos y estadísticas de un vídeo |
channels.list |
1 | Leer datos del canal |
playlists.list |
1 | Leer playlists |
commentThreads.list |
1 | Leer comentarios de primer nivel |
comments.list |
1 | Leer respuestas |
playlistItems.insert |
50 | Añadir un vídeo a una playlist |
comments.insert |
50 | Publicar un comentario o una respuesta |
thumbnails.set |
50 | Poner una miniatura personalizada |
captions.insert |
400 | Subir una pista de subtítulos |
Las lecturas son baratas, las escrituras no. Subir subtítulos cuesta 400 unidades, así que 25 agotan el pool principal por sí solas. Y cuenta cada petición, incluidas las que fallan: una petición inválida cuesta al menos una unidad, así que un bucle de reintentos contra un parámetro malo quema cuota tan rápido como el trabajo real.
Las cifras de cuota que sorprenden
Hay tres cosas que pillan a los equipos.
La búsqueda tiene su propio pool, y es pequeño. Cien llamadas a search.list al día no es nada para una función de búsqueda. Si construyes búsqueda sobre YouTube, cacheas los resultados o pides más cuota con el formulario de ampliación. Paginar cuesta una llamada por página, así que un usuario que baja cuatro páginas gasta cuatro de tus cien.
Las subidas se limitan por número, no por unidades. Cien llamadas a videos.insert al día suena generoso hasta que gestionas varios canales. El tope es por proyecto, no por canal, así que diez canales comparten esas mismas cien.
La cuota se reinicia en hora del Pacífico, no en la tuya. El contador diario cambia a medianoche del Pacífico. Si tu scheduler se dispara a medianoche en Madrid, estás gastando la cuota del día anterior.
Cuando necesitas más, la página de Quotas de la consola muestra el consumo y Google ofrece un formulario de ampliación. Cuenta con describir tu caso de uso y con esperar. La documentación avisa además de que la asignación por defecto está «subject to change», razón suficiente para registrar tu gasto en unidades en vez de dar por hecho que las cifras de hoy duran siempre.
Publicar en YouTube y en otras siete redes
Si YouTube es la única plataforma que tocas, constrúyelo tú: un cliente OAuth, un refresh token y listo. La cuenta cambia cuando YouTube es una red entre varias, porque cada plataforma trae su propio flujo OAuth, su propia revisión y su propio modelo de cuota. La guía de APIs de redes sociales pone esas diferencias una al lado de otra, y la API de analíticas de redes sociales explica por qué la misma métrica se lee distinto en cada red.
Ese es el hueco que llena PlugKit. Conecta Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp y Telegram detrás de una sola API REST y un solo servidor MCP alojado en https://api.plugkit.co/mcp, gestiona el OAuth y el refresh de los tokens, y cuesta 49 $ al mes por 5 cuentas conectadas, cancelas cuando quieras. Siete días gratis, con tarjeta al registrarte y sin ningún cargo antes del día 7.
Eso no quita la cuota de YouTube, y nada puede: la cuota es de quien posee el proyecto de API. Lo que quita es el trabajo de credenciales por plataforma. Si lo único que necesitabas eran los metadatos públicos de los vídeos, una clave API normal y 30 líneas de código siguen siendo la respuesta correcta, y es la que deberías tomar.
Preguntas frecuentes
¿La clave API de YouTube es gratis?
Sí. La YouTube Data API no tiene precio por llamada. Lo que tienes es una cuota diaria, por defecto 10 000 unidades para los endpoints generales más pools separados de 100 llamadas de búsqueda y 100 subidas. Pasar de ahí significa pedir una ampliación, no pagar una factura.
¿Puedo subir un vídeo solo con una clave API de YouTube?
No. Las subidas pasan por videos.insert, y Google exige OAuth 2.0 para cada inserción, actualización y borrado. La clave API identifica tu proyecto, no autoriza una acción sobre un canal. Necesitas un ID de cliente OAuth, el consentimiento del usuario y un refresh token.
¿Cómo consigo una clave API de YouTube gratis?
Crea un proyecto en Google Cloud, activa YouTube Data API v3 en la API Library, abre Credentials y elige Create credentials, y después API key. No se pide tarjeta para la cuota de la Data API. Restringe la clave a la YouTube Data API antes de ponerla en producción.
¿Qué pasa cuando llego a la cuota de la API de YouTube?
Las peticiones responden con un 403 y el motivo quotaExceeded hasta que el contador se reinicia a medianoche del Pacífico. No se cobra nada ni se frena de forma gradual: simplemente paras hasta el reinicio, y por eso agrupar lecturas y cachear búsquedas importa más que optimizar llamadas sueltas.
¿Cuál es la diferencia entre una clave API de YouTube y las credenciales OAuth?
Una clave identifica tu proyecto y solo lee datos públicos. Las credenciales OAuth identifican a un usuario que ha dado acceso a tu app, y eso es lo que te deja subir, editar, comentar o leer datos privados del canal. Muchos proyectos necesitan las dos: la clave para lecturas públicas y OAuth para todo lo que toca el canal del usuario.
Un solo plug para cada plataforma que toca tu agente
49 $ al mes por 5 cuentas conectadas, cancela cuando quieras. Todas las funciones en todos los planes.
Consigue tu clave de API →