Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

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.

100 followers

Tämän alapuolella follower_demographics ei palaudu tilille.

100 engagements

Aikavälillä tarvittava määrä, ennen kuin engaged_audience_demographics palautetaan.

Top 45

Demografiset mittarit palauttavat vain 45 parasta arvoa, joten pienemmät kaupungit ja maat jäävät pois.

19 Aug 2024

Milloin last_14_days, last_30_days, last_90_days ja prev_month lakkasivat toimimasta engaged_audience_demographics-mittarille kaikissa versioissa.

48 hours

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_type total_value, aikaväli sekä jako ikään, kaupunkiin, maahan tai sukupuoleen.
  • audience_gender_age, audience_locale, audience_country ja audience_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:

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>

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:

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

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_demographics ei palaudu tilille, jolla on alle 100 seuraajaa.
  • engaged_audience_demographics ei 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ä.

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

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ä.
Näin teet tämän EasyCoexistencen avulla

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