Contagem de seguidores do TikTok e informações de perfil pela API
A API for Business do TikTok devolve a contagem de seguidores de uma conta como followers_count em GET /business/get/, junto com username, display_name, profile_image, bio_description, is_verified, following_count, total_likes e videos_count, cada um exigindo um escopo como user.info.stats. O /v2/user/info/ da Display API devolve a mesma contagem como follower_count para um usuário que autorizou o app.
O 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: informe campos como followers_count, total_likes ou videos_count, com datas para linhas diárias, e ele devolve os números do TikTok como estão.
Escopo de followers_count, following_count, total_likes e videos_count no topo de /business/get/.
Como o TikTok atualiza followers_count e os campos do perfil, enquanto as métricas diárias costumam chegar de 24 a 48 horas depois.
O nome que a Display API dá à contagem em /v2/user/info/, sob o escopo próprio user.info.stats.
Janela máxima de consulta para o followers_count diário e as outras métricas diárias em /business/get/.
O que /business/get/ devolve quando a requisição não nomeia campos: display_name e profile_image.
Quais campos do perfil o /business/get/ devolve?
Os citados em fields, um array JSON na query string, cada um liberado por um escopo que o titular da conta concedeu ao autorizar o app. Uma requisição que não nomeia campos recebe apenas display_name e profile_image, e o TikTok atualiza os campos de perfil e de contagem abaixo em tempo real:
Como solicitar a contagem de seguidores?
Com um GET para /business/get/, o token da conta no cabeçalho Access-Token, o business_id, que é o open_id da troca de token, e os campos desejados. As contagens atuais ficam no topo de data, e os números 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 acompanhar os seguidores dia a dia?
Nomeie followers_count em fields e o TikTok o devolve 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, definem os dias, até 60 dias atrás; sem eles, o TikTok devolve os 7 dias anteriores ao dia da requisição. Três campos diários mostram a movimentação por trás do total, para contas com Advanced Access ou Verified Business Account:
daily_new_followers: os seguidores ganhos naquele dia.daily_lost_followers: os seguidores perdidos naquele dia.daily_total_followers: o crescimento líquido do dia, ganhos menos perdas.
O que a Display API devolve?
O mesmo tipo de perfil para um usuário que autorizou um app do TikTok for Developers, a partir de GET https://open.tiktokapis.com/v2/user/info/ com os campos listados em um parâmetro fields. Seus nomes e escopos diferem da API for Business, e seu objeto user não traz 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 |
Dá para ler a contagem de seguidores de outra conta?
Não com esses dois endpoints. /business/get/ responde pelo business_id de uma conta que autorizou o app, e /v2/user/info/ pelo usuário cujo token faz a chamada. A Research API do TikTok tem um endpoint /v2/research/user/info/ que recebe um username e devolve follower_count, following_count, likes_count e video_count, mas só para pesquisadores aprovados pelo TikTok:
Como o easyCoexistence lê o perfil?
Com get_social_insights na conta, sem object_id: os nomes em metrics viram os campos de /business/get/, start_date e end_date em params escolhem os dias, e o resultado são os dados do TikTok como vêm. Uma lista metrics vazia pede o username, o nome de exibição, a foto, as contagens de seguidores, seguindo, curtidas e vídeos, as duas flags de nível de conta e, por dia, as visualizações de vídeos, as visualizações de perfil e os novos seguidores. list_social_accounts também mostra o username e o nome de exibição salvos quando a conta foi conectada.
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. O TikTok devolve cada campo só quando o titular concedeu seu escopo, então ele precisa autorizar o app de novo.
- Guardar profile_image para depois. É uma URL temporária cuja validade está no parâmetro x-expires, então busque uma nova quando precisar.
- Ler follower_count em /business/get/. Esse é o nome da Display API; a API for Business chama o campo de followers_count.
- Esperar novos e perdidos seguidores em uma conta pessoal. O TikTok devolve esses campos diários para contas com Advanced Access ou Verified Business Account.
De US$ 9 a US$ 0.75 por conexão por mês, com a queda conforme você adiciona conexões, com os primeiros 3 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 o crescimento de seguidores ao longo do tempo?
Sim, por até 60 dias: followers_count de cada dia em metrics, além dos novos, perdidos e líquidos diários em Advanced Access ou Verified Business Account.
Qual escopo a contagem de seguidores do TikTok exige?
user.info.stats, nas duas APIs: ele libera 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 escopo, não do nível da conta; só alguns campos diários exigem Advanced Access ou Verified Business Account.
Com que frequência a contagem de seguidores do TikTok é atualizada?
O TikTok marca o followers_count do topo como tempo real, enquanto as linhas diárias em metrics costumam chegar de 24 a 48 horas depois, em UTC.
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