Metrics
Métricas de YouTube con la API
Tu cliente conecta su cuenta de YouTube y tu producto consulta 51 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:views",
"component": "number_v1",
"metrics": [
"views"
]
}
]
}Más ejemplos de llamadas a YouTube
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Suscriptores ganados por día
La diferencia en el total de suscriptos, resulta de la sustracción del número de suscriptores nuevos para el período analizado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:subscribers_by_day",
"component": "chart_v1",
"metrics": [
"subscribersGained"
],
"dimensions": [
"day"
]
}
]
}Tabla
Videos destacados
Videos que tuvieron mayor impacto en tu audencia, en el periodo analizado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:engaging_videos",
"component": "datatable_v1",
"metrics": [
"views",
"likes",
"subscribersGained",
"publishedAt"
],
"dimensions": [
"video"
]
}
]
}Número
Me gusta (Total)
Número total de 'me gusta' recibidos en los videos, shorts o transmisiones en vivo del canal durante el período del informe.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:likes",
"component": "number_v1",
"metrics": [
"likes"
]
}
]
}Números
42 métricas
Visualizaciones (Total)
Número total de veces que los videos, shorts o transmisiones en vivo del canal fueron vistos durante el período del informe.
youtube:viewsMe gusta (Total)
Número total de 'me gusta' recibidos en los videos, shorts o transmisiones en vivo del canal durante el período del informe.
youtube:likesNo me gusta (Total)
Número total de 'no me gusta' recibidos en los videos, shorts o transmisiones en vivo del canal durante el período del informe.
youtube:dislikesComentarios (Total)
Número total de comentarios recibidos en los videos, shorts o transmisiones en vivo del canal durante el período del informe.
youtube:commentsComparticiones (Total)
Número total de veces que los videos, shorts o transmisiones en vivo del canal fueron compartidos por los espectadores durante el período del informe.
youtube:sharesSuscriptores ganados (por día)
Número total de nuevos suscriptores adquiridos a partir de los videos, shorts o transmisiones en vivo del canal durante el período del informe.
youtube:subscribers_gainedSuscriptores perdidos (Total)
Número total de suscriptores que dejaron de seguir el canal, contabilizados a partir de los videos, shorts o transmisiones en vivo del canal durante el período del informe.
youtube:subscribers_lostSuscriptores en el período
Variación neta de suscriptores. La diferencia entre el número de nuevos suscriptores y el número de suscriptores perdidos en el período analizado.
youtube:subscribers_variationMinutos estimados vistos (por día)
Tiempo total (en horas) que los espectadores vieron los videos, shorts o transmisiones en vivo del canal.
youtube:estimated_minutes_watchedPorcentaje promedio de visualización
Porcentaje promedio de reproducción de los videos vistos en el canal, durante el periodo analizado.
youtube:average_view_percentageTiempo promedio de una visualización
Cantidad promedia, en segundos, del tiempo de reproducción de los vídeos.
youtube:average_view_durationVisualizaciones del canal
Número total de visualizaciones en el canal durante el tiempo.
youtube:view_countSuscripciones del canal
Número total de suscriptos en el canal a lo largo del tiempo. Youtube puede tardar tiempo para actualizar esta métrica o, incluso, para redondear el número así que es posible que la cifra no sea exacta.
youtube:subscriber_countVideos del canal
Número total del videos en el canal a lo largo de lo tiempo.
youtube:video_countVídeos del canal en el período
Total de vídeos publicados durante el período analizado.
youtube:video_count_in_periodImpresiones de anuncios
Número de impresiones de anuncios mostrados en los videos de tu canal. Disponible solo para canales monetizados (Programa de Socios de YouTube). No corresponde a las impresiones de miniaturas de YouTube Studio.
youtube:impressionsIngresos estimados
Ingresos netos totales estimados de Google, incluidas todas las fuentes de publicidad y otras fuentes no publicitarias, para el período y la región seleccionados. Esta estimación de ingresos está sujeta a ajustes a fin de mes y no incluye publicidad vendida y servida por socios.
youtube:estimed_revenueCTR
Visualizaciones divididas por las impresiones de anuncios. Disponible solo para canales monetizados (Programa de Socios de YouTube). No corresponde al porcentaje de clics de las miniaturas de YouTube Studio.
youtube:ctrVisualizaciones (Shorts)
Número total de veces que tus shorts fueron vistos durante el período de revisión.
youtube:views_shortsTiempo total de visualización (Shorts)
Tiempo total (en horas) que los usuarios vieron tus shorts durante el período analizado.
youtube:estimated_minutes_watched_shortsMe gusta (Shorts)
El número de veces que los usuarios indicaron que les gustó un short dándole una calificación positiva durante el período analizado.
youtube:likes_shortsNo me gusta (Shorts)
El número de veces que los usuarios indicaron que no les gustó un short dándole una calificación negativa durante el período analizado.
youtube:dislikes_shortsComentarios (Shorts)
El número de veces que los usuarios comentaron en un short durante el período analizado.
youtube:comments_shortsCompartidos (Shorts)
El número de veces que los usuarios compartieron un short a través del botón 'Compartir' durante el período analizado.
youtube:shares_shortsSuscriptores ganados (Shorts)
El número de veces que los usuarios se suscribieron al canal después de ver un short durante el período analizado.
youtube:subscribers_gained_shortsSuscriptores perdidos (Shorts)
El número de veces que los usuarios se desuscribieron del canal después de ver un short durante el período analizado.
youtube:subscribers_lost_shortsVisualizaciones (En Vivo)
Número total de veces que se vio tu transmisión en vivo durante el período de revisión.
youtube:views_live_streamTiempo de visualización (Live)
Tiempo total (en horas) que los usuarios vieron tu transmisión en vivo durante el período analizado.
youtube:estimated_minutes_watched_live_streamMe gusta (Live)
El número de veces que los usuarios indicaron que les gustó una transmisión en vivo, dando una calificación positiva durante el período analizado.
youtube:likes_live_streamNo me gusta (Live)
El número de veces que los usuarios indicaron que no les gustó una transmisión en vivo, dando una calificación negativa durante el período analizado.
youtube:dislikes_live_streamComentarios (En vivo)
El número de veces que los usuarios comentaron en una transmisión en vivo durante el período analizado.
youtube:comments_live_streamCompartidos (En Vivo)
El número de veces que los usuarios compartieron una transmisión en vivo a través del botón 'Compartir' durante el período analizado.
youtube:shares_live_streamSuscriptores ganados (En Vivo)
El número de veces que los usuarios se suscribieron al canal después de ver una transmisión en vivo durante el período analizado.
youtube:subscribers_gained_live_streamSuscriptores perdidos (En Vivo)
El número de veces que los usuarios se dieron de baja del canal después de ver una transmisión en vivo durante el período analizado.
youtube:subscribers_lost_live_streamVisualizaciones (Video)
Número de veces que se visualizó contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye visualizaciones de Shorts o transmisiones en vivo.
youtube:views_video_on_demandTiempo de visualización (Video)
Tiempo total, en horas, que los espectadores vieron contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye tiempo de visualización de Shorts o transmisiones en vivo.
youtube:estimated_minutes_watched_video_on_demandMe gusta (Video)
Número de veces que se dio "Me gusta" a contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye visualizaciones de Shorts o transmisiones en vivo.
youtube:likes_video_on_demandNo me gusta (Video)
Número de veces que se dio "No me gusta" a contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye visualizaciones de Shorts o transmisiones en vivo.
youtube:dislikes_video_on_demandComentarios (Video)
Número de veces que los usuarios comentaron en contenido de la categoría "Videos" durante el período analizado. Esta métrica no incluye comentarios en Shorts o transmisiones en vivo.
youtube:comments_video_on_demandComparticiones (Video)
Número de veces que los usuarios compartieron contenido en la categoría "Videos" usando el botón "Compartir" durante el período analizado. Esta métrica no incluye comparticiones de Shorts o transmisiones en vivo.
youtube:shares_video_on_demandSuscriptores ganados (Video)
Número total de nuevos suscriptores adquiridos a partir del contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye suscriptores ganados con Shorts o transmisiones en vivo.
youtube:subscribers_gained_video_on_demandSuscriptores perdidos (Video)
Número total de suscriptores que dejaron de seguir el canal debido al contenido en la categoría "Videos" durante el período analizado. Esta métrica no incluye suscriptores perdidos debido a Shorts o transmisiones en vivo.
youtube:subscribers_lost_video_on_demand
Gráficos
5 métricas
Suscriptores ganados por día
La diferencia en el total de suscriptos, resulta de la sustracción del número de suscriptores nuevos para el período analizado.
youtube:subscribers_by_dayTiempo de exhibición del canal.
Tiempo de visualización del canal en horas. Eso incluye videos públicos, privados, no listados y excluídos.
youtube:channel_display_time% Espectadores por Edad y Género
Ese gráfico muestra el percentaje de los espectadores que asistieron los videos del canal, agrupados por edad y género.
youtube:viewers_by_age_and_genderPorcentaje de espectadores por género
Este gráfico le permite consultar el porcentaje de visualizaciones de vídeos publicitarios, agrupados por género.
youtube:views_by_genderPorcentaje de espectadores por grupo de edad
Este gráfico le permite consultar el porcentaje de visualizaciones de vídeos publicitarios, agrupados por grupo de edad.
youtube:views_by_age
Tablas
4 métricas
Videos destacados
Videos que tuvieron mayor impacto en tu audencia, en el periodo analizado.
youtube:engaging_videosTodos los videos del período.
Vídeos publicados durante el período analizado.
youtube:all_videosVisualizaciones por país
El público de tu canal por localización geográfica. Los datos son basados en la direccion IP.
youtube:most_accessed_countriesShorts con mejor rendimiento
Rendimiento de los Shorts más vistos durante el período analizado.
youtube:performance_shorts
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
