Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Démographie des abonnés Instagram via l'API

L'endpoint insights du compte Instagram renvoie les données démographiques des abonnés avec metric=follower_demographics, period=lifetime, metric_type=total_value, un timeframe et une ventilation par âge, genre, ville ou pays. engaged_audience_demographics fait de même pour les comptes qui ont interagi avec le contenu. Meta ne renvoie que les 45 valeurs les plus élevées ; les données sur les abonnés exigent 100 abonnés, et les données sur l'audience engagée 100 interactions sur la période.

easyCoexistence lit les données démographiques des abonnés et de l'audience engagée d'Instagram avec get_social_insights : Claude, ChatGPT ou votre propre code peuvent demander quels pays, villes ou tranches d'âge suivent le compte et obtenir les chiffres de Meta pour le compte connecté.

100 followers

En dessous de ce seuil, follower_demographics n'est pas renvoyé pour le compte.

100 engagements

100 interactions requises sur la période avant que engaged_audience_demographics ne soit renvoyé.

Top 45

Les métriques démographiques ne renvoient que les 45 valeurs les plus élevées, donc les villes et pays plus petits disparaissent.

19 Aug 2024

Date à laquelle last_14_days, last_30_days, last_90_days et prev_month ont cessé de fonctionner pour engaged_audience_demographics, dans toutes les versions.

48 hours

Délai pouvant affecter les données sous-jacentes aux métriques du compte.

Quelles sont les métriques démographiques disponibles ?

Deux dans la référence insights de Meta, toutes deux lues avec GET /<IG_ID>/insights, et deux anciens ensembles que l'ancien code demande encore :

  • follower_demographics : les caractéristiques démographiques des abonnés du compte.
  • engaged_audience_demographics : la même chose pour l'audience engagée, c'est-à-dire les comptes qui ont interagi avec son contenu.
  • Les deux : period lifetime, metric_type total_value, un timeframe et une ventilation par âge, genre, ville ou pays.
  • audience_gender_age, audience_locale, audience_country et audience_city : retirées le 11 décembre 2023.
  • reached_audience_demographics : citée dans le changelog 2024 de Meta, mais absente de son tableau actuel des métriques.

Comment demander les données démographiques des abonnés ?

Avec la métrique, period=lifetime, metric_type=total_value, un timeframe et une seule ventilation. timeframe remplace since et until, non pris en charge par les métriques démographiques, et il est obligatoire. Avec Instagram Login, le token doit disposer de instagram_business_basic et instagram_business_manage_insights, et l'appel passe par graph.instagram.com :

Followers by country, this month
GET https://graph.instagram.com/<IG_ID>/insights
  ?metric=follower_demographics
  &period=lifetime
  &timeframe=this_month
  &breakdown=country
  &metric_type=total_value
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

À quoi ressemble la réponse ?

Les compteurs figurent dans total_value.breakdowns. dimension_keys indique la période et la ventilation demandées, et chaque résultat associe dimension_values, la période et une valeur de la ventilation, avec un compteur. L'exemple de Meta, pour l'audience engagée par pays, renvoie les pays sous forme de codes à deux lettres comme US et ES :

The response shape, broken down by country
{
  "data": [
    {
      "name": "follower_demographics",
      "period": "lifetime",
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "total_value": {
        "breakdowns": [
          {
            "dimension_keys": ["timeframe", "country"],
            "results": [
              { "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
              { "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
            ]
          }
        ]
      },
      "id": "<IG_ID>/insights/follower_demographics/lifetime"
    }
  ]
}

Quelles périodes fonctionnent ?

La référence de Meta liste last_14_days, last_30_days, last_90_days, prev_month, this_month et this_week pour les deux métriques et, pour l'audience engagée, décrit this_month comme les 30 derniers jours et this_week comme les 7 derniers. Pour engaged_audience_demographics, les quatre premières ont cessé de fonctionner à partir de v20.0 et dans toutes les versions le 19 août 2024 : utilisez donc this_week ou this_month. Cette entrée du changelog ne mentionne pas follower_demographics.

Quels seuils et limites s'appliquent ?

La référence insights du compte de Meta fixe ces règles pour les métriques démographiques :

  • follower_demographics n'est pas renvoyé pour un compte ayant moins de 100 abonnés.
  • engaged_audience_demographics n'est pas renvoyé avec moins de 100 interactions sur la période.
  • Seules les 45 valeurs les plus élevées sont renvoyées, donc les villes et pays plus petits disparaissent.
  • Seuls les comptes ayant des données démographiques sont comptés, donc la somme des valeurs peut être inférieure au nombre d'abonnés.
  • Les données manquantes renvoient un ensemble vide, et non 0, et les données peuvent accuser un retard allant jusqu'à 48 heures.
  • Une ventilation non prise en charge par une métrique demandée fait échouer tout l'appel avec le message « An unknown error has occurred. »

Les données démographiques fonctionnent-elles avec Instagram Login ?

Oui. Meta a ouvert les insights du compte et des médias aux applications Instagram Login le 21 janvier 2025, et sa référence insights du compte liste Instagram Login avec les permissions instagram_business_basic et instagram_business_manage_insights, et graph.instagram.com comme hôte. Le compte doit être un compte entreprise ou créateur, comme l'exige la plateforme Instagram de Meta.

Comment get_social_insights lit-il les données démographiques ?

Avec metrics réglé sur follower_demographics ou engaged_audience_demographics, period réglé sur lifetime, et params contenant timeframe, breakdown et metric_type. easyCoexistence appelle GET /<IG_ID>/insights pour le compte connecté avec son token et renvoie la réponse de Meta, afin que Claude ou ChatGPT puisse dire quels pays, villes ou tranches d'âge suivent le compte.

get_social_insights arguments for followers by age
{
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["follower_demographics"],
  "period": "lifetime",
  "params": {
    "timeframe": "this_month",
    "breakdown": "age",
    "metric_type": "total_value"
  }
}

Erreurs courantes

  • Passer since et until. Les métriques démographiques ne les prennent pas en charge : timeframe définit la plage, et il est obligatoire.
  • Utiliser last_30_days ou last_90_days pour l'audience engagée. Ces périodes ont cessé de fonctionner pour engaged_audience_demographics dans toutes les versions le 19 août 2024.
  • Additionner une ventilation pour obtenir le nombre d'abonnés. Seuls les comptes ayant des données démographiques sont comptés et seules les 45 valeurs les plus élevées reviennent, donc la somme est inférieure.
  • Attendre des données d'un petit compte. Les données démographiques des abonnés exigent 100 abonnés, et l'audience engagée 100 interactions sur la période.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours gratuits.

Questions fréquemment posées

Combien d'abonnés un compte Instagram doit-il avoir pour obtenir les données démographiques ?

100. En dessous, Meta ne renvoie pas follower_demographics ; engaged_audience_demographics exige 100 interactions sur la période.

Pourquoi Instagram ne renvoie-t-il que 45 villes ?

Les métriques démographiques de Meta ne renvoient que les 45 valeurs les plus élevées, donc les villes et pays plus petits sont exclus.

Qu'est-ce qui a remplacé audience_gender_age dans l'API Instagram ?

follower_demographics, avec une ventilation par âge, genre, ville ou pays. Meta a retiré audience_gender_age, audience_locale, audience_country et audience_city le 11 décembre 2023.

Puis-je utiliser since et until avec follower_demographics ?

Non. Les métriques démographiques ne prennent pas en charge since et until ; le paramètre timeframe définit la plage à la place, et il est obligatoire.

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