Instagram analizleri API üzerinden: hesap ve gönderi metrikleri
Instagram API'si, profesyonel bir hesap ile bu hesabın her gönderisi, Reel'i ve hikayesi için analiz verileri döndürür. Hesap metrikleri erişim, görüntülenme, etkileşime giren hesaplar, takip ve takipten çıkma, beğeniler, yorumlar, kaydetmeler ve paylaşımları kapsar; gönderi metrikleri ise erişim, görüntülenme, beğeniler, yorumlar, kaydetmeler ve paylaşımları içerir. Meta, verilerin 48 saate kadar gecikebileceğini belirtiyor.
easyCoexistence, Instagram analizlerini get_social_insights ile okur; böylece Claude veya ChatGPT'ye geçen hafta gönderilerinizin nasıl performans gösterdiğini sorabilir, hesap veya tek bir gönderi için erişim, görüntülenme, beğeni, yorum, kaydetme ve paylaşımları doğrudan Meta'dan alabilirsiniz.
Instagram metriklerinin arkasındaki verilerin ne kadar gecikebileceği.
Bu eşiğin altında kalan hesaplar için takip ve takipten çıkma ile takipçi demografileri döndürülmez.
Meta'nın medya metriklerini ne kadar süre sakladığı.
Hikaye metriklerinin API üzerinden ne kadar süre erişilebilir kaldığı.
impressions metriğinin, 2 Temmuz 2024 tarihinden önce oluşturulan medya hariç, tüm API sürümlerinde çalışmayı durdurması; yerine views geçti.
Hangi hesap metrikleri kullanılabilir?
GET /<IG_ID>/insights ile okuyun; çoğunlukla period=day ve metric_type=total_value kullanılır:
- reach: içeriği gören benzersiz hesaplar, reklamlar dahil; tahminidir.
- views: içeriğin oynatılma veya gösterilme sayısı.
accounts_engaged: içerikle etkileşime giren hesaplar, reklamlar dahil; tahminidir.follows_and_unfollows: dönem içindeki takipler ve takipten çıkmalar; en az 100 takipçi gerektirir.- likes, comments, saves, shares, replies ve reposts ile
total_interactions. profile_links_taps: işletme adresi, arama, e-posta ve metin düğmelerine yapılan dokunuşlar.follower_demographicsveengaged_audience_demographics: yaş, şehir, ülke ve cinsiyet.
Hangi gönderi metrikleri kullanılabilir?
GET /<IG_MEDIA_ID>/insights ile okuyun; hangi metriklerin geçerli olduğu formata bağlıdır. Bir gönderi veya Reel'de beğeniler, yorumlar, görüntülenme ve toplam etkileşimler yalnızca organik etkinliği sayar; bundan oluşturulan reklamlardaki etkileşimleri saymaz.
- Gönderiler ve Reel'ler: reach, views, likes, comments, saved, shares,
total_interactionsve reposts. - Yalnızca Reel'ler:
ig_reels_avg_watch_time,ig_reels_video_view_total_timevereels_skip_rate. - Gönderiler ve hikayeler: follows,
profile_visitsveprofile_activity. - Hikayeler: reach, views, shares, replies, navigation, reposts ve
total_interactions.
period, metric_type ve dökümler nasıl çalışır?
Hesap metrikleri period=day alır. metric_type=total_value, aralık için tek bir değer döndürür ve dökümlerin ihtiyaç duyduğu değerdir; time_series ise her gün için bir değer döndürür ve yalnızca reach için kullanılabilir. Dökümler bir toplamı media_product_type alanına göre (gönderiler, karuseller, Reel'ler, hikayeler ve reklamlar), follow_type alanına göre (takipçi olup olmama) veya contact_button_type alanına göre böler.
Demografik metrikler since ve until yerine this_week veya this_month gibi bir timeframe parametresi alır; since ve until olmadan diğer metrikler son 24 saate bakar. İstenen metriklerden birinin desteklemediği bir döküm istemek, tüm isteğin bilinmeyen bir hatayla başarısız olmasına neden olur.
Hangi eşikler ve gecikmeler geçerlidir?
Meta'nın bir sayının ne zaman göründüğü ve ne kadar süre kullanılabilir kaldığına dair kuralları:
- Veriler 48 saate kadar gecikebilir.
- 100'den az takipçisi olan hesaplar
follows_and_unfollowsvefollower_demographicsalamaz;engaged_audience_demographicsise zaman aralığında 100 etkileşim gerektirir. - Eksik veya kullanılamayan veriler 0 olarak değil, boş bir küme olarak döner.
- Demografik metrikler yalnızca ilk 45 değeri döndürür.
- Hesap metrikleri en fazla 90 gün, medya metrikleri en fazla 2 yıl saklanır.
Hikayeler ve karuseller için neler farklıdır?
Hikaye metrikleri yalnızca 24 saat kullanılabilir ve 5'ten düşük bir değer, sayı yerine 10 numaralı hata kodunu (yeterli izleyici yok) döndürür. Avrupa ve Japonya'daki kişilerden gelen yanıtlar hariç tutulur; bu bölgelerdeki bir hesabın oluşturduğu hikaye 0 yanıt bildirir. Instagram Login ile story_insights webhook'u yoktur, bu nedenle hikaye sayıları hikaye yayında olduğu sırada okunmalıdır.
Karusel tek bir gönderi olarak bildirilir; Meta, içindeki fotoğraflar ve videolar için içgörü döndürmez.
Metrik adları neden değişiyor?
Çünkü Meta, API sürümleri arasında metrikleri kullanımdan kaldırır ve yeniden adlandırır. impressions, v22.0 için kullanımdan kaldırıldı ve 21 Nisan 2025'te 2 Temmuz 2024'ten önce oluşturulan medya dışındaki tüm sürümlerde çalışmayı durdurdu; yerine views getirildi. Aynı anda plays, clips_replays_count ve ig_reels_aggregated_all_plays_count da kaldırıldı. video_views ile profil zaman serilerinin birkaçı, profile_views dahil, daha önce kaldırılmıştı. Kullanımdan kaldırılmış bir ad içeren istek başarısız olur; bu yüzden daha eski bir API sürümü için yazılmış bir metrik listesi güncellenmeyi gerektirebilir.
Yaygın hatalar
- impressions istemek. Artık hiçbir API sürümünde çalışmıyor; bunun yerine views isteyin.
- Boş bir sonucu sıfır saymak. Meta, bir metrik kullanılamadığında boş bir veri kümesi döndürür; bu, hiç etkinlik olmaması anlamına gelmez.
- Hikaye sona erdikten sonra hikaye metriklerini okumak. Bunlar yalnızca 24 saat kullanılabilir.
- Birden fazla metrik isteyen bir isteğe döküm eklemek. Metriklerden biri bunu desteklemiyorsa tüm çağrı başarısız olur.
Fiyat bağlantı başına aylık US$ 9 ile US$ 0,75 arasındadır, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Instagram API'sinde impressions metriğinin yerine ne geçti?
views geçti; içeriğin oynatılma veya gösterilme sayısını ölçer. Meta, impressions metriğini 21 Nisan 2025'te, 2 Temmuz 2024'ten önce oluşturulan medya hariç, tüm API sürümlerinde kullanımdan kaldırdı.
Hesabım neden takipçi verisi döndürmüyor?
Meta, 100'den az takipçisi olan hesaplar için follows_and_unfollows veya takipçi demografilerini döndürmez.
Instagram analizlerinde ne kadar geriye gidebilirim?
Hesap metrikleri için en fazla 90 gün, medya metrikleri için en fazla 2 yıl; online_followers yalnızca son 30 günü kapsar.
Sayılar reklamları içeriyor mu?
Kısmen. Bir hesabın erişimi ve etkileşime giren hesapları reklamları içerir; bir gönderinin beğeni, yorum ve görüntülenmeleri ise yalnızca organik etkinliği sayar.
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