Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

API üzerinden Instagram Reels içgörüleri

Instagram'ın medya içgörüleri uç noktası, GET /<IG_MEDIA_ID>/insights, bir Reel için şu metrikleri döndürür: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time ve reels_skip_rate. Çapraz paylaşılmış bir Reel için ayrıca crossposted_views ve facebook_views döner. plays, clips_replays_count ve ig_reels_aggregated_all_plays_count ise Nisan 2025'te kaldırıldı; yerlerine views geldi.

easyCoexistence, bir Reel'in içgörülerini get_social_insights ile okur; böylece Claude, ChatGPT ya da kendi kodunuz bir Reel'in nasıl performans gösterdiğini sorabilir ve bağlı hesap için görüntüleme, erişim, izlenme süresi ve atlama oranını doğrudan Meta'dan alabilir.

3 seconds

reels_skip_rate, Reel'in ilk 3 saniyesinde atlanan görüntülemelerin payını ölçer.

21 Apr 2025

plays, clips_replays_count ve ig_reels_aggregated_all_plays_count alanlarının her API sürümünde kullanımdan kaldırıldığı tarih.

3 Dec 2025

reels_skip_rate, reposts, crossposted_views ve facebook_views alanlarının medya içgörülerine eklendiği tarih.

48 hours

Medya metriklerinin arkasındaki verinin ne kadar gecikebileceği.

2 years

Meta'nın medya metriklerini ne kadar süre sakladığı.

Bir Reel hangi metrikleri döndürür?

Meta'nın media_product_type REELS için listelediği medya içgörüleri referansındaki metrikler; bunlar GET /<IG_MEDIA_ID>/insights ile ve virgülle ayrılmış bir metric parametresiyle okunur. Meta bazılarını tahmini veya geliştirme aşamasında olarak etiketler; bu not her metriğin yanında yer alır. Beğeniler ve yorumlar yalnızca organik etkinlik olarak sayılır:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Reels içgörü isteği ne döndürür?

data içinde her metrik için name, period, values, title, description ve id alanlarını taşıyan bir nesne. period her zaman lifetime olarak okunur; Meta bunu medya metrikleri için belirler ve değiştirilemez, bu nedenle istekte belirtmeye gerek yoktur. Meta'nın referansı iki izlenme süresi metriğini birim belirtmeden süre olarak tanımlar; bu nedenle bunları grafiğe dökmeden önce bildiğiniz bir Reel ile kontrol edin.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

Hangi Reel metrikleri kaldırıldı ve yerlerine ne geldi?

Meta ilk üç metriği Graph API v22.0'dan itibaren kullanımdan kaldırdı; bu, views'ı tanıttığı 21 Ocak 2025 günüydü. Tüm sürümlerde ise 21 Nisan 2025'te kaldırıldılar. video_views ise v21.0'dan itibaren ve tüm sürümlerde 8 Ocak 2025'te kaldırıldı. Kaldırılmış bir metriği adlandıran istek başarısız olur; bu nedenle 2025'ten önce yazılmış bir metrik listesinin güncellenmesi gerekir:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Bir Reel'de views ve reach neyi sayar?

views, Reel'in Instagram'da oynatılma sayısını, yani görüntüleme sayısını gösterir; Meta bunu geliştirme aşamasında olarak etiketler. reach, Reel'i en az bir kez gören benzersiz hesap sayısıdır; Meta bunu tahmini olarak etiketler. likes, comments, views ve total_interactions yalnızca organik etkinliği sayar; Reel'den yapılan reklamlardaki etkileşimleri dışarıda bırakır. Tanıtılan medyayı da içeren total_likes, total_comments ve total_views yalnızca Facebook Login ile sunulur.

Hangi sınırlar ve gecikmeler geçerli?

Meta'nın medya içgörüleri referansı, bir Reel'in sayıları için şu kuralları koyar:

  • Metriklerin arkasındaki veri 48 saate kadar gecikebilir.
  • Medya metrikleri en fazla 2 yıl saklanır.
  • Eksik veya kullanılamayan veri 0 değil, boş bir veri kümesi olarak döner.
  • crossposted_views ve facebook_views, çapraz paylaşılmamış bir Reel için hata verir; bu nedenle bunları kendi çağrılarında isteyin.
  • İstenen metriğin desteklemediği bir kırılım, tüm isteği "An unknown error has occurred." hatasıyla başarısız kılar.
  • Instagram Login ile token, graph.instagram.com üzerinde instagram_business_basic ve instagram_business_manage_insights izinlerine ihtiyaç duyar.

get_social_insights bir Reel'i nasıl okur?

Bağlantının account_id değeri, Reel'in medya kimliği ise object_id olarak ve metrik listesiyle birlikte kullanılır. easyCoexistence, hesabın token'ıyla graph.instagram.com üzerinde GET /<IG_MEDIA_ID>/insights çağrısı yapar, metrik adlarını verildiği gibi Meta'ya iletir ve Meta'nın verisini döndürür; bir ad kaldırılmışsa Meta'nın kendi hatasını döndürür. list_social_posts ise hesabın son gönderilerinin ve Reel'lerinin medya kimliklerini verir.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Yaygın hatalar

  • plays veya clips_replays_count istemek. İkisi de 21 Nisan 2025'te tüm API sürümlerinde kullanımdan kaldırıldı; bunun yerine views isteyin.
  • crossposted_views ya da facebook_views alanlarını genel bir isteğe karıştırmak. Çapraz paylaşılmamış bir Reel için hata verirler ve bu hata çağrıyı başarısız kılar.
  • İzlenme süresinin birimini varsaymak. Meta, ig_reels_avg_watch_time ve ig_reels_video_view_total_time için bir birim belirtmez; bu nedenle bilinen bir Reel ile kontrol edin.
  • Boş bir sonucu sıfır saymak. Veri mevcut değilse ya da şu anda kullanılamıyorsa Meta boş bir veri kümesi döndürür.
Bunu EasyCoexistence'la yapmak

Bir metrik adı kaldırıldığında Meta'nın kendi hatası gösterilir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Reels içgörü isteği neden boş bir sonuç döndürür?

Veri mevcut değilse ya da şu anda kullanılamıyorsa Meta 0 değil boş bir veri kümesi döndürür; metriklerin arkasındaki veri de 48 saate kadar gecikebilir.

API'den Reel izlenme süresini nasıl alırım?

Ortalama için ig_reels_avg_watch_time, toplam için ig_reels_video_view_total_time isteyin; toplam, tekrar izlemeleri de içerir. Bunları GET /<IG_MEDIA_ID>/insights üzerinden alın.

reels_skip_rate nedir?

İlk görüntülemelerin ilk 3 saniyesinde Reel'i atlayan yüzdedir. Meta bunu 3 Aralık 2025'te ekledi ve tahmini, geliştirme aşamasında olarak etiketliyor.

Reels içgörüleri reklam görüntülemelerini içerir mi?

Hayır. likes, comments, views ve total_interactions yalnızca organik etkinliği sayar; tanıtılan medyayı da içeren total_views yalnızca Facebook Login ile sunulur.

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