Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Nombre d'abonnés Instagram et champs de profil via l'API

L'API Instagram renvoie le nombre d'abonnés d'un compte professionnel dans le champ followers_count, à côté de follows_count, media_count, username, name, profile_picture_url et account_type. Avec Instagram Login, GET /me avec ces champs les lit sur graph.instagram.com grâce à instagram_business_basic. La référence IG User de Meta liste aussi biography et website, et l'évolution des abonnés dans le temps provient des insights.

easyCoexistence connecte un compte Instagram Business ou Creator avec Instagram Login, afin que Claude, ChatGPT ou votre propre code lise sa portée, ses vues et ses abonnements via get_social_insights, sur l'API officielle de Meta ; les nombres d'abonnés et de publications du profil n'ont pas d'outil.

followers_count

Nombre total de comptes Instagram qui suivent le compte, un champ que la référence IG User de Meta marque comme public.

9 fields

Les champs User listés par le guide Instagram Login de Meta, de id et user_id à followers_count et media_count.

Media_Creator

La valeur account_type d'un compte créateur ; un compte professionnel renvoie Business.

100 followers

En dessous de ce seuil, Meta ne renvoie ni follows_and_unfollows ni follower_count dans les insights du compte.

Quels champs de profil Instagram Login renvoie-t-il ?

Les neuf champs que le guide Instagram Login de Meta liste pour l'objet User, lus avec GET /me et une liste fields. Le token a besoin de instagram_business_basic, et user_id, et non id, est l'IG_ID du compte pour les appels qui suivent :

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

Comment lire le nombre d'abonnés ?

Demandez followers_count sur /me, que la référence de Meta traduit par le nœud User du compte lié au token. La valeur est un total cumulé au moment de l'appel, donc un dashboard qui la représente sur un graphique doit enregistrer lui-même une valeur chaque jour.

Counts and username with Instagram Login
GET https://graph.instagram.com/me
  ?fields=user_id,username,followers_count,follows_count,media_count
  &access_token=<ACCESS_TOKEN>

{
  "user_id": "<IG_ID>",
  "username": "<USERNAME>",
  "followers_count": 1840,
  "follows_count": 312,
  "media_count": 97
}

Quels autres champs la référence liste-t-elle ?

La référence IG User de Meta, rédigée pour les trois configurations à la fois, ajoute des champs à ceux des neuf du guide Instagram Login. Elle en marque quelques-uns comme disponibles pour les comptes rattachés à une Page, et ne précise pas de connexion pour les autres :

  • biography : le texte de la bio du profil, marqué public.
  • website : l'URL du site web du compte, marquée publique.
  • has_profile_pic : indique si le compte a une photo de profil.
  • is_published et legacy_instagram_user_id : pour les comptes rattachés à une Page, le second étant l'ID créé pour les endpoints de la Marketing API jusqu'à la v21.0.
  • shopping_product_tag_eligibility : indique si le compte a configuré une boutique Instagram.

Comment suivre la croissance des abonnés ?

Par les insights du compte plutôt que par le profil. GET /<IG_ID>/insights avec metric=follows_and_unfollows, metric_type=total_value et la ventilation follow_type renvoie les comptes qui ont commencé à suivre le compte et ceux qui se sont désabonnés ou ont quitté Instagram. Avec Instagram Login, le token doit aussi avoir instagram_business_manage_insights. Meta ne renvoie cette donnée, ainsi que follower_count, que pour les comptes ayant au moins 100 abonnés.

L'API peut-elle lister qui sont les abonnés ?

Non. La référence IG User de Meta donne followers_count et follows_count sous forme de nombres et ne liste aucune arête qui renvoie les comptes eux-mêmes. Elle propose en revanche follower_demographics dans les insights du compte, ventilées par âge, ville, pays ou genre, pour les comptes ayant au moins 100 abonnés.

Peut-on lire le nombre d'abonnés d'un autre compte ?

Avec Business Discovery, que Meta propose avec Facebook Login et Unified Login : GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} les renvoie pour un autre compte professionnel ou créateur. Il lit les champs publics de l'autre compte, que la référence IG User marque : biography, followers_count, id, media_count, username et website, entre autres.

Comment lire le profil via easyCoexistence ?

list_social_accounts renvoie pour chaque compte connecté son username, son name et son external_id, qui est son IG_ID. Les compteurs du profil, followers_count, follows_count et media_count, n'ont pas d'outil, et les tokens Instagram ne sont pas remis ; get_social_insights lit plutôt l'évolution de l'audience, avec follows_and_unfollows, reach et views.

Erreurs courantes

  • Attendre une liste d'abonnés. Meta renvoie des totaux et, à partir de 100 abonnés, des données démographiques, mais pas les comptes eux-mêmes.
  • Tracer la croissance à partir de followers_count seul. C'est un total cumulé ; follows_and_unfollows dans les insights distingue les nouveaux abonnements des désabonnements.
  • Vérifier account_type pour CREATOR. Un compte créateur renvoie Media_Creator, et un compte professionnel Business.
  • Utiliser l'id de /me comme ID du compte. Le guide de Meta lie user_id, et non id, aux notifications webhook et à des chemins comme /<IG_ID>/media.
Faire cela avec EasyCoexistence

À partir de US$ 9, jusqu'à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

L'API Instagram renvoie-t-elle la bio du profil ?

Oui, sous le nom biography, que la référence IG User de Meta marque comme publique. Les neuf champs User du guide Instagram Login l'omettent ; demandez-le donc sur GET /me et vérifiez la réponse sur votre configuration.

Pourquoi follows_and_unfollows ne renvoie-t-il rien ?

Meta ne le renvoie pas pour les comptes ayant moins de 100 abonnés.

Puis-je obtenir le nombre d'abonnés d'un compte personnel ?

Non. L'API de Meta sert les comptes professionnels, et Business Discovery ne lit que les comptes professionnels et créateurs.

Quelle permission faut-il pour le nombre d'abonnés ?

Avec Instagram Login, instagram_business_basic. Les insights d'abonnés ajoutent instagram_business_manage_insights.

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