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"
]
}
]
}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:viewsMarcaçõ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:likesMarcaçõ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:dislikesComentá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:commentsCompartilhamentos (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:sharesInscritos 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_gainedInscritos 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_lostInscritos 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_variationMinutos 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_watchedPorcentagem 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_percentageMédia de duração de uma visualização
Quantidade média, em segundos, do tempo de reprodução dos vídeos.
youtube:average_view_durationVisualizações do canal
Número total de visualizações no canal durante o tempo.
youtube:view_countInscriçõ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_countVídeos do canal
Número total de vídeo no canal ao longo do tempo.
youtube:video_countVídeos do canal no período
Total de vídeos publicados durante o período analisado.
youtube:video_count_in_periodImpressõ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:impressionsReceita 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_revenueCTR (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:ctrVisualizações (Shorts)
Número total de vezes que seus shorts foram visualizados durante o período de análise.
youtube:views_shortsTempo total assistido (Shorts)
Tempo total (em horas) que os usuários assistiram seus shorts durante o período analisado.
youtube:estimated_minutes_watched_shortsMarcaçõ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_shortsMarcaçõ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_shortsComentários (Shorts)
O número de vezes que os usuários comentaram em um short durante o período analisado.
youtube:comments_shortsCompartilhamentos (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_shortsInscritos 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_shortsInscritos 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_shortsVisualizações (Live)
Número total de vezes que sua live foi visualizada durante o período analisado.
youtube:views_live_streamTempo 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_streamMarcaçõ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_streamMarcaçõ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_streamComentá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_streamCompartilhamentos (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_streamInscritos 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_streamInscritos 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_streamVisualizaçõ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_demandTempo 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_demandMarcaçõ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_demandMarcaçõ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_demandComentá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_demandCompartilhamentos (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_demandInscritos 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_demandInscritos 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_dayTempo 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_genderPorcentagem 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_genderPorcentagem 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_videosTodos os vídeos do período
Vídeos postados durante o período analisado.
youtube:all_videosVisualizaçõ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_countriesShorts 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.
