InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram-volgersdemografie via de API

Het account insights-endpoint van Instagram geeft volgersdemografie terug met metric=follower_demographics, period=lifetime, metric_type=total_value, een timeframe en een uitsplitsing naar leeftijd, geslacht, stad of land. engaged_audience_demographics doet hetzelfde voor accounts die met de content in interactie zijn getreden. Meta geeft alleen de top 45 waarden terug; voor volgersdemografie zijn 100 volgers nodig, en voor betrokken-publiekdata 100 interacties binnen het tijdsbestek.

easyCoexistence leest volger- en betrokken-publiekdemografie van Instagram uit met get_social_insights, zodat Claude, ChatGPT of je eigen code kan vragen welke landen, steden of leeftijdsgroepen het account volgen, en de cijfers van Meta voor het gekoppelde account terugkrijgen.

100 followers

Onder dit aantal geeft follower_demographics niet terug voor het account.

100 engagements

Nodig binnen het tijdsbestek voordat engaged_audience_demographics wordt teruggegeven.

Top 45

Demografische metrieken geven alleen de top 45 waarden terug, dus kleinere steden en landen vallen weg.

19 Aug 2024

Sinds last_14_days, last_30_days, last_90_days en prev_month in elke versie zijn gestopt met werken voor engaged_audience_demographics.

48 hours

Hoe lang de data achter accountmetrieken vertraagd kan zijn.

Welke demografische metrieken zijn er?

Twee in de referentie voor accountinzichten van Meta, beide uit te lezen met GET /<IG_ID>/insights, en twee oudere sets die oude code nog opvraagt:

  • follower_demographics: de demografische kenmerken van de volgers van het account.
  • engaged_audience_demographics: hetzelfde voor het betrokken publiek, de accounts die met de content van het account in interactie zijn getreden.
  • Beide: period lifetime, metric_type total_value, een timeframe en een uitsplitsing naar leeftijd, stad, land of geslacht.
  • audience_gender_age, audience_locale, audience_country en audience_city: uitgefaseerd op 11 december 2023.
  • reached_audience_demographics: genoemd in Meta's changelog van 2024, maar ontbreekt in de huidige metrieken-tabel.

Hoe vraag je volgersdemografie op?

Met de parameter metric, period=lifetime, metric_type=total_value, een timeframe en één uitsplitsing. timeframe vervangt since en until, die demografische metrieken niet ondersteunen, en het is verplicht. Met Instagram Login heeft het token instagram_business_basic en instagram_business_manage_insights nodig, en de aanroep gaat naar 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>

Hoe ziet het antwoord eruit?

De aantallen staan in total_value.breakdowns. dimension_keys benoemt het gevraagde tijdsbestek en de uitsplitsing, en elk resultaat koppelt dimension_values, het tijdsbestek en één waarde van de uitsplitsing aan een aantal. Het voorbeeld van Meta voor het betrokken publiek per land geeft landen terug als tweeletterige codes, zoals US en 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"
    }
  ]
}

Welke tijdsbestekken werken?

De referentie van Meta noemt last_14_days, last_30_days, last_90_days, prev_month, this_month en this_week voor beide metrieken en, voor het betrokken publiek, beschrijft this_month als de laatste 30 dagen en this_week als de laatste 7. Voor engaged_audience_demographics zijn de eerste vier vanaf v20.0 en in elke versie op 19 augustus 2024 gestopt met werken, dus gebruik this_week of this_month; die changelog-vermelding noemt follower_demographics niet.

Welke drempels en limieten gelden?

De referentie voor accountinzichten van Meta stelt deze regels voor demografische metrieken:

  • follower_demographics wordt niet teruggegeven voor een account met minder dan 100 volgers.
  • engaged_audience_demographics wordt niet teruggegeven bij minder dan 100 interacties binnen het tijdsbestek.
  • Alleen de top 45 waarden komen terug, dus kleinere steden en landen vallen weg.
  • Alleen kijkers met demografische data worden geteld, dus de waarden kunnen optellen tot minder dan het aantal volgers.
  • Ontbrekende data geeft een lege set terug, niet 0, en data kan tot 48 uur achterlopen.
  • Een uitsplitsing die een gevraagde metriek niet ondersteunt, laat de hele aanroep mislukken met de melding An unknown error has occurred.

Werken demografische gegevens met Instagram Login?

Ja. Meta heeft account- en media-inzichten op 21 januari 2025 opengesteld voor apps met Instagram Login, en de referentie voor accountinzichten noemt Instagram Login met de permissies instagram_business_basic en instagram_business_manage_insights en graph.instagram.com als host. Het account moet een zakelijk of creator-account zijn, zoals het Instagram Platform van Meta vereist.

Hoe leest get_social_insights demografische gegevens?

Met metrics ingesteld op follower_demographics of engaged_audience_demographics, period ingesteld op lifetime en params met timeframe, breakdown en metric_type. easyCoexistence roept GET /<IG_ID>/insights aan voor het gekoppelde account met het token ervan en geeft het antwoord van Meta terug, zodat Claude of ChatGPT kan zeggen welke landen, steden of leeftijdsgroepen het account volgen.

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"
  }
}

Veelgemaakte fouten

  • since en until doorgeven. Demografische metrieken ondersteunen ze niet: timeframe bepaalt het bereik, en het is verplicht.
  • last_30_days of last_90_days gebruiken voor het betrokken publiek. Die tijdsbestekken zijn op 19 augustus 2024 in elke versie gestopt met werken voor engaged_audience_demographics.
  • Een uitsplitsing optellen om het aantal volgers te krijgen. Alleen kijkers met demografische data worden geteld en alleen de top 45 waarden komen terug, dus de som komt tekort.
  • Data verwachten van een klein account. Volgersdemografie heeft 100 volgers nodig, en het betrokken publiek 100 interacties binnen het tijdsbestek.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Hoeveel volgers heeft een Instagram-account nodig voor demografie?

100. Daaronder geeft Meta follower_demographics niet terug; engaged_audience_demographics heeft 100 interacties binnen het tijdsbestek nodig.

Waarom geeft Instagram maar 45 steden terug?

De demografische metrieken van Meta geven alleen de top 45 waarden terug, dus kleinere steden en landen vallen weg.

Wat verving audience_gender_age in de Instagram API?

follower_demographics, met een uitsplitsing naar leeftijd, geslacht, stad of land. Meta heeft audience_gender_age, audience_locale, audience_country en audience_city op 11 december 2023 uitgefaseerd.

Kan ik since en until gebruiken met follower_demographics?

Nee. Demografische metrieken ondersteunen since en until niet; de parameter timeframe bepaalt het bereik in plaats daarvan, en die is verplicht.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op