Instagram-seuraajien demografiset tiedot API:n kautta
Instagramin tilin insights-päätepiste palauttaa seuraajien demografiset tiedot, kun metric=follower_demographics, period=lifetime, metric_type=total_value, aikaväli ja jako ikään, sukupuoleen, kaupunkiin tai maahan. engaged_audience_demographics tekee saman niille tileille, jotka ovat olleet vuorovaikutuksessa sisällön kanssa. Meta palauttaa vain 45 parasta arvoa; seuraajatiedot vaativat 100 seuraajaa ja sitoutuneen yleisön tiedot 100 sitoutumista aikavälillä.
easyCoexistence lukee Instagramin seuraajien ja sitoutuneen yleisön demografiset tiedot get_social_insights-työkalulla, joten Claude, ChatGPT tai oma koodisi voi kysyä, mitkä maat, kaupungit tai ikäryhmät seuraavat tiliä, ja saada Metan luvut yhdistetylle tilille.
Tämän alapuolella follower_demographics ei palaudu tilille.
Aikavälillä tarvittava määrä, ennen kuin engaged_audience_demographics palautetaan.
Demografiset mittarit palauttavat vain 45 parasta arvoa, joten pienemmät kaupungit ja maat jäävät pois.
Milloin last_14_days, last_30_days, last_90_days ja prev_month lakkasivat toimimasta engaged_audience_demographics-mittarille kaikissa versioissa.
Kuinka pitkään tilimittareiden taustalla olevaa dataa voi viivästyä.
Mitä demografisia mittareita on?
Metan tilin insights-viitteessä on kaksi, molemmat luetaan kutsulla GET /<IG_ID>/insights, ja lisäksi kaksi vanhempaa joukkoa, joita vanha koodi yhä pyytää:
follower_demographics: tilin seuraajien demografiset ominaisuudet.engaged_audience_demographics: sama sitoutuneelle yleisölle, eli tileille, jotka ovat olleet vuorovaikutuksessa sisällön kanssa.- Molemmat: period lifetime,
metric_typetotal_value, aikaväli sekä jako ikään, kaupunkiin, maahan tai sukupuoleen. audience_gender_age,audience_locale,audience_countryjaaudience_city: poistettu käytöstä 11. joulukuuta 2023.reached_audience_demographics: mainittu Metan vuoden 2024 muutoslokissa, mutta ei enää nykyisessä mittaritaulukossa.
Miten seuraajien demografiset tiedot pyydetään?
Mittarilla, period=lifetime, metric_type=total_value, aikavälillä ja yhdellä jaolla. timeframe korvaa since- ja until-parametrit, joita demografiset mittarit eivät tue, ja se on pakollinen. Instagram Login -kirjautumisella tokenin on oltava instagram_business_basic ja instagram_business_manage_insights, ja kutsu menee osoitteeseen 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>Miltä vastaus näyttää?
Määrät ovat total_value.breakdowns-kentässä. dimension_keys nimeää pyydetyn aikavälin ja jaon, ja jokainen tulos yhdistää dimension_values-arvot, aikavälin ja yhden jaon arvon sekä määrän. Metan esimerkissä sitoutuneen yleisön maajaossa maat palautetaan kaksikirjaimisina koodeina, kuten US ja 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"
}
]
}Mitkä aikavälit toimivat?
Metan viite listaa last_14_days, last_30_days, last_90_days, prev_month, this_month ja this_week molemmille mittareille. Sitoutuneelle yleisölle this_month kuvataan viimeisiksi 30 päiväksi ja this_week viimeisiksi 7 päiväksi. engaged_audience_demographics-mittarin ensimmäiset neljä lakkasivat toimimasta versiosta v20.0 alkaen ja kaikissa versioissa 19. elokuuta 2024, joten käytä this_week- tai this_month-aikaväliä. Tuo muutoslokimerkintä ei mainitse follower_demographics-mittaria.
Mitä rajoja ja kynnysarvoja sovelletaan?
Metan tilin insights-viite asettaa demografisille mittareille nämä säännöt:
follower_demographicsei palaudu tilille, jolla on alle 100 seuraajaa.engaged_audience_demographicsei palaudu, jos aikavälillä on alle 100 sitoutumista.- Vain 45 parasta arvoa palautuu, joten pienemmät kaupungit ja maat jäävät pois.
- Vain demografista dataa omaavat katsojat lasketaan, joten arvojen summa voi jäädä alle seuraajamäärän.
- Puuttuva data palauttaa tyhjän joukon, ei nollaa, ja data voi viivästyä jopa 48 tuntia.
- Jaon, jota pyydetty mittari ei tue, epäonnistuu koko kutsu virheellä An unknown error has occurred.
Toimivatko demografiset tiedot Instagram Loginilla?
Kyllä. Meta avasi tili- ja mediainsightsit Instagram Login -sovelluksille 21. tammikuuta 2025. Sen tilin insights-viite listaa Instagram Loginin oikeuksineen instagram_business_basic ja instagram_business_manage_insights sekä isäntänimenä graph.instagram.com. Tilin on oltava liike- tai creator-tili, kuten Metan Instagram Platform vaatii.
Miten get_social_insights lukee demografiset tiedot?
Kun metrics on asetettu arvoon follower_demographics tai engaged_audience_demographics, period arvoon lifetime ja params sisältää timeframe-, breakdown- ja metric_type-kentät. easyCoexistence kutsuu yhdistetylle tilille GET /<IG_ID>/insights omalla tokenillaan ja palauttaa Metan vastauksen, jotta Claude tai ChatGPT voi kertoa, mitkä maat, kaupungit tai ikäryhmät seuraavat tiliä.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Yleiset virheet
- since- ja until-parametrien välittäminen. Demografiset mittarit eivät tue niitä: timeframe asettaa aikavälin, ja se on pakollinen.
- last_30_days- tai last_90_days-aikavälin käyttö sitoutuneelle yleisölle. Nuo aikavälit lakkasivat toimimasta engaged_audience_demographics-mittarille kaikissa versioissa 19. elokuuta 2024.
- Jaon arvojen summaaminen seuraajamäärän saamiseksi. Lasketaan vain katsojat, joilla on demografista dataa, ja palautuu vain 45 parasta arvoa, joten summa jää alle todellisen.
- Datan odottaminen pieneltä tililtä. Seuraajien demografiset tiedot vaativat 100 seuraajaa ja sitoutuneen yleisön 100 sitoutumista aikavälillä.
US$ 9–US$ 0,75 yhteydeltä kuukaudessa, hinta laskee yhteyksiä lisättäessä. Ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Kuinka monta seuraajaa Instagram-tili tarvitsee demografiseen dataan?
100. Sen alapuolella Meta ei palauta follower_demographics-mittaria; engaged_audience_demographics vaatii 100 sitoutumista aikavälillä.
Miksi Instagram palauttaa vain 45 kaupunkia?
Metan demografiset mittarit palauttavat vain 45 parasta arvoa, joten pienemmät kaupungit ja maat jäävät pois.
Mikä korvasi audience_gender_age-mittarin Instagram API:ssa?
follower_demographics, jonka jaossa on ikä, sukupuoli, kaupunki tai maa. Meta poisti audience_gender_age-, audience_locale-, audience_country- ja audience_city-mittarit käytöstä 11. joulukuuta 2023.
Voinko käyttää since- ja until-parametreja follower_demographics-mittarin kanssa?
Ei. Demografiset mittarit eivät tue since- ja until-parametreja. Sen sijaan aikavälin asettaa timeframe-parametri, ja se on pakollinen.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu