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.
Âmbito de followers_count, following_count, total_likes e videos_count no topo de /business/get/.
Como a TikTok atualiza followers_count e os campos de perfil, enquanto as métricas diárias costumam chegar 24 a 48 horas depois.
O nome da contagem na /v2/user/info/ da Display API, sob o seu próprio âmbito user.info.stats.
Período máximo de consulta retroativa para o followers_count diário e as outras métricas diárias em /business/get/.
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:
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:
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/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not 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.
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.
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