Demografi pengikut Instagram melalui API
Endpoint insights akun Instagram mengembalikan demografi pengikut dengan metric=follower_demographics, period=lifetime, metric_type=total_value, parameter timeframe, dan rincian usia, gender, kota atau negara. engaged_audience_demographics melakukan hal yang sama untuk akun yang berinteraksi dengan konten. Meta hanya mengembalikan 45 nilai teratas. Data pengikut memerlukan minimal 100 pengikut, dan data audiens yang berinteraksi memerlukan 100 interaksi dalam timeframe.
easyCoexistence membaca demografi pengikut dan audiens yang berinteraksi di Instagram dengan get_social_insights, sehingga Claude, ChatGPT atau kode Anda sendiri bisa menanyakan negara, kota atau kelompok usia mana yang mengikuti akun, dan mendapatkan angka Meta untuk akun yang terhubung.
Di bawah jumlah ini, follower_demographics tidak dikembalikan untuk akun tersebut.
Dibutuhkan dalam timeframe sebelum engaged_audience_demographics dikembalikan.
Metrik demografi hanya mengembalikan 45 nilai teratas, sehingga kota dan negara yang lebih kecil tidak muncul.
Saat last_14_days, last_30_days, last_90_days dan prev_month berhenti berfungsi untuk engaged_audience_demographics di semua versi.
Berapa lama data di balik metrik akun bisa tertunda.
Metrik demografi apa saja yang tersedia?
Dua di referensi insights akun Meta, keduanya dibaca dengan GET /<IG_ID>/insights, dan dua set lama yang masih diminta oleh kode lama:
follower_demographics: karakteristik demografi pengikut akun.engaged_audience_demographics: hal yang sama untuk audiens yang berinteraksi, yaitu akun yang berinteraksi dengan kontennya.- Keduanya: period lifetime,
metric_typetotal_value, timeframe, dan rincian usia, kota, negara atau gender. audience_gender_age,audience_locale,audience_countrydanaudience_city: dihentikan pada 11 Desember 2023.reached_audience_demographics: disebut dalam changelog 2024 Meta, tetapi tidak ada di tabel metrik saat ini.
Bagaimana cara meminta demografi pengikut?
Dengan metrik, period=lifetime, metric_type=total_value, timeframe, dan satu rincian. timeframe menggantikan since dan until, yang tidak didukung metrik demografi, dan parameter ini wajib. Dengan Instagram Login, token perlu instagram_business_basic dan instagram_business_manage_insights, dan panggilan dikirim ke 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>Seperti apa responsnya?
Jumlahnya ada di total_value.breakdowns. dimension_keys menyebut timeframe dan rincian yang diminta, dan setiap hasil memasangkan dimension_values, timeframe, serta satu nilai dari rincian tersebut, dengan jumlahnya. Contoh Meta, untuk audiens yang berinteraksi berdasarkan negara, mengembalikan negara sebagai kode dua huruf seperti US dan 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"
}
]
}Timeframe apa saja yang berfungsi?
Referensi Meta mencantumkan last_14_days, last_30_days, last_90_days, prev_month, this_month dan this_week untuk kedua metrik, dan untuk audiens yang berinteraksi menjelaskan bahwa this_month berarti 30 hari terakhir dan this_week berarti 7 hari terakhir. Untuk engaged_audience_demographics, empat yang pertama berhenti berfungsi sejak v20.0 dan di semua versi pada 19 Agustus 2024, jadi gunakan this_week atau this_month. Entri changelog itu tidak menyebut follower_demographics.
Ambang dan batasan apa yang berlaku?
Referensi insights akun Meta menetapkan aturan berikut untuk metrik demografi:
follower_demographicstidak dikembalikan untuk akun dengan kurang dari 100 pengikut.engaged_audience_demographicstidak dikembalikan jika ada kurang dari 100 interaksi dalam timeframe.- Hanya 45 nilai teratas yang dikembalikan, sehingga kota dan negara yang lebih kecil tidak muncul.
- Hanya penonton dengan data demografi yang dihitung, sehingga total nilainya bisa kurang dari jumlah pengikut.
- Data yang hilang dikembalikan sebagai himpunan kosong, bukan 0, dan data bisa tertinggal hingga 48 jam.
- Rincian yang tidak didukung metrik yang diminta menggagalkan seluruh panggilan dengan pesan Terjadi kesalahan yang tidak diketahui.
Apakah demografi berfungsi dengan Instagram Login?
Ya. Meta membuka insights akun dan media untuk aplikasi Instagram Login pada 21 Januari 2025, dan referensi insights akunnya mencantumkan Instagram Login dengan izin instagram_business_basic dan instagram_business_manage_insights serta graph.instagram.com sebagai host. Akunnya harus berupa akun bisnis atau kreator, sesuai yang disyaratkan Instagram Platform dari Meta.
Bagaimana get_social_insights membaca demografi?
Dengan metrics diisi follower_demographics atau engaged_audience_demographics, period diisi lifetime, dan params memuat timeframe, breakdown dan metric_type. easyCoexistence memanggil GET /<IG_ID>/insights untuk akun yang terhubung dengan tokennya dan mengembalikan respons Meta, sehingga Claude atau ChatGPT bisa menyebut negara, kota atau kelompok usia mana yang mengikuti akun tersebut.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Kesalahan umum
- Mengirim since dan until. Metrik demografi tidak mendukungnya: timeframe menentukan rentangnya, dan parameter ini wajib.
- Menggunakan last_30_days atau last_90_days untuk audiens yang berinteraksi. Timeframe tersebut berhenti berfungsi untuk engaged_audience_demographics di semua versi pada 19 Agustus 2024.
- Menjumlahkan sebuah rincian untuk mendapatkan jumlah pengikut. Hanya penonton dengan data demografi yang dihitung dan hanya 45 nilai teratas yang kembali, sehingga jumlahnya kurang.
- Berharap ada data dari akun kecil. Demografi pengikut membutuhkan 100 pengikut, dan audiens yang berinteraksi 100 interaksi dalam timeframe.
Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Berapa banyak pengikut yang dibutuhkan akun Instagram untuk demografi?
100. Di bawah itu, Meta tidak mengembalikan follower_demographics; engaged_audience_demographics membutuhkan 100 interaksi dalam timeframe.
Mengapa Instagram hanya mengembalikan 45 kota?
Metrik demografi Meta hanya mengembalikan 45 nilai teratas, sehingga kota dan negara yang lebih kecil tidak disertakan.
Apa yang menggantikan audience_gender_age di API Instagram?
follower_demographics, dengan rincian usia, gender, kota atau negara. Meta menghentikan audience_gender_age, audience_locale, audience_country dan audience_city pada 11 Desember 2023.
Bisakah saya memakai since dan until dengan follower_demographics?
Tidak. Metrik demografi tidak mendukung since dan until; parameter timeframe yang menentukan rentangnya, dan parameter ini wajib.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada