logo
ES

¿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.

6 min

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.

RecursoPara qué sirveDatos habituales
searchBuscar vídeos, canales o listas por palabra claveID del recurso, título, canal, fecha
videosDetalle y estadísticas de un vídeoVisualizaciones, duración, definición, etiquetas
channelsDatos del canalSuscriptores, vídeos totales, descripción
playlistItemsVídeos dentro de una listaOrden, posición, ID del vídeo
commentThreadsComentarios públicos de un vídeoTexto, autor, fecha, respuestas
captionsSubtítulos disponiblesIdioma, 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.

  1. Crea un proyecto en Google Cloud y habilita YouTube Data API v3.
  2. Genera una clave de API en Credenciales y restríngela por IP o por referente.
  3. Llama a search.list con tu palabra clave. Devuelve IDs y un fragmento de datos, no el vídeo completo.
  4. Pide el detalle con videos.list usando los IDs, porque las estadísticas viven ahí.
  5. Pagina con nextPageToken y deduplica por ID antes de exportar.

Un ejemplo mínimo de los pasos 3 y 4:

GET https://www.googleapis.com/youtube/v3/search?part=snippet&q=recetas+veganas&type=video&maxResults=50&key=TU_CLAVE
GET https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=ID1,ID2&key=TU_CLAVE

El mismo flujo con la librería oficial de Python:

from googleapiclient.discovery import build

youtube = build("youtube", "v3", developerKey="TU_CLAVE")
busqueda = youtube.search().list(q="recetas veganas", part="id,snippet", type="video", maxResults=50).execute()
ids = [item["id"]["videoId"] for item in busqueda["items"]]
detalle = youtube.videos().list(part="snippet,statistics", id=",".join(ids)).execute()

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.readonly para lectura, youtube.upload para 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:

CampoEjemplo de la ejecuciónCó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_Linkyoutube.com/watch?v=ui2EBEi1omMURL completa
Channel_Name«¡Que Viva La Cocina!»texto
Channel_Linkyoutube.com/@QueVivaLaCocinaURL completa
Total_Views16Mtexto abreviado, no entero
Publish_Date10y agofecha relativa, no ISO
Description«Spaghetti con queso. Espagueti de Pasta rica y sencilla»texto
Image_Urli.ytimg.com/vi/ui2EBEi1omM/hq720.jpgURL de la miniatura
Keywordrecetas fácileseco del término de entrada
Image_Url_Saved_Tovacíoruta local, solo en ejecución de escritorio
Ejemplo de los datos extraídos con la plantilla de Octoparse
Datos extraídos de YouTube con la plantilla de Octoparse

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ónQué conviene
Necesitas datos privados, subir contenido o gestionar una cuentaYouTube API con OAuth
Superas las 10.000 unidades diarias con búsquedasPlantilla en la nube o solicitud de ampliación de cuota
Quieres un dato puntual sin escribir códigoPlantilla o Asistente de IA
El análisis necesita tipos numéricos limpiosAPI, o normalizar la salida de la plantilla
Necesitas cobertura amplia y datos oficiales a la vezCombina: 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.

avatar
Inés Bennet
Experto en marketing y analítica de datos, con mucha investigación en HTML y XML, y profundos conocimientos en programación de bases de datos y recopilación de datos.
¿Qué datos quieres extraer hoy?
Describe lo que necesitas. Asistente de IA crea el scraper.
No se requiere tarjeta de crédito

Posts populares

Explorar temas

Empieza a utilizar Octoparse enseguida

Descargar

Artículos relacionados