Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

API de analytics do TikTok: métricas da conta e dos vídeos

A API for Business do TikTok devolve as métricas de uma conta por dia, como seguidores, visualizações de vídeos, visualizações do perfil, gostos, comentários e partilhas, até aos últimos 60 dias, e os totais acumulados de cada vídeo, como visualizações, gostos, comentários e partilhas. A maioria dos números chega com 24 a 48 horas de atraso, e tudo depende de o TikTok Analytics estar ativado na aplicação.

O easyCoexistence lê as métricas do TikTok com get_social_insights a partir do Claude, do ChatGPT ou do seu próprio código: os seguidores, as visualizações e os gostos da conta por dia, ou as visualizações, gostos, comentários e partilhas de um vídeo.

60 days

Período mais longo para as métricas diárias de uma conta; sem datas, a API devolve os últimos 7 dias.

24 to 48 h

Atraso habitual até estarem disponíveis as contagens diárias e por publicação, como gostos, visualizações e partilhas.

365 days

Tempo após a publicação ao fim do qual os dados de uma publicação deixam de ser atualizados.

100

Seguidores que uma conta precisa de ter para o TikTok devolver a repartição por idade, género e localização dos seus seguidores.

Que métricas da conta existem?

GET /business/get/ devolve o perfil da conta e, para as datas pedidas, uma lista de métricas com uma entrada por dia, em UTC:

  • followers_count: o total atual e o total de cada dia.
  • video_views, profile_views, likes, comments e shares: contagens diárias de todos os vídeos da conta.
  • unique_video_views, daily_new_followers, daily_lost_followers e engaged_audience: diárias, para contas com Advanced Access ou contas empresariais verificadas.
  • audience_ages, audience_genders, audience_countries e audience_cities: repartições dos seguidores, para contas com pelo menos 100 seguidores.

Que métricas de vídeo existem?

GET /business/video/list/ devolve as publicações públicas da conta com contagens acumuladas, sem o limite de 60 dias: video_views, likes, comments, shares e favorites, além do alcance, do tempo total e médio de visualização, da taxa de visualização completa, dos novos seguidores e das origens de tráfego. Devolve até 20 publicações por página, e filters.video_ids escolhe publicações específicas.

Quão atualizados estão os dados?

Campos do perfil, como o nome de utilizador e o total atual de seguidores, são atualizados em tempo real. As métricas diárias da conta e as contagens das publicações, como visualizações, gostos, comentários e partilhas, costumam atrasar 24 a 48 horas, em UTC, e os dados de uma publicação deixam de ser atualizados 365 dias após a sua publicação. O alcance, o tempo de visualização e as origens de tráfego podem estar em falta num vídeo que ninguém visualizou, gostou, comentou ou partilhou durante mais de 7 dias.

Porque podem faltar métricas?

A API devolve o que o TikTok Analytics tem. O titular da conta tem de publicar pelo menos um vídeo e ativar o Analytics na aplicação do TikTok, e os dados anteriores à ativação não estão disponíveis. Algumas métricas exigem mais: o público alcançado e os seguidores novos ou perdidos só existem para contas com Advanced Access ou contas empresariais verificadas, e a repartição dos seguidores começa nos 100 seguidores.

Porque é que as contagens podem diferir da aplicação do TikTok?

Por causa do que incluem. video_views conta visualizações orgânicas e pagas em conjunto, e shares conta tanto as partilhas fora do TikTok como os envios a amigos dentro da aplicação, por isso pode ser superior à contagem de partilhas no site do TikTok. O número de gostos de um dia não desconta os gostos retirados depois.

Como é que o easyCoexistence as lê?

Com get_social_insights. Para a conta, peça métricas como followers_count, video_views e likes, com start_date e end_date, e devolve as linhas diárias do TikTok. Para um vídeo, indique o seu item_id como object_id e devolve visualizações, gostos, comentários e partilhas, e pesquisa entre as 20 publicações mais recentes da conta; para uma mais antiga, o seu próprio código chama business/video/list/ com filters.video_ids, usando o token de get_social_credentials.

Erros comuns

  • Tomar os números de ontem como definitivos. As métricas diárias podem atrasar 24 a 48 horas, por isso os dias recentes podem ainda estar a ser preenchidos.
  • Pedir mais de 60 dias de métricas da conta. O período termina aí, por isso guarde os números se precisar de um histórico mais longo.
  • Procurar um vídeo antigo por object_id. get_social_insights pesquisa as 20 mais recentes; para publicações mais antigas, filtre por video_ids a partir do seu próprio código, com o token de get_social_credentials.
  • Comparar as partilhas da API com a contagem do site. A API também conta os envios a amigos dentro do TikTok, por isso o seu número é mais alto.
Fazer isto com a EasyCoexistence

Para outros campos de métricas do TikTok, get_social_credentials dá ao seu próprio código o token da conta. De US$ 9 a US$ 0,75 por ligação por mês, com o preço a descer à medida que adiciona ligações, e os primeiros 3 dias grátis.

Perguntas frequentes

A API do TikTok mostra quantos seguidores uma conta perdeu?

Sim, em daily_lost_followers, ao lado de daily_new_followers, para contas com Advanced Access ou contas empresariais verificadas.

Até que data recuam as métricas de conta do TikTok?

60 dias. Sem datas, a API devolve os 7 dias até ao dia anterior ao pedido, em UTC.

Quando deixam de ser atualizados os dados de um vídeo do TikTok?

365 dias após a publicação do vídeo. Até lá, as suas contagens acumuladas continuam a ser atualizadas, normalmente com 24 a 48 horas de atraso.

As visualizações de vídeos do TikTok incluem visualizações pagas?

Sim. O video_views que o TikTok devolve abrange a atividade orgânica e paga em conjunto.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em