EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

60 days

Maior período retroativo para as métricas diárias de uma conta; sem datas, a API retorna os últimos 7 dias.

24 to 48 h

Atraso usual até que as contagens diárias e por publicação, como curtidas, visualizações e compartilhamentos, estejam disponíveis.

365 days

Tempo após a publicação em que os dados de uma publicação deixam de ser atualizados.

100

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_followers e engaged_audience: diárias, para contas com Advanced Access ou Verified Business Accounts.
  • audience_ages, audience_genders, audience_countries e audience_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.
Fazendo isso com o EasyCoexistence

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