Exportar YouTube Analytics: el CSV se corta en 500 filas

Para descargar estadísticas de YouTube en CSV, abre el informe en el Modo avanzado de Studio, ajusta la vista y elige «Exportar vista actual». La ayuda de YouTube fija en 500 filas el máximo de los informes descargados y remite a Reporting API cuando se necesitan más datos.

La elección depende del resultado que buscas. Studio basta para una vista que cabe en la descarga; YouTube Analytics API sirve para consultar un desglose preciso por páginas y convertir su respuesta a CSV; Reporting API entrega archivos CSV diarios con datos masivos de informes predefinidos. Ninguno de los tres métodos convierte automáticamente un total del canal en un historial completo por video, fecha y país: hay que elegir esas dimensiones o el tipo de informe adecuado.

Preparar la vista que descarga Studio

En YouTube Studio, entra en Analytics y abre «Modo avanzado» o «Ver más» junto al informe. Selecciona el período y el contenido que quieres medir; después ajusta el desglose, las métricas y los filtros antes de exportar. La vista puede referirse al canal, a un video, a un grupo o a una playlist, y el desglose determina qué representa cada fila.

Por ejemplo, una vista agregada del canal responde cuántas visualizaciones hubo en el período, pero no identifica el aporte de cada video. Para obtener filas por video, elige ese desglose; para estudiar la evolución diaria, añade la dimensión temporal correspondiente. Un filtro de ubicación limita los datos a la zona elegida, mientras que un desglose por ubicación separa los resultados por territorio. Son preguntas distintas y producen archivos distintos.

Guarda junto al CSV el período, las métricas, el desglose y los filtros utilizados. Esa información permite distinguir una descarga completa de una selección deliberadamente estrecha. Si repartes una extracción entre varios períodos para mantener cada archivo dentro del límite, usa intervalos que no se solapen y conserva la misma estructura de columnas.

Detectar si faltan filas

Un archivo que acaba exactamente en el máximo de filas de datos exige revisar la selección, aunque por sí solo no demuestra un corte: el informe podría contener justo ese número de registros. Cuenta las filas sin incluir el encabezado y comprueba qué dimensiones forman cada registro. Una fila por día representa un volumen muy diferente de una fila por combinación de día, video y país.

Si sospechas que faltan entradas, repite la consulta con un período más corto o con un filtro que reduzca el universo. Mantén iguales las métricas y el desglose para poder comparar las claves de las filas entre archivos. Cuando unas entradas aparecen solo en la selección reducida, la descarga inicial no cubría todo el conjunto que querías conservar.

Dividir por fechas funciona únicamente si cada partición cabe en la descarga y si la unión cubre todo el período sin duplicados. En un desglose diario, revisa las fechas extremas de cada archivo; en uno por video, compara los identificadores. Si incluso una partición pequeña alcanza el tope, conviene pasar a una API en lugar de seguir fragmentando a ciegas.

Usar Analytics API para un desglose preciso

El método reports.query de YouTube Analytics API acepta fechas, métricas, dimensiones, filtros y orden; `maxResults` y `startIndex` permiten recorrer las filas. La versión 2 devuelve JSON, de modo que, si necesitas un CSV, debes escribir sus columnas y filas en ese formato después de recibir la respuesta.

Una consulta por video puede usar `views` como métrica y `video` como dimensión. El filtro `country==IT` restringe el resultado a Italia; incluir `country` como dimensión también separa las filas por país cuando el informe admite esa combinación. Antes de automatizarla, comprueba que las métricas, dimensiones y filtros elegidos son compatibles con el informe que necesitas.

Para paginar, conserva las mismas fechas, métricas, dimensiones, filtros y orden en todas las peticiones. Solicita una página con `maxResults`, empieza con `startIndex=1` y desplaza el índice según las filas recibidas hasta que no queden resultados. Al reunirlas, utiliza `columnHeaders` para asignar los valores a las columnas y conserva los identificadores y fechas que permitan detectar repeticiones.

Este método resulta útil cuando necesitas rehacer una consulta personalizada de un período anterior o extraer un desglose que no cabe cómodamente en Studio. La disponibilidad de datos recientes y de determinadas combinaciones depende del informe: una petición válida no garantiza que todas las fechas solicitadas produzcan filas.

Crear informes diarios con Reporting API

Para una captura masiva y periódica, la guía de YouTube Reporting API describe CSV predefinidos por día: al crear un trabajo se generan informes para los 30 días anteriores y, después, para los días siguientes; los archivos históricos quedan disponibles durante 30 días desde su generación y los ordinarios durante 60 días. Crear hoy un trabajo no recupera por esta vía todo el pasado del canal.

Primero consulta los tipos de informe disponibles y crea un trabajo para el que contenga las dimensiones y métricas necesarias. Después enumera los archivos generados para ese trabajo y descarga cada uno desde su `downloadUrl`. A diferencia de `reports.query`, los datos del archivo no llegan filtrados: si solo necesitas un país o un grupo de videos, selecciona esas filas después de descargarlo.

Los archivos pueden llegar más tarde que el día medido y pueden contener solo el encabezado cuando no hubo datos. También puede publicarse una versión revisada para un período ya recibido. Guarda el tipo de informe, el identificador del trabajo, el intervalo que cubre el archivo y su fecha de generación; cuando llegue una versión posterior del mismo intervalo, sustituye la anterior para evitar duplicar registros.

Unir y validar los datos

Define la clave de las filas antes de combinar archivos: puede ser día y video, o día, video y país, según el desglose. Comprueba que cada página de Analytics API aporta claves nuevas y que los informes diarios de Reporting API cubren los períodos esperados. No interpretes como pérdida de datos un archivo diario que solo tenga encabezado si ese día no registró actividad.

Contrasta totales únicamente cuando el período, los filtros, las dimensiones y la métrica coincidan. Reporting API omite filas sin métricas y sus informes masivos no incluyen una fila de total general; además, los recursos eliminados pueden afectar la comparación entre un desglose y el total del canal. Si necesitas una cifra agregada, consúltala con una selección equivalente en Studio o Analytics API en lugar de asumir que cualquier suma de CSV representa el mismo universo.

Lee también:

• Una etiqueta de IA no desmonetiza: cuándo YouTube la aplica sola
• Automatizar YouTube sin perder ingresos: la plantilla repetida es el riesgo
• Exportar Substack no salva tus imágenes: haz dos copias antes de necesitarlas