Nombre d'abonnés TikTok et infos de profil via l'API
L'API for Business de TikTok renvoie le nombre d'abonnés d'un compte sous la forme followers_count, depuis GET /business/get/, à côté de username, display_name, profile_image, bio_description, is_verified, following_count, total_likes et videos_count. Chaque champ requiert un scope, comme user.info.stats. L'endpoint /v2/user/info/ de la Display API renvoie le même nombre sous le nom follower_count, pour un utilisateur ayant autorisé l'application.
easyCoexistence lit le profil et le nombre d'abonnés d'un compte TikTok avec get_social_insights, depuis Claude, ChatGPT ou votre propre code : nommez des champs comme followers_count, total_likes ou videos_count, avec des dates pour les lignes quotidiennes, et il renvoie les chiffres de TikTok tels quels.
Scope de followers_count, following_count, total_likes et videos_count en haut de /business/get/.
Mise à jour de followers_count et des champs de profil par TikTok, tandis que les métriques quotidiennes arrivent généralement 24 à 48 heures plus tard.
Nom du compteur dans /v2/user/info/ de la Display API, sous son propre scope user.info.stats.
Historique le plus long pour followers_count quotidien et les autres métriques quotidiennes de /business/get/.
Ce que renvoie /business/get/ lorsqu'une requête ne nomme aucun champ : display_name et profile_image.
Quels champs de profil renvoie /business/get/ ?
Ceux nommés dans fields, un tableau JSON dans la chaîne de requête, chacun débloqué par un scope accordé par le titulaire du compte lors de l'autorisation de l'application. Une requête qui ne nomme aucun champ n'obtient que display_name et profile_image, et TikTok met à jour en temps réel les champs de profil et de compteur ci-dessous :
Comment demander le nombre d'abonnés ?
Avec un GET vers /business/get/, le token du compte dans l'en-tête Access-Token, son business_id, soit l'open_id issu de l'échange de token, plus les champs souhaités. Les compteurs actuels figurent en haut de data, et les chiffres de chaque jour dans 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 }
]
}
}Comment suivre les abonnés jour par jour ?
Nommez followers_count dans fields et TikTok le renvoie deux fois : le total depuis l'origine en haut de data, sous user.info.stats, et le total de chaque jour dans metrics, sous user.insights. start_date et end_date, en UTC, sélectionnent les jours, jusqu'à 60 jours en arrière ; sans eux, TikTok renvoie les 7 jours se terminant la veille de la requête. Trois champs quotidiens montrent les mouvements derrière le total, pour les comptes ayant Advanced Access ou un Verified Business Account :
daily_new_followers: les abonnés gagnés ce jour-là.daily_lost_followers: les abonnés perdus ce jour-là.daily_total_followers: la croissance nette du jour, gains moins pertes.
Que renvoie la Display API ?
Le même type de profil pour un utilisateur ayant autorisé une application TikTok for Developers, depuis GET https://open.tiktokapis.com/v2/user/info/ avec les champs listés dans un paramètre fields. Ses noms et scopes diffèrent de ceux de l'API for Business, et son objet user ne contient aucun historique quotidien :
| 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 |
Peut-on lire le nombre d'abonnés d'un autre compte ?
Pas avec ces deux endpoints. /business/get/ répond pour le business_id d'un compte ayant autorisé l'application, et /v2/user/info/ pour l'utilisateur dont le token effectue l'appel. L'API Research de TikTok dispose d'un endpoint /v2/research/user/info/ qui prend un nom d'utilisateur et renvoie follower_count, following_count, likes_count et video_count, mais uniquement pour les chercheurs approuvés par TikTok.
Comment easyCoexistence lit-il le profil ?
Avec get_social_insights sur le compte, sans object_id : les noms de metrics deviennent les champs de /business/get/, start_date et end_date dans params sélectionnent les jours, et le résultat est repris tel quel depuis TikTok. Une liste metrics vide demande le nom d'utilisateur, le nom affiché, la photo, les compteurs d'abonnés, d'abonnements, de likes et de vidéos, les deux indicateurs au niveau du compte, et les vues quotidiennes de vidéos, les vues de profil et les nouveaux abonnés. list_social_accounts affiche aussi le nom d'utilisateur et le nom affiché enregistrés lors de la connexion du compte.
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" }
}Erreurs courantes
- Demander followers_count sans user.info.stats sur le token. TikTok ne renvoie chaque champ que si le titulaire a accordé son scope, donc le titulaire doit autoriser à nouveau l'application.
- Conserver profile_image pour plus tard. Il s'agit d'une URL temporaire dont l'expiration figure dans son paramètre x-expires : demandez-en une nouvelle au besoin.
- Lire follower_count depuis /business/get/. C'est le nom de la Display API ; l'API for Business l'appelle followers_count.
- Supposer que les abonnés gagnés et perdus sont disponibles sur un compte personnel. TikTok renvoie ces champs quotidiens pour Advanced Access ou les Verified Business Accounts.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
L'API TikTok peut-elle montrer la croissance des abonnés dans le temps ?
Oui, sur 60 jours au maximum : followers_count pour chaque jour dans metrics, plus les abonnés quotidiens nouveaux, perdus et nets avec Advanced Access ou un Verified Business Account.
Quel scope faut-il pour le nombre d'abonnés TikTok ?
user.info.stats, sur les deux API : il débloque followers_count dans /business/get/ et follower_count dans /v2/user/info/ de la Display API.
Un compte TikTok personnel renvoie-t-il son nombre d'abonnés ?
Oui. followers_count dépend du scope, non du niveau du compte ; seuls certains champs quotidiens exigent Advanced Access ou un Verified Business Account.
À quelle fréquence le nombre d'abonnés TikTok est-il mis à jour ?
TikTok indique que followers_count au niveau supérieur est en temps réel, tandis que les lignes quotidiennes de metrics arrivent généralement avec 24 à 48 heures de retard, en UTC.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le