API üzerinden Instagram takipçi demografisi
Instagram hesap insights uç noktası, metric=follower_demographics, period=lifetime, metric_type=total_value, bir timeframe ve yaş, cinsiyet, şehir veya ülke kırılımı ile takipçi demografisini döndürür. engaged_audience_demographics aynısını, içeriğle etkileşime giren hesaplar için yapar. Meta yalnızca ilk 45 değeri döndürür; takipçi verisi için 100 takipçi, etkileşimli kitle verisi için ise timeframe içinde 100 etkileşim gerekir.
easyCoexistence, Instagram takipçi ve etkileşimli kitle demografisini get_social_insights ile okur; böylece Claude, ChatGPT veya kendi kodunuz hangi ülkelerin, şehirlerin veya yaş gruplarının hesabı takip ettiğini sorabilir ve bağlı hesap için Meta'nın sayılarını alabilir.
Bunun altında hesap için follower_demographics döndürülmez.
engaged_audience_demographics döndürülmeden önce timeframe içinde gereken etkileşim.
Demografik metrikler yalnızca ilk 45 değeri döndürür; bu yüzden daha küçük şehir ve ülkeler listeye girmez.
last_14_days, last_30_days, last_90_days ve prev_month, engaged_audience_demographics için her sürümde çalışmaz oldu.
Hesap metriklerinin arkasındaki verinin ne kadar gecikebileceği.
Hangi demografik metrikler var?
Meta'nın hesap insights referansında iki tane var, ikisi de GET /<IG_ID>/insights ile okunur; eski kodun hâlâ istediği iki eski küme de var:
follower_demographics: hesabın takipçilerinin demografik özellikleri.engaged_audience_demographics: aynısı, yani hesabın içeriğiyle etkileşime giren hesaplar için.- Her ikisi: period lifetime,
metric_typetotal_value, bir timeframe ve yaş, şehir, ülke veya cinsiyet kırılımı. audience_gender_age,audience_locale,audience_countryveaudience_city: 11 Aralık 2023'te kullanımdan kaldırıldı.reached_audience_demographics: Meta'nın 2024 değişiklik günlüğünde adı geçiyor ama güncel metrik tablosunda yok.
Takipçi demografisini nasıl istersiniz?
Metric, period=lifetime, metric_type=total_value, bir timeframe ve tek bir kırılım ile istenir. timeframe, since ve until yerine geçer; demografik metrikler bunları desteklemez ve timeframe zorunludur. Instagram Login ile token, instagram_business_basic ve instagram_business_manage_insights izinlerine sahip olmalı ve çağrı graph.instagram.com'a gider:
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>Yanıt nasıl görünür?
Sayılar total_value.breakdowns içinde döner. dimension_keys istenen timeframe ve kırılımı adlandırır; her sonuç dimension_values, timeframe ve kırılımın tek bir değerini bir sayıyla eşleştirir. Meta'nın etkileşimli kitlenin ülkeye göre örneğinde, ülkeler US ve ES gibi iki harfli kodlarla döner:
{
"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"
}
]
}Hangi timeframe değerleri çalışır?
Meta'nın referansı, iki metrik için de last_14_days, last_30_days, last_90_days, prev_month, this_month ve this_week değerlerini listeler; etkileşimli kitle için this_month son 30 günü, this_week ise son 7 günü anlatır. engaged_audience_demographics için ilk dört değer v20.0'dan itibaren ve 19 Ağustos 2024 tarihinde her sürümde çalışmaz oldu; bu yüzden this_week veya this_month kullanın. Bu değişiklik kaydında follower_demographics adı geçmiyor.
Hangi eşikler ve sınırlar geçerli?
Meta'nın hesap insights referansı demografik metrikler için şu kuralları koyar:
follower_demographics, 100 takipçiden az olan bir hesap için döndürülmez.engaged_audience_demographics, timeframe içinde 100 etkileşimden az olduğunda döndürülmez.- Yalnızca ilk 45 değer döner; bu yüzden daha küçük şehir ve ülkeler listeden düşer.
- Yalnızca demografik verisi olan görüntüleyiciler sayılır; bu yüzden değerler takipçi sayısından az toplanabilir.
- Eksik veri 0 yerine boş küme döndürür ve veri 48 saate kadar gecikebilir.
- İstenen metriğin desteklemediği bir kırılım, tüm çağrıyı An unknown error has occurred. mesajıyla başarısız kılar.
Demografik veriler Instagram Login ile çalışır mı?
Evet. Meta, 21 Ocak 2025'te hesap ve medya insights'ını Instagram Login uygulamalarına açtı; hesap insights referansı Instagram Login'i instagram_business_basic ve instagram_business_manage_insights izinleri ve graph.instagram.com ana makinesiyle listeler. Meta'nın Instagram Platform gereksinimi olarak hesap bir işletme veya creator hesabı olmalıdır.
get_social_insights demografiyi nasıl okur?
metrics alanı follower_demographics veya engaged_audience_demographics, period alanı lifetime olarak ayarlandığında ve params, timeframe, breakdown ile metric_type taşıdığında. easyCoexistence, bağlı hesap için token'ıyla GET /<IG_ID>/insights çağırır ve Meta'nın yanıtını döndürür; böylece Claude veya ChatGPT hangi ülkelerin, şehirlerin veya yaş gruplarının hesabı takip ettiğini söyleyebilir.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Yaygın hatalar
- since ve until göndermek. Demografik metrikler bunları desteklemez: timeframe aralığı belirler ve zorunludur.
- Etkileşimli kitle için last_30_days veya last_90_days kullanmak. Bu timeframe değerleri 19 Ağustos 2024'te her sürümde engaged_audience_demographics için çalışmaz oldu.
- Bir kırılımın değerlerini toplayarak takipçi sayısını bulmaya çalışmak. Yalnızca demografik verisi olan görüntüleyiciler sayılır ve yalnızca ilk 45 değer döner; bu yüzden toplam eksik kalır.
- Küçük bir hesaptan veri beklemek. Takipçi demografisi 100 takipçi, etkileşimli kitle ise timeframe içinde 100 etkileşim gerektirir.
Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Instagram hesabının demografi verisi için kaç takipçisi olmalı?
100. Bunun altında Meta follower_demographics döndürmez; engaged_audience_demographics için timeframe içinde 100 etkileşim gerekir.
Instagram neden yalnızca 45 şehir döndürüyor?
Meta'nın demografik metrikleri yalnızca en iyi 45 değeri döndürür; bu yüzden daha küçük şehir ve ülkeler dışarıda kalır.
Instagram API'sinde audience_gender_age yerine ne geldi?
follower_demographics; yaş, cinsiyet, şehir veya ülke kırılımıyla. Meta audience_gender_age, audience_locale, audience_country ve audience_city alanlarını 11 Aralık 2023'te kullanımdan kaldırdı.
follower_demographics ile since ve until kullanabilir miyim?
Hayır. Demografik metrikler since ve until desteklemez; bunun yerine timeframe parametresi aralığı belirler ve zorunludur.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi