Datele demografice ale urmăritorilor Instagram prin API
Endpoint-ul de statistici al contului Instagram returnează demografia urmăritorilor cu metric=follower_demographics, period=lifetime, metric_type=total_value, un timeframe și o defalcare pe vârstă, gen, oraș sau țară. engaged_audience_demographics face același lucru pentru conturile care au interacționat cu conținutul. Meta returnează doar primele 45 de valori; datele despre urmăritori necesită 100 de urmăritori, iar cele despre audiența implicată 100 de interacțiuni în perioada aleasă.
easyCoexistence citește demografiile urmăritorilor și ale audienței implicate pe Instagram cu get_social_insights, astfel încât Claude, ChatGPT sau propriul cod pot întreba ce țări, orașe sau grupe de vârstă urmăresc contul și primesc cifrele Meta pentru contul conectat.
Sub acest prag, follower_demographics nu este returnat pentru cont.
Necesare în perioada aleasă înainte ca engaged_audience_demographics să fie returnat.
Metricile demografice returnează doar primele 45 de valori, astfel că orașele și țările mai mici nu apar.
Momentul de la care last_14_days, last_30_days, last_90_days și prev_month au încetat să funcționeze pentru engaged_audience_demographics, în toate versiunile.
Cât de mult pot fi întârziate datele din spatele metricilor contului.
Ce metrici demografice există?
Două în referința Meta pentru statisticile contului, ambele citite cu GET /<IG_ID>/insights, și două seturi mai vechi pe care codul vechi încă le cere:
follower_demographics: caracteristicile demografice ale urmăritorilor contului.engaged_audience_demographics: același lucru pentru audiența implicată, adică conturile care au interacționat cu conținutul.- Ambele: period lifetime,
metric_typetotal_value, un timeframe și o defalcare pe vârstă, oraș, țară sau gen. audience_gender_age,audience_locale,audience_countryșiaudience_city: retrase pe 11 decembrie 2023.reached_audience_demographics: menționat în jurnalul de modificări Meta din 2024, dar absent din tabelul actual de metrici.
Cum se cer demografiile urmăritorilor?
Cu metricul, period=lifetime, metric_type=total_value, un timeframe și o singură defalcare. timeframe înlocuiește since și until, pe care metricile demografice nu le acceptă, și este obligatoriu. Cu Instagram Login, token-ul trebuie să aibă instagram_business_basic și instagram_business_manage_insights, iar apelul merge la 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>Cum arată răspunsul?
Numărătorile sunt în total_value.breakdowns. dimension_keys indică perioada și defalcarea cerute, iar fiecare rezultat asociază dimension_values, perioada și o valoare a defalcării, cu un count. Exemplul Meta, pentru audiența implicată pe țări, returnează țările ca coduri din două litere, precum US și 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"
}
]
}Ce perioade funcționează?
Referința Meta listează last_14_days, last_30_days, last_90_days, prev_month, this_month și this_week pentru ambele metrici și, pentru audiența implicată, descrie this_month ca ultimele 30 de zile, iar this_week ca ultimele 7. Pentru engaged_audience_demographics, primele patru au încetat să funcționeze din v20.0 și, în toate versiunile, pe 19 august 2024, așa că folosiți this_week sau this_month. Intrarea din jurnalul de modificări nu menționează follower_demographics.
Ce praguri și limite se aplică?
Referința Meta pentru statisticile contului stabilește aceste reguli pentru metricile demografice:
follower_demographicsnu este returnat pentru un cont cu mai puțin de 100 de urmăritori.engaged_audience_demographicsnu este returnat cu mai puțin de 100 de interacțiuni în perioada aleasă.- Revin doar primele 45 de valori, astfel că orașele și țările mai mici nu apar.
- Sunt numărați doar utilizatorii cu date demografice, deci valorile pot însuma mai puțin decât numărul de urmăritori.
- Datele lipsă returnează un set gol, nu 0, iar datele pot întârzia până la 48 de ore.
- O defalcare pe care metricul cerut nu o acceptă face ca întregul apel să eșueze cu eroarea „An unknown error has occurred”.
Funcționează demografiile cu Instagram Login?
Da. Meta a deschis statisticile contului și ale conținutului aplicațiilor Instagram Login pe 21 ianuarie 2025, iar referința Meta pentru statisticile contului listează Instagram Login cu permisiunile instagram_business_basic și instagram_business_manage_insights și graph.instagram.com ca gazdă. Contul trebuie să fie cont de business sau de creator, așa cum impune Instagram Platform de la Meta.
Cum citește get_social_insights demografiile?
Cu metrics setat pe follower_demographics sau engaged_audience_demographics, period setat pe lifetime, iar params care conține timeframe, breakdown și metric_type. easyCoexistence apelează GET /<IG_ID>/insights pentru contul conectat, cu token-ul său, și returnează răspunsul Meta, astfel încât Claude sau ChatGPT pot spune ce țări, orașe sau grupe de vârstă urmăresc contul.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Greșeli frecvente
- Trimiterea parametrilor since și until. Metricile demografice nu îi acceptă: timeframe stabilește intervalul și este obligatoriu.
- Folosirea last_30_days sau last_90_days pentru audiența implicată. Aceste perioade au încetat să funcționeze pentru engaged_audience_demographics, în toate versiunile, pe 19 august 2024.
- Adunarea unei defalcări pentru a obține numărul de urmăritori. Sunt numărați doar utilizatorii cu date demografice și revin doar primele 45 de valori, deci suma rămâne mai mică.
- Așteptarea de date de la un cont mic. Demografiile urmăritorilor necesită 100 de urmăritori, iar audiența implicată 100 de interacțiuni în perioada aleasă.
De la US$ 9 până la US$ 0,75 pe conexiune pe lună, pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Câți urmăritori trebuie să aibă un cont Instagram pentru demografii?
100. Sub acest prag, Meta nu returnează follower_demographics; engaged_audience_demographics necesită 100 de interacțiuni în perioada aleasă.
De ce Instagram returnează doar 45 de orașe?
Metricile demografice ale Meta returnează doar primele 45 de valori, deci orașele și țările mai mici sunt lăsate deoparte.
Ce a înlocuit audience_gender_age în API-ul Instagram?
follower_demographics, cu o defalcare pe vârstă, gen, oraș sau țară. Meta a retras audience_gender_age, audience_locale, audience_country și audience_city pe 11 decembrie 2023.
Pot folosi since și until cu follower_demographics?
Nu. Metricile demografice nu acceptă since și until; în locul lor, parametrul timeframe stabilește intervalul, și este obligatoriu.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la