Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Contagem de seguidores e informação de perfil do TikTok através da API

A API for Business da TikTok devolve o número de seguidores de uma conta como followers_count a partir de GET /business/get/, juntamente com username, display_name, profile_image, bio_description, is_verified, following_count, total_likes e videos_count, cada um dependente de um âmbito como user.info.stats. A /v2/user/info/ da Display API devolve a mesma contagem como follower_count, para um utilizador que autorizou a aplicação.

A easyCoexistence lê o perfil e a contagem de seguidores de uma conta TikTok com get_social_insights a partir do Claude, do ChatGPT ou do seu próprio código: indique campos como followers_count, total_likes ou videos_count, com datas para as linhas diárias, e a ferramenta devolve os números da TikTok tal como estão.

user.info.stats

Âmbito de followers_count, following_count, total_likes e videos_count no topo de /business/get/.

Real time

Como a TikTok atualiza followers_count e os campos de perfil, enquanto as métricas diárias costumam chegar 24 a 48 horas depois.

follower_count

O nome da contagem na /v2/user/info/ da Display API, sob o seu próprio âmbito user.info.stats.

60 days

Período máximo de consulta retroativa para o followers_count diário e as outras métricas diárias em /business/get/.

2 fields

O que /business/get/ devolve quando o pedido não indica campos: display_name e profile_image.

Que campos de perfil devolve /business/get/?

Os indicados em fields, uma lista JSON na query string, cada um desbloqueado por um âmbito que o titular da conta concedeu ao autorizar a aplicação. Um pedido que não indique campos recebe apenas display_name e profile_image, e a TikTok atualiza em tempo real os campos de perfil e de contagem abaixo:

usernameThe handle; user.info.username
display_nameThe nickname; user.info.basic
profile_imageA temporary photo URL, expiring at its x-expires time; user.info.basic
bio_descriptionThe bio, or an empty string; user.info.profile
profile_deep_linkA link to the profile page; user.info.profile
is_verifiedWhether TikTok gave the account a verified badge; user.info.profile
followers_countFollowers now, user.info.stats; per day in metrics, user.insights
following_countAccounts it follows; user.info.stats
total_likesLikes on its videos, all time; user.info.stats
videos_countPublic videos posted, all time; user.info.stats
is_business_accountA Verified Business Account or not; user.account.type
has_advanced_accessAdvanced Access or not; user.account.type

Como se pede a contagem de seguidores?

Com um GET a /business/get/, o token da conta no cabeçalho Access-Token, o seu business_id, que é o open_id obtido na troca do token, e os campos pretendidos. As contagens atuais estão no topo de data, e os valores de cada dia em metrics:

Follower count and profile, trimmed from TikTok's example response
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "display_name": "<DISPLAY_NAME>",
    "followers_count": 13,
    "following_count": 2,
    "is_verified": false,
    "metrics": [
      { "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
    ]
  }
}

Como se acompanham os seguidores dia a dia?

Ao indicar followers_count em fields, a TikTok devolve-o duas vezes: o total acumulado no topo de data, sob user.info.stats, e o total de cada dia dentro de metrics, sob user.insights. start_date e end_date, em UTC, escolhem os dias, até 60 dias atrás; sem eles, a TikTok devolve os 7 dias até ao dia anterior ao pedido. Três campos diários mostram o movimento por trás do total, para contas com Advanced Access ou uma Verified Business Account:

  • daily_new_followers: os seguidores ganhos nesse dia.
  • daily_lost_followers: os seguidores perdidos nesse dia.
  • daily_total_followers: o crescimento líquido do dia, ganhos menos perdas.

O que devolve a Display API?

O mesmo tipo de perfil para um utilizador que autorizou uma aplicação do TikTok for Developers, a partir de GET https://open.tiktokapis.com/v2/user/info/ com os campos listados num parâmetro fields. Os seus nomes e âmbitos diferem dos da API for Business, e o seu objeto user não tem histórico diário:

API for Business: /business/get/Display API: /v2/user/info/
Followersfollowers_countfollower_count
Followingfollowing_countfollowing_count
Likestotal_likeslikes_count
Videosvideos_countvideo_count
Count scopeuser.info.statsuser.info.stats
Username scopeuser.info.usernameuser.info.profile
Photoprofile_imageavatar_url, avatar_url_100, avatar_large_url
Daily historyUp to 60 days in metricsNot in the user object

É possível ler a contagem de seguidores de outra conta?

Não com estes dois endpoints. /business/get/ responde pelo business_id de uma conta que autorizou a aplicação, e /v2/user/info/ pelo utilizador cujo token faz o pedido. A Research API da TikTok tem um endpoint /v2/research/user/info/ que recebe um username e devolve follower_count, following_count, likes_count e video_count, mas apenas para investigadores aprovados pela TikTok.

Como é que a easyCoexistence lê o perfil?

Com get_social_insights sobre a conta, sem object_id: os nomes em metrics passam a ser os campos de /business/get/, start_date e end_date em params escolhem os dias, e o resultado são os dados da TikTok tal como chegam. Uma lista metrics vazia pede o username, o nome de exibição, a foto, as contagens de seguidores, seguidos, gostos e vídeos, os dois indicadores ao nível da conta e as visualizações diárias de vídeo, as visitas ao perfil e os novos seguidores. list_social_accounts mostra também o username e o nome de exibição guardados quando a conta foi ligada.

Follower counts by day through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
  "params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}

Erros comuns

  • Pedir followers_count sem user.info.stats no token. A TikTok devolve cada campo apenas quando o titular concedeu o respetivo âmbito, por isso o titular tem de voltar a autorizar a aplicação.
  • Guardar profile_image para usar mais tarde. É um URL temporário cuja validade está no parâmetro x-expires, por isso obtenha um novo quando for preciso.
  • Ler follower_count em /business/get/. Esse é o nome da Display API; a API for Business chama-lhe followers_count.
  • Contar com seguidores novos e perdidos numa conta pessoal. A TikTok devolve esses campos diários apenas para contas com Advanced Access ou Verified Business Accounts.
Fazer isto com a EasyCoexistence

US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

A API do TikTok mostra a evolução de seguidores ao longo do tempo?

Sim, até 60 dias: followers_count de cada dia em metrics, mais os seguidores novos, perdidos e líquidos diários em contas com Advanced Access ou Verified Business Accounts.

Que âmbito precisa a contagem de seguidores do TikTok?

user.info.stats, nas duas APIs: desbloqueia followers_count em /business/get/ e follower_count na /v2/user/info/ da Display API.

Uma conta pessoal do TikTok devolve a contagem de seguidores?

Sim. followers_count depende do âmbito, não do tipo de conta; só alguns campos diários exigem Advanced Access ou uma Verified Business Account.

Com que frequência se atualiza a contagem de seguidores do TikTok?

A TikTok marca followers_count de topo como tempo real, enquanto as linhas diárias em metrics costumam chegar 24 a 48 horas depois, em UTC.

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