EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

user.info.stats

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

Real time

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.

follower_count

O nome que a Display API dá à contagem em /v2/user/info/, sob o escopo próprio user.info.stats.

60 days

Janela máxima de consulta para o followers_count diário e as outras métricas diárias em /business/get/.

2 fields

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:

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 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:

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 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/
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

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.

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. 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.
Fazendo isso com o EasyCoexistence

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