Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Demografi pengikut Instagram melalui API

Endpoint insights akaun Instagram memulangkan demografi pengikut dengan metric=follower_demographics, period=lifetime, metric_type=total_value, timeframe dan pecahan mengikut umur, jantina, bandar atau negara. engaged_audience_demographics melakukan perkara yang sama bagi akaun yang berinteraksi dengan kandungan. Meta hanya memulangkan 45 nilai teratas. Data pengikut memerlukan 100 pengikut, dan data audiens terlibat memerlukan 100 penglibatan dalam tempoh masa tersebut.

easyCoexistence membaca demografi pengikut dan audiens terlibat Instagram dengan get_social_insights, supaya Claude, ChatGPT atau kod anda sendiri boleh bertanya negara, bandar atau kumpulan umur yang mengikuti akaun itu dan mendapatkan angka Meta bagi akaun yang disambungkan.

100 followers

Di bawah had ini, follower_demographics tidak dipulangkan untuk akaun tersebut.

100 engagements

Penglibatan yang diperlukan dalam tempoh masa sebelum engaged_audience_demographics dipulangkan.

Top 45

Metrik demografi hanya memulangkan 45 nilai teratas, jadi bandar dan negara yang lebih kecil tercicir.

19 Aug 2024

Apabila last_14_days, last_30_days, last_90_days dan prev_month berhenti berfungsi untuk engaged_audience_demographics dalam setiap versi.

48 hours

Tempoh data di sebalik metrik akaun boleh tertangguh.

Apakah metrik demografi yang ada?

Dua dalam rujukan insights akaun Meta, kedua-duanya dibaca dengan GET /<IG_ID>/insights, dan dua set lama yang masih diminta oleh kod lama:

  • follower_demographics: ciri demografi pengikut akaun.
  • engaged_audience_demographics: perkara yang sama bagi audiens terlibat, iaitu akaun yang berinteraksi dengan kandungannya.
  • Kedua-duanya: period lifetime, metric_type total_value, timeframe, dan pecahan mengikut umur, bandar, negara atau jantina.
  • audience_gender_age, audience_locale, audience_country dan audience_city: dihentikan pada 11 Disember 2023.
  • reached_audience_demographics: dinamakan dalam log perubahan Meta 2024 tetapi tiada dalam jadual metrik semasa.

Bagaimana anda meminta demografi pengikut?

Dengan metric, period=lifetime, metric_type=total_value, timeframe dan satu pecahan. timeframe menggantikan since dan until, yang tidak disokong oleh metrik demografi, dan ia diperlukan. Dengan Instagram Login, token perlu mempunyai instagram_business_basic dan instagram_business_manage_insights, dan panggilan dihantar ke 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>

Bagaimana rupa respons?

Kiraan terdapat dalam total_value.breakdowns. dimension_keys menamakan tempoh masa dan pecahan yang diminta, dan setiap hasil memadankan dimension_values, tempoh masa dan satu nilai pecahan, dengan kiraan. Contoh Meta bagi audiens terlibat mengikut negara memulangkan negara sebagai kod dua huruf seperti US dan 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"
    }
  ]
}

Tempoh masa mana yang berfungsi?

Rujukan Meta menyenaraikan last_14_days, last_30_days, last_90_days, prev_month, this_month dan this_week untuk kedua-dua metrik. Bagi audiens terlibat, ia menerangkan this_month sebagai 30 hari terakhir dan this_week sebagai 7 hari terakhir. Bagi engaged_audience_demographics, empat yang pertama berhenti berfungsi bermula v20.0 dan dalam setiap versi pada 19 Ogos 2024, jadi gunakan this_week atau this_month. Entri log perubahan itu tidak menamakan follower_demographics.

Apakah ambang dan had yang terpakai?

Rujukan insights akaun Meta menetapkan peraturan ini bagi metrik demografi:

  • follower_demographics tidak dipulangkan untuk akaun dengan kurang daripada 100 pengikut.
  • engaged_audience_demographics tidak dipulangkan jika kurang daripada 100 penglibatan dalam tempoh masa.
  • Hanya 45 nilai teratas dipulangkan, jadi bandar dan negara yang lebih kecil tercicir.
  • Hanya penonton yang mempunyai data demografi dikira, jadi nilai boleh berjumlah kurang daripada bilangan pengikut.
  • Data yang hilang memulangkan set kosong, bukan 0, dan data boleh lewat sehingga 48 jam.
  • Pecahan yang tidak disokong oleh metrik yang diminta menggagalkan keseluruhan panggilan dengan An unknown error has occurred.

Adakah demografi berfungsi dengan Instagram Login?

Ya. Meta membuka insights akaun dan media kepada aplikasi Instagram Login pada 21 Januari 2025. Rujukan insights akaunnya menyenaraikan Instagram Login dengan kebenaran instagram_business_basic dan instagram_business_manage_insights, serta graph.instagram.com sebagai hos. Akaun mestilah akaun perniagaan atau pencipta, seperti yang diperlukan oleh Instagram Platform Meta.

Bagaimana get_social_insights membaca demografi?

Dengan metrics ditetapkan kepada follower_demographics atau engaged_audience_demographics, period ditetapkan kepada lifetime, dan params membawa timeframe, breakdown dan metric_type. easyCoexistence memanggil GET /<IG_ID>/insights bagi akaun yang disambungkan dengan tokennya dan memulangkan respons Meta, supaya Claude atau ChatGPT dapat menyatakan negara, bandar atau kumpulan umur yang mengikuti akaun itu.

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

Kesilapan biasa

  • Menghantar since dan until. Metrik demografi tidak menyokongnya: timeframe menetapkan julat, dan ia diperlukan.
  • Menggunakan last_30_days atau last_90_days untuk audiens terlibat. Tempoh tersebut berhenti berfungsi untuk engaged_audience_demographics dalam setiap versi pada 19 Ogos 2024.
  • Menjumlahkan satu pecahan untuk mendapatkan bilangan pengikut. Hanya penonton yang mempunyai data demografi dikira dan hanya 45 nilai teratas dipulangkan, jadi jumlahnya kurang.
  • Menjangka data daripada akaun kecil. Demografi pengikut memerlukan 100 pengikut, dan audiens terlibat memerlukan 100 penglibatan dalam tempoh masa.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Berapa pengikut yang diperlukan akaun Instagram untuk demografi?

100. Di bawah itu, Meta tidak memulangkan follower_demographics. engaged_audience_demographics memerlukan 100 penglibatan dalam tempoh masa.

Mengapa Instagram hanya memulangkan 45 bandar?

Metrik demografi Meta hanya memulangkan 45 nilai teratas, jadi bandar dan negara yang lebih kecil tercicir.

Apakah yang menggantikan audience_gender_age dalam API Instagram?

follower_demographics, dengan pecahan mengikut umur, jantina, bandar atau negara. Meta menghentikan audience_gender_age, audience_locale, audience_country dan audience_city pada 11 Disember 2023.

Bolehkah saya menggunakan since dan until dengan follower_demographics?

Tidak. Metrik demografi tidak menyokong since dan until. Parameter timeframe menetapkan julat sebaliknya, dan ia diperlukan.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada