API de analytics do TikTok: insights da conta e métricas de vídeo
A API for Business do TikTok retorna as métricas diárias de uma conta, como seguidores, visualizações de vídeo, visualizações de perfil, curtidas, comentários e compartilhamentos, de até os últimos 60 dias, e os totais acumulados de cada vídeo, como visualizações, curtidas, comentários e compartilhamentos. A maioria dos números chega com 24 a 48 horas de atraso e depende de o TikTok Analytics estar ativado no app.
O easyCoexistence lê os insights 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 as curtidas da conta por dia, ou as visualizações, curtidas, comentários e compartilhamentos de um vídeo.
Maior período retroativo para as métricas diárias de uma conta; sem datas, a API retorna os últimos 7 dias.
Atraso usual até que as contagens diárias e por publicação, como curtidas, visualizações e compartilhamentos, estejam disponíveis.
Tempo após a publicação em que os dados de uma publicação deixam de ser atualizados.
Seguidores que uma conta precisa ter para que o TikTok retorne a divisão por idade, gênero e localização dos seguidores.
Quais são as métricas da conta?
GET /business/get/ retorna o perfil da conta e, para as datas solicitadas, 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 somadas em todos os vídeos da conta.unique_video_views,daily_new_followers,daily_lost_followerseengaged_audience: diárias, para contas com Advanced Access ou Verified Business Accounts.audience_ages,audience_genders,audience_countrieseaudience_cities: divisões dos seguidores, para contas com pelo menos 100 seguidores.
Quais são as métricas de vídeo?
GET /business/video/list/ retorna as publicações públicas da conta com contagens acumuladas, sem se limitar ao período de 60 dias: video_views, likes, comments, shares e favorites, além de alcance, tempo total e médio de exibição, taxa de exibição completa, novos seguidores e fontes de tráfego. Retorna até 20 publicações por página, e filters.video_ids seleciona publicações específicas.
Quão atualizados são os dados?
Campos do perfil, como o nome de usuário e o total atual de seguidores, são em tempo real. As métricas diárias da conta e as contagens das publicações, como visualizações, curtidas, comentários e compartilhamentos, costumam atrasar de 24 a 48 horas, em UTC, e os dados de uma publicação deixam de ser atualizados 365 dias após a publicação. Alcance, tempo de exibição e fontes de tráfego podem estar ausentes em um vídeo que ninguém visualizou, curtiu, comentou ou compartilhou há mais de 7 dias.
Por que métricas podem estar ausentes?
A API retorna o que o TikTok Analytics tem. O dono da conta precisa publicar pelo menos um vídeo e ativar o Analytics no app do TikTok, e os dados anteriores à ativação do Analytics não ficam disponíveis. Algumas métricas exigem mais: o público alcançado e os novos ou perdidos seguidores só aparecem para contas com Advanced Access ou Verified Business Accounts, e as divisões de seguidores começam com 100 seguidores.
Por que as contagens podem diferir do app do TikTok?
Por causa do que cada uma inclui. video_views soma visualizações orgânicas e pagas, e shares conta tanto os compartilhamentos para fora do TikTok quanto os envios para amigos dentro do app, por isso pode ser maior que a contagem de compartilhamentos no site do TikTok. O número de curtidas de um dia não desconta as curtidas removidas depois.
Como o easyCoexistence lê essas métricas?
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 a ferramenta retorna as linhas diárias do TikTok. Para um vídeo, informe o seu item_id como object_id e ela retorna visualizações, curtidas, comentários e compartilhamentos, procurando entre os 20 vídeos mais recentes da conta; para um mais antigo, o seu próprio código chama business/video/list/ com filters.video_ids, usando o token de get_social_credentials.
Erros comuns
- Tratar os números de ontem como definitivos. As métricas diárias podem atrasar de 24 a 48 horas, então os dias recentes ainda podem estar sendo preenchidos.
- Pedir mais de 60 dias de métricas da conta. O período retroativo para aí, então armazene os números se precisar de um histórico maior.
- Buscar um vídeo antigo pelo object_id. get_social_insights procura nos 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 os compartilhamentos da API com a contagem do site. A API também soma os envios para amigos dentro do TikTok, então o número dela é maior.
Para outros campos de insights do TikTok, get_social_credentials entrega ao seu próprio código o token da conta. De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A API do TikTok mostra quantos seguidores uma conta perdeu?
Sim, como daily_lost_followers ao lado de daily_new_followers, para contas com Advanced Access ou Verified Business Accounts.
Até onde vão os insights de conta do TikTok?
60 dias. Sem datas, a API retorna os 7 dias até o dia anterior à requisição, em UTC.
Quando os dados de um vídeo do TikTok deixam de ser atualizados?
365 dias após a publicação do vídeo. Até lá, suas contagens acumuladas continuam sendo atualizadas, geralmente com atraso de 24 a 48 horas.
As visualizações de vídeo do TikTok incluem visualizações pagas?
Sim. O campo video_views retornado pelo TikTok soma a atividade orgânica e a paga.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em