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.
Sotto questa soglia, follower_demographics non viene restituito per l'account.
Interazioni necessarie nel timeframe prima che venga restituito engaged_audience_demographics.
Le metriche demografiche restituiscono solo i primi 45 valori, quindi le città e i paesi più piccoli non compaiono.
Quando last_14_days, last_30_days, last_90_days e prev_month hanno smesso di funzionare per engaged_audience_demographics in ogni versione.
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_typetotal_value, un timeframe e una suddivisione per età, città, paese o genere. audience_gender_age,audience_locale,audience_countryeaudience_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:
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:
{
"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_demographicsnon viene restituito per un account con meno di 100 follower.engaged_audience_demographicsnon 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.
{
"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.
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