Metrics

Métricas do YouTube pela API

Seu cliente conecta a conta do YouTube e seu produto consulta 51 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

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"
      ]
    }
  ]
}
Exemplo: "Visualizações (Total)" em outubro, comparado a setembro.

Mais exemplos de chamadas no YouTube

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Inscritos ganhos por dia

A diferença no total de inscritos, resultado da subtração do número de assinantes perdidos do número de assinantes novos para o período analisado.

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"
      ]
    }
  ]
}

Tabela

Vídeos em destaque

Vídeos que tiveram maior impacto na sua audiência, no período analisado.

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

Marcações "Gostei" (Total)

Número total de 'curtidas' recebidas nos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

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

  • Visualizações (Total)

    Número total de vezes que os vídeos, shorts ou transmissões ao vivo do canal foram visualizados durante o período do relatório.

    youtube:views
  • Marcações "Gostei" (Total)

    Número total de 'curtidas' recebidas nos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

    youtube:likes
  • Marcações "Não gostei" (Total)

    Número total de 'não curtidas' recebidas nos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

    youtube:dislikes
  • Comentários (Total)

    Número total de comentários recebidos nos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

    youtube:comments
  • Compartilhamentos (Total)

    Número total de vezes que os vídeos, shorts ou transmissões ao vivo do canal foram compartilhados pelos espectadores durante o período do relatório.

    youtube:shares
  • Inscritos ganhos (por dia)

    Número total de novos inscritos adquiridos a partir dos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

    youtube:subscribers_gained
  • Inscritos perdidos (Total)

    Número total de inscritos que deixaram de seguir o canal, contabilizados a partir dos vídeos, shorts ou transmissões ao vivo do canal durante o período do relatório.

    youtube:subscribers_lost
  • Inscritos no período

    Variação líquida dos inscritos. A diferença entre o número de novos inscritos e o número de inscritos perdidos no período analisado.

    youtube:subscribers_variation
  • Minutos estimados assistidos (por dia)

    Tempo total (em horas) que os espectadores assistiram aos vídeos, shorts ou transmissões ao vivo do canal.

    youtube:estimated_minutes_watched
  • Porcentagem média de visualização

    Porcentagem média de reprodução dos vídeos assistidos no canal, durante o período analisado.

    youtube:average_view_percentage
  • Média de duração de uma visualização

    Quantidade média, em segundos, do tempo de reprodução dos vídeos.

    youtube:average_view_duration
  • Visualizações do canal

    Número total de visualizações no canal durante o tempo.

    youtube:view_count
  • Inscrições do canal

    Número total de inscritos no canal ao longo do tempo. O Youtube pode demorar algum tempo para atualizar essa métrica ou até mesmo arrendondar esse valor, pode isso ele pode estar um pouco diferente do real.

    youtube:subscriber_count
  • Vídeos do canal

    Número total de vídeo no canal ao longo do tempo.

    youtube:video_count
  • Vídeos do canal no período

    Total de vídeos publicados durante o período analisado.

    youtube:video_count_in_period
  • Impressões de anúncios

    Número de impressões de anúncios exibidos nos vídeos do seu canal. Disponível apenas para canais monetizados (Programa de Parcerias do YouTube). Não corresponde às impressões de miniaturas do YouTube Studio.

    youtube:impressions
  • Receita estimada

    Receita líquida total estimada do Google, incluindo todas as fontes de publicidade e outras fontes não publicitárias, para o período e a região selecionados. Esta estimativa de receita está sujeita a ajustes no final do mês e não inclui publicidade vendida e exibida por parceiros.

    youtube:estimed_revenue
  • CTR (Taxa de Cliques)

    Visualizações divididas pelas impressões de anúncios. Disponível apenas para canais monetizados (Programa de Parcerias do YouTube). Não corresponde à taxa de cliques nas miniaturas do YouTube Studio.

    youtube:ctr
  • Visualizações (Shorts)

    Número total de vezes que seus shorts foram visualizados durante o período de análise.

    youtube:views_shorts
  • Tempo total assistido (Shorts)

    Tempo total (em horas) que os usuários assistiram seus shorts durante o período analisado.

    youtube:estimated_minutes_watched_shorts
  • Marcações "Gostei" (Shorts)

    O número de vezes que os usuários indicaram que gostaram de um short dando uma avaliação positiva durante o período analisado.

    youtube:likes_shorts
  • Marcações "Não gostei" (Shorts)

    O número de vezes que os usuários indicaram que não gostaram de um short dando uma avaliação negativa durante o período analisado.

    youtube:dislikes_shorts
  • Comentários (Shorts)

    O número de vezes que os usuários comentaram em um short durante o período analisado.

    youtube:comments_shorts
  • Compartilhamentos (Shorts)

    O número de vezes que os usuários compartilharam um short através do botão 'Compartilhar' durante o período analisado.

    youtube:shares_shorts
  • Inscritos ganhos (Shorts)

    O número de vezes que os usuários se inscreveram no canal após assistir a um short durante o período analisado.

    youtube:subscribers_gained_shorts
  • Inscritos perdidos (Shorts)

    O número de vezes que os usuários se desinscreveram do canal após assistir a um short durante o período analisado.

    youtube:subscribers_lost_shorts
  • Visualizações (Live)

    Número total de vezes que sua live foi visualizada durante o período analisado.

    youtube:views_live_stream
  • Tempo de exibição (Live)

    Tempo total (em horas) que os usuários assistiram à sua live durante o período analisado.

    youtube:estimated_minutes_watched_live_stream
  • Marcações "Gostei" (Live)

    O número de vezes que os usuários indicaram que gostaram de uma live, dando uma avaliação positiva durante o período analisado.

    youtube:likes_live_stream
  • Marcações "Não gostei" (Live)

    O número de vezes que os usuários indicaram que não gostaram de uma live, dando uma avaliação negativa durante o período analisado.

    youtube:dislikes_live_stream
  • Comentários (Live)

    O número de vezes que os usuários comentaram em uma transmissão ao vivo durante o período analisado.

    youtube:comments_live_stream
  • Compartilhamentos (Live)

    O número de vezes que os usuários compartilharam uma live através do botão 'Compartilhar' durante o período analisado.

    youtube:shares_live_stream
  • Inscritos ganhos (Live)

    O número de vezes que os usuários se inscreveram no canal após assistir a uma live durante o período analisado.

    youtube:subscribers_gained_live_stream
  • Inscritos perdidos (Live)

    O número de vezes que os usuários se desinscreveram do canal após assistir a uma live durante o período analisado.

    youtube:subscribers_lost_live_stream
  • Visualizações (Vídeo)

    Número de vezes que os conteúdos da categoria "Vídeos" foram visualizados durante o período analisado. Esta métrica não inclui visualizações de Shorts ou transmissões ao vivo.

    youtube:views_video_on_demand
  • Tempo de exibição (Vídeo)

    Tempo total, em horas, que os espectadores assistiram aos conteúdos da categoria "Vídeos" durante o período analisado. Esta métrica não inclui tempo de exibição de Shorts ou transmissões ao vivo.

    youtube:estimated_minutes_watched_video_on_demand
  • Marcações "Gostei" (Vídeo)

    Número de vezes que os conteúdos da categoria "Vídeos" receberam marcações "gostei" durante o período analisado. Esta métrica não inclui marcações de Shorts ou transmissões ao vivo.

    youtube:likes_video_on_demand
  • Marcações "Não gostei" (Vídeo)

    Número de vezes que os conteúdos da categoria "Vídeos" receberam marcações "não gostei" durante o período analisado. Esta métrica não inclui marcações de Shorts ou transmissões ao vivo.

    youtube:dislikes_video_on_demand
  • Comentários (Vídeo)

    Número de vezes que os usuários comentaram em conteúdos da categoria "Vídeos" durante o período analisado. Essa métrica não inclui comentários em Shorts ou transmissões ao vivo.

    youtube:comments_video_on_demand
  • Compartilhamentos (Vídeo)

    Número de vezes que os usuários compartilharam um conteúdo da categoria "Vídeos" através do botão "Compartilhar", durante o período analisado. Esta métrica não inclui compartilhamentos de Shorts ou transmissões ao vivo.

    youtube:shares_video_on_demand
  • Inscritos ganhos (Vídeo)

    Número total de novos inscritos adquiridos a partir dos conteúdos da categoria "Vídeos" durante o período analisado. Esta métrica não inclui inscritos ganhos por Shorts ou transmissões ao vivo.

    youtube:subscribers_gained_video_on_demand
  • Inscritos perdidos (Vídeo)

    Número total de inscritos que deixaram de seguir o canal a partir dos conteúdos da categoria "Vídeos", durante o período analisado. Esta métrica não inclui inscritos perdidos por Shorts ou transmissões ao vivo.

    youtube:subscribers_lost_video_on_demand

Gráficos

5 métricas

  • Inscritos ganhos por dia

    A diferença no total de inscritos, resultado da subtração do número de assinantes perdidos do número de assinantes novos para o período analisado.

    youtube:subscribers_by_day
  • Tempo de exibição do canal

    Tempo de exibição do canal em horas. Isso inclui vídeos públicos, privados, não listados e excluídos.

    youtube:channel_display_time
  • % Espectadores por Idade e Gênero

    Esse gráfico mostra a porcentagem dos espectadores que assistiram os vídeos do canal, agrupados por idade e gênero.

    youtube:viewers_by_age_and_gender
  • Porcentagem de espectadores por gênero

    Este gráfico permite verificar a porcentagem de visualizações dos vídeos de anúncio, agrupadas por gênero.

    youtube:views_by_gender
  • Porcentagem de espectadores por faixa etária

    Este gráfico permite verificar a porcentagem de visualizações dos vídeos de anúncio, agrupadas por faixa etária.

    youtube:views_by_age

Tabelas

4 métricas

  • Vídeos em destaque

    Vídeos que tiveram maior impacto na sua audiência, no período analisado.

    youtube:engaging_videos
  • Todos os vídeos do período

    Vídeos postados durante o período analisado.

    youtube:all_videos
  • Visualizações por país

    O público do seu canal por localização geográfica. Os dados são baseados no endereço IP.

    youtube:most_accessed_countries
  • Shorts de melhor desempenho

    Desempenho dos Shorts mais assistidos durante o período analisado.

    youtube:performance_shorts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.