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.
Período mais longo para as métricas diárias de uma conta; sem datas, a API devolve os últimos 7 dias.
Atraso habitual até estarem disponíveis as contagens diárias e por publicação, como gostos, visualizações e partilhas.
Tempo após a publicação ao fim do qual os dados de uma publicação deixam de ser atualizados.
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_followerseengaged_audience: diárias, para contas com Advanced Access ou contas empresariais verificadas.audience_ages,audience_genders,audience_countrieseaudience_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.
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