¿Hasta dónde llega YouTube API? Funciones, límites y otras opciones
Qué permite YouTube Data API v3, cómo buscar vídeos por palabra clave, qué cuota consume y qué límites tiene. Con alternativas sin código.
Buscar vídeos por palabra clave y quedarte con el título, el canal, la fecha y las visualizaciones parece un trabajo de cinco minutos. Con YouTube API lo es, hasta que la cuota empieza a descontarse y descubres que la búsqueda no trae las estadísticas y que el detalle hay que pedirlo en una segunda llamada.
Esta guía repasa qué permite realmente la API de YouTube, cómo se hace esa búsqueda paso a paso y dónde están los límites que casi nunca aparecen en la documentación: cuota, campos que ya no existen y permisos. Al final, cuándo conviene una vía sin código y cuándo la API sigue siendo la única opción.
¿Qué es YouTube API (la API de YouTube)?
YouTube Data API v3 es una API REST: envías una petición HTTP a un recurso concreto y recibes una respuesta JSON. Los recursos son vídeos, canales, listas de reproducción, comentarios y subtítulos, entre otros, y cada uno tiene sus propios métodos y campos disponibles.
Hay dos formas de identificarte, y la diferencia importa:
- Clave de API (API key): sirve para leer datos públicos. Es lo que necesitas para buscar vídeos por palabra clave o consultar estadísticas de un canal.
- OAuth 2.0: hace falta cuando la petición toca datos privados o escribe algo, como subir un vídeo, valorar o gestionar suscripciones.
Una aclaración que evita confusiones: en este artículo, «YouTube API» significa siempre YouTube Data API v3. La API, el MCP y las plantillas de Octoparse son productos distintos y no comparten cuota ni método de acceso.
¿Qué puedes hacer con YouTube API?
YouTube API da acceso a seis recursos que cubren casi todo lo que necesitas: búsqueda, vídeos, canales, listas, comentarios y subtítulos. Con ellos puedes leer datos públicos y, con permiso del usuario, gestionar su cuenta. La analítica avanzada queda fuera: el tiempo de visualización y los ingresos viven en YouTube Analytics API.
| Recurso | Para qué sirve | Datos habituales |
|---|---|---|
search | Buscar vídeos, canales o listas por palabra clave | ID del recurso, título, canal, fecha |
videos | Detalle y estadísticas de un vídeo | Visualizaciones, duración, definición, etiquetas |
channels | Datos del canal | Suscriptores, vídeos totales, descripción |
playlistItems | Vídeos dentro de una lista | Orden, posición, ID del vídeo |
commentThreads | Comentarios públicos de un vídeo | Texto, autor, fecha, respuestas |
captions | Subtítulos disponibles | Idioma, formato, estado |
Dos límites estructurales aparecen en cuanto empiezas: search no devuelve las estadísticas del vídeo, y hay campos que la API dejó de exponer con los años.
Si lo que buscas es el texto hablado, el recurso captions resuelve la parte de la API, y el flujo completo está en esta guía sobre transcripción de vídeos de YouTube.
Cómo buscar vídeos y obtener sus datos
Buscar vídeos con YouTube API se hace en dos llamadas: search.list devuelve los identificadores de los vídeos que coinciden con la palabra clave y videos.list completa cada uno con sus estadísticas. Entre medias hay que paginar y deduplicar. Son cinco pasos, y el cuarto es el que casi todo el mundo pasa por alto.
- Crea un proyecto en Google Cloud y habilita YouTube Data API v3.
- Genera una clave de API en Credenciales y restríngela por IP o por referente.
- Llama a
search.listcon tu palabra clave. Devuelve IDs y un fragmento de datos, no el vídeo completo. - Pide el detalle con
videos.listusando los IDs, porque las estadísticas viven ahí. - Pagina con
nextPageTokeny deduplica por ID antes de exportar.
Un ejemplo mínimo de los pasos 3 y 4:
El mismo flujo con la librería oficial de Python:
search.list acepta hasta 50 resultados por página y cada página cuenta como una llamada nueva. videos.list admite hasta 50 identificadores por petición, así que el detalle también se pide en tandas. Si necesitas 500 vídeos, son diez peticiones de búsqueda más las de detalle, y la cuota lo nota.
¿Qué límites tiene YouTube API?
La cuota es el límite que más condiciona el trabajo, pero no el único. Antes de escribir una línea de código conviene saber qué campos ya no existen, qué permisos hacen falta y cuánto cuesta cada búsqueda en unidades. La asignación por defecto de un proyecto nuevo son 10.000 unidades diarias, con un límite adicional de 100 llamadas a search.list, y cada método tiene su coste según la calculadora de cuotas de Google: search.list cuesta 100 unidades por llamada y videos.list, 1. Eso deja unas 100 búsquedas al día antes de agotar la cuota gratuita.
El resto de límites se reparte así:
- Alcance de búsqueda: los resultados dependen de la región, el idioma y la personalización, y no siempre son exhaustivos.
- Campos que ya no existen: el recuento de «no me gusta» dejó de ser público en 2021 y ningún método lo devuelve. Los suscriptores de los canales grandes salen redondeados, y las impresiones o el tiempo de visualización viven en YouTube Analytics API, no en
videos. - Permisos: una clave de API solo cubre datos públicos. Para leer la cuenta del usuario o escribir en ella hace falta OAuth 2.0 con un scope concreto (
youtube.readonlypara lectura,youtube.uploadpara subir) y el consentimiento explícito de esa persona. Mientras la app sigue en modo de prueba, el token de actualización caduca a los siete días, así que una integración interna deja de funcionar cada semana hasta que se publica la app. - Sin archivos: la API no devuelve el archivo de vídeo. Descargarlo no está permitido por los términos de las APIs de YouTube.
- Subtítulos: solo aparecen si el vídeo los tiene, y descargarlos requiere autorización sobre el vídeo.
Cuando trabajas con lo que muestra la página en lugar de con la API, el formato y el volumen se comportan de otra manera. Lo veremos con números en la sección de la plantilla.
¿Cuándo puede ayudarte Octoparse como alternativa a YouTube API?
Octoparse no sustituye a YouTube API. Sirve cuando el problema no es el dato, sino el coste de obtenerlo: mantener código, ampliar cuota o reconstruir una extracción cada vez que cambia el formato de la respuesta.
La plantilla https://www.octoparse.es/template/youtube-video-list-scraper recoge 10 campos de los resultados de búsqueda (título, enlace, canal, descripción, visualizaciones, fecha de publicación e imagen) a partir de una o varias palabras clave. Se ejecuta en la nube o en local, y no tiene cargos adicionales por uso.
Antes de descartar una palabra clave conviene mirar qué devuelve de verdad. Esta es la ejecución que hicimos con la plantilla en la nube, con la palabra clave recetas fáciles y 5 filas de resultado:
| Campo | Ejemplo de la ejecución | Cómo llega |
|---|---|---|
Video_Title | «Espaguetis con la salsa más fácil y rica DEL MUNDO» | texto, con saltos de línea al inicio |
Video_Link | youtube.com/watch?v=ui2EBEi1omM | URL completa |
Channel_Name | «¡Que Viva La Cocina!» | texto |
Channel_Link | youtube.com/@QueVivaLaCocina | URL completa |
Total_Views | 16M | texto abreviado, no entero |
Publish_Date | 10y ago | fecha relativa, no ISO |
Description | «Spaghetti con queso. Espagueti de Pasta rica y sencilla» | texto |
Image_Url | i.ytimg.com/vi/ui2EBEi1omM/hq720.jpg | URL de la miniatura |
Keyword | recetas fáciles | eco del término de entrada |
Image_Url_Saved_To | vacío | ruta local, solo en ejecución de escritorio |

El formato importa tanto como el dato: las visualizaciones llegan como «16M» y la fecha como «10y ago», así que hay que normalizar esas dos columnas antes de sumar o de filtrar por fecha.
Las otras dos plantillas de la familia cubren lo que esta no da. El https://www.octoparse.es/template/youtube-details-comments-scraper-free sirve para auditar un vídeo concreto: devuelve el rendimiento del vídeo (View, Thumbs_up) junto a sus comentarios y la fecha de cada uno, 12 campos en total. El https://www.octoparse.es/template/youtube-comments-replies-scraper sirve para analizar la conversación completa de hasta 500 vídeos por ejecución: devuelve 13 campos por comentario, con la relación comentario-respuesta intacta (reply_content, reply_user, reply_count), y se ejecuta solo en la nube.
Para el resto del flujo, Octoparse cubre las piezas que la API no toca: el Asistente de IA crea la tarea describiendo en lenguaje natural qué datos necesitas, la nube ejecuta sin depender de tu equipo, las ejecuciones se pueden programar y los resultados se exportan a Excel, CSV o JSON. Si trabajas desde un cliente de IA, el MCP de Octoparse permite lanzar plantillas desde el chat, y la API abierta y la CLI sirven para integrarlo en un pipeline.
¿API, Octoparse o las dos?
La regla es sencilla: si necesitas datos oficiales, tipos numéricos limpios o permisos de cuenta, usa la API; si el problema es el volumen o mantener código, usa una plantilla; si necesitas las dos cosas a la vez, combínalas.
| Situación | Qué conviene |
|---|---|
| Necesitas datos privados, subir contenido o gestionar una cuenta | YouTube API con OAuth |
| Superas las 10.000 unidades diarias con búsquedas | Plantilla en la nube o solicitud de ampliación de cuota |
| Quieres un dato puntual sin escribir código | Plantilla o Asistente de IA |
| El análisis necesita tipos numéricos limpios | API, o normalizar la salida de la plantilla |
| Necesitas cobertura amplia y datos oficiales a la vez | Combina: API para estadísticas, plantilla para volumen |
Si tu caso está en la segunda fila, la decisión práctica es probar el mismo conjunto de palabras clave con la plantilla y comparar cobertura y coste antes de tocar la cuota. La prueba se hace en minutos.
Preguntas frecuentes
¿Cómo consigo una API key de YouTube?
Entra en Google Cloud Console, crea un proyecto, habilita YouTube Data API v3 y genera una clave en Credenciales. Restringe la clave por IP o por referente para que no la use nadie más. No hace falta tarjeta ni cuenta de pago para empezar.
¿Cuánta cuota consume buscar vídeos con la API de YouTube?
Cada llamada a search.list consume 100 unidades y videos.list, 1. Con la cuota gratuita de 10.000 unidades diarias salen unas 100 búsquedas al día. Cada página cuenta como una llamada nueva, así que el número real baja en cuanto pides más de 50 resultados.
¿Se pueden descargar vídeos con YouTube API?
No. La API devuelve metadatos, no el archivo de vídeo, y los términos de servicio de las APIs de YouTube no permiten descargar contenido. Para trabajar con el contenido de un vídeo, lo que sí puedes obtener son sus subtítulos cuando existen y tienes autorización.
¿Se pueden extraer los comentarios de un vídeo?
Sí, con commentThreads.list, que devuelve los comentarios públicos de un vídeo con hasta 100 comentarios por página. Las respuestas a cada comentario se piden aparte, con comments.list. Como en el resto de métodos, cada página consume cuota y los comentarios ocultos o eliminados no aparecen.
¿YouTube API es gratis?
Sí, dentro de la cuota diaria. Google no cobra por llamada: si necesitas más volumen, se solicita una ampliación mediante el formulario de auditoría de cuota. Para uso intensivo y sostenido, la vía habitual es repartir el trabajo o combinar la API con extracción de páginas.
¿Puedo obtener datos de YouTube sin usar la API?
Sí. Puedes extraer datos visibles de páginas públicas de búsqueda con una plantilla o con el Asistente de IA, siempre respetando los términos de YouTube y los límites de cada sitio. Esta vía no da acceso a datos privados ni a acciones de cuenta.
Conclusión
YouTube API es la vía correcta cuando necesitas datos oficiales, tipos limpios o permisos de cuenta, y su límite real es la cuota, no la documentación. Cuando el volumen pesa más que la oficialidad, una plantilla resuelve la misma búsqueda en minutos y sin código, a cambio de devolver texto y depender de la página.
La forma más rápida de saber en qué lado estás es ejecutar las mismas cinco palabras clave por las dos vías y comparar filas, campos y tiempo.
Convertir datos de sitios web en Excel, CSV, Google Sheets y base de datos directamente.
Scrapear datos fácilmente con funciones de Auto-Detectar, sin codificación.
Plantillas de crawler preestablecidas para sitios web populares para obtener datos en clics.
Nunca se bloquee con proxies IP y API avanzada.
Servicio en la Nube para programar la recopilación de datos en cualquier momento que desee.



