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"
      ]
    }
  ]
}
Ejemplo: "Visualizaciones (Total)" en octubre, comparado con septiembre.

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:views
  • 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.

    youtube:likes
  • No 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:dislikes
  • Comentarios (Total)

    Número total de comentarios recibidos en los videos, shorts o transmisiones en vivo del canal durante el período del informe.

    youtube:comments
  • Comparticiones (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:shares
  • Suscriptores 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_gained
  • Suscriptores 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_lost
  • Suscriptores 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_variation
  • Minutos 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_watched
  • Porcentaje promedio de visualización

    Porcentaje promedio de reproducción de los videos vistos en el canal, durante el periodo analizado.

    youtube:average_view_percentage
  • Tiempo promedio de una visualización

    Cantidad promedia, en segundos, del tiempo de reproducción de los vídeos.

    youtube:average_view_duration
  • Visualizaciones del canal

    Número total de visualizaciones en el canal durante el tiempo.

    youtube:view_count
  • Suscripciones 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_count
  • Videos del canal

    Número total del videos en el canal a lo largo de lo tiempo.

    youtube:video_count
  • Vídeos del canal en el período

    Total de vídeos publicados durante el período analizado.

    youtube:video_count_in_period
  • Impresiones 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:impressions
  • Ingresos 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_revenue
  • CTR

    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:ctr
  • Visualizaciones (Shorts)

    Número total de veces que tus shorts fueron vistos durante el período de revisión.

    youtube:views_shorts
  • Tiempo total de visualización (Shorts)

    Tiempo total (en horas) que los usuarios vieron tus shorts durante el período analizado.

    youtube:estimated_minutes_watched_shorts
  • Me 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_shorts
  • No 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_shorts
  • Comentarios (Shorts)

    El número de veces que los usuarios comentaron en un short durante el período analizado.

    youtube:comments_shorts
  • Compartidos (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_shorts
  • Suscriptores 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_shorts
  • Suscriptores 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_shorts
  • Visualizaciones (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_stream
  • Tiempo 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_stream
  • Me 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_stream
  • No 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_stream
  • Comentarios (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_stream
  • Compartidos (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_stream
  • Suscriptores 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_stream
  • Suscriptores 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_stream
  • Visualizaciones (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_demand
  • Tiempo 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_demand
  • Me 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_demand
  • No 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_demand
  • Comentarios (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_demand
  • Comparticiones (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_demand
  • Suscriptores 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_demand
  • Suscriptores 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_day
  • Tiempo 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_gender
  • Porcentaje 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_gender
  • Porcentaje 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_videos
  • Todos los videos del período.

    Vídeos publicados durante el período analizado.

    youtube:all_videos
  • Visualizaciones 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_countries
  • Shorts 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.