AccediInizia la prova gratuita
easyCoexistence API ufficiali

Dati demografici dei follower di Instagram tramite API

L'endpoint degli insights dell'account di Instagram restituisce i dati demografici dei follower con metric=follower_demographics, period=lifetime, metric_type=total_value, un timeframe e una suddivisione per età, genere, città o paese. engaged_audience_demographics fa lo stesso per gli account che hanno interagito con i contenuti. Meta restituisce solo i primi 45 valori; i dati sui follower richiedono 100 follower, e quelli sul pubblico coinvolto 100 interazioni nel timeframe.

easyCoexistence legge i dati demografici dei follower e del pubblico coinvolto su Instagram con get_social_insights, così Claude, ChatGPT o il tuo codice possono chiedere quali paesi, città o fasce d'età seguono l'account e ottenere i numeri di Meta per l'account collegato.

100 followers

Sotto questa soglia, follower_demographics non viene restituito per l'account.

100 engagements

Interazioni necessarie nel timeframe prima che venga restituito engaged_audience_demographics.

Top 45

Le metriche demografiche restituiscono solo i primi 45 valori, quindi le città e i paesi più piccoli non compaiono.

19 Aug 2024

Quando last_14_days, last_30_days, last_90_days e prev_month hanno smesso di funzionare per engaged_audience_demographics in ogni versione.

48 hours

Quanto possono ritardare i dati alla base delle metriche dell'account.

Quali metriche demografiche esistono?

Due nel riferimento insights di Meta, entrambe lette con GET /<IG_ID>/insights, e due set più vecchi che il vecchio codice richiede ancora:

  • follower_demographics: le caratteristiche demografiche dei follower dell'account.
  • engaged_audience_demographics: lo stesso per il pubblico coinvolto, cioè gli account che hanno interagito con i suoi contenuti.
  • Entrambe: period lifetime, metric_type total_value, un timeframe e una suddivisione per età, città, paese o genere.
  • audience_gender_age, audience_locale, audience_country e audience_city: ritirate l'11 dicembre 2023.
  • reached_audience_demographics: citata nel changelog di Meta del 2024 ma assente dalla sua tabella delle metriche attuali.

Come si richiedono i dati demografici dei follower?

Con la metrica, period=lifetime, metric_type=total_value, un timeframe e una sola suddivisione. timeframe sostituisce since e until, che le metriche demografiche non supportano, ed è obbligatorio. Con Instagram Login il token deve avere instagram_business_basic e instagram_business_manage_insights, e la chiamata va a 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>

Che aspetto ha la risposta?

I conteggi si trovano in total_value.breakdowns. dimension_keys indica il timeframe e la suddivisione richiesti, e ogni risultato abbina dimension_values, il timeframe e un valore della suddivisione, con un conteggio. L'esempio di Meta, per il pubblico coinvolto per paese, restituisce i paesi come codici a due lettere, come US e 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"
    }
  ]
}

Quali timeframe funzionano?

Il riferimento di Meta elenca last_14_days, last_30_days, last_90_days, prev_month, this_month e this_week per entrambe le metriche e, per il pubblico coinvolto, descrive this_month come gli ultimi 30 giorni e this_week come gli ultimi 7. Per engaged_audience_demographics i primi quattro hanno smesso di funzionare dalla v20.0 e, in ogni versione, il 19 agosto 2024, quindi usa this_week o this_month; quella voce del changelog non cita follower_demographics.

Quali soglie e limiti si applicano?

Il riferimento insights dell'account di Meta fissa queste regole per le metriche demografiche:

  • follower_demographics non viene restituito per un account con meno di 100 follower.
  • engaged_audience_demographics non viene restituito con meno di 100 interazioni nel timeframe.
  • Tornano solo i primi 45 valori, quindi le città e i paesi più piccoli non compaiono.
  • Vengono contati solo gli spettatori con dati demografici, quindi i valori possono sommarsi a meno del numero di follower.
  • I dati mancanti restituiscono un insieme vuoto, non 0, e i dati possono ritardare fino a 48 ore.
  • Una suddivisione che una metrica richiesta non supporta fa fallire l'intera chiamata con An unknown error has occurred.

I dati demografici funzionano con Instagram Login?

Sì. Meta ha aperto gli insights di account e contenuti alle app con Instagram Login il 21 gennaio 2025, e il suo riferimento insights dell'account elenca Instagram Login con i permessi instagram_business_basic e instagram_business_manage_insights e graph.instagram.com come host. L'account deve essere un account business o creator, come richiede la Instagram Platform di Meta.

Come legge get_social_insights i dati demografici?

Con metrics impostato su follower_demographics o engaged_audience_demographics, period impostato su lifetime e params che contiene timeframe, breakdown e metric_type. easyCoexistence chiama GET /<IG_ID>/insights per l'account collegato con il suo token e restituisce la risposta di Meta, così Claude o ChatGPT possono dire quali paesi, città o fasce d'età seguono l'account.

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

Errori comuni

  • Passare since e until. Le metriche demografiche non li supportano: timeframe imposta l'intervallo, ed è obbligatorio.
  • Usare last_30_days o last_90_days per il pubblico coinvolto. Quei timeframe hanno smesso di funzionare per engaged_audience_demographics in ogni versione il 19 agosto 2024.
  • Sommare una suddivisione per ottenere il numero di follower. Vengono contati solo gli spettatori con dati demografici e tornano solo i primi 45 valori, quindi la somma risulta inferiore.
  • Aspettarsi dati da un account piccolo. I dati demografici dei follower richiedono 100 follower, e il pubblico coinvolto 100 interazioni nel timeframe.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Quanti follower serve un account Instagram per i dati demografici?

100. Sotto questa soglia Meta non restituisce follower_demographics; engaged_audience_demographics richiede 100 interazioni nel timeframe.

Perché Instagram restituisce solo 45 città?

Le metriche demografiche di Meta restituiscono solo i primi 45 valori, quindi le città e i paesi più piccoli vengono esclusi.

Cosa ha sostituito audience_gender_age nell'API di Instagram?

follower_demographics, con una suddivisione per età, genere, città o paese. Meta ha ritirato audience_gender_age, audience_locale, audience_country e audience_city l'11 dicembre 2023.

Posso usare since e until con follower_demographics?

No. Le metriche demografiche non supportano since e until; al loro posto il parametro timeframe imposta l'intervallo, ed è obbligatorio.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il