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

Instagram Story içgörüleri API ile

Instagram'ın medya içgörüleri uç noktası, Story yayındayken şu metrikleri döndürür: erişim, görüntüleme, yanıtlar, paylaşımlar, gezinme, takipler, profile_visits, profile_activity, yeniden paylaşımlar ve total_interactions. navigation, story_navigation_action_type alanına göre TAP_FORWARD, TAP_BACK, TAP_EXIT ve SWIPE_FORWARD olarak ayrılır. Story metrikleri 24 saat boyunca kullanılabilir, 5'in altındaki değerler hata 10 döndürür ve Instagram Login ile story_insights webhook'u yoktur.

easyCoexistence, Story yayında olduğu sürece bir Story'nin içgörülerini get_social_insights ile okur; böylece Claude, ChatGPT veya kendi kodunuz bugünkü Story'lerin nasıl geçtiğini sorabilir ve bağlı hesap için erişim, görüntüleme, yanıt, paylaşım ve gezinmeyi doğrudan Meta'dan alır.

24 hours

Story medya metriklerinin API üzerinden ne kadar süre kullanılabilir olduğu.

Error 10

Bir Story metriği 5'in altındayken değer yerine döndürülen şey: medyanın içgörü gösterebilmesi için yeterli izleyici yok.

Facebook Login

Meta'nın içgörü kılavuzunun story_insights webhook'u için verdiği tek kurulum; Instagram Login ile desteklenmez.

0

Avrupa veya Japonya'da bir hesap tarafından oluşturulan Story'nin yanıt değeri.

22 Jun 2026

Meta, Story'ler için link_clicks metriğini eklediğinde link çıkartmaları gibi bağlantılara yapılan dokunuşları sayar; yalnızca Facebook Login için.

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

Meta'nın media_product_type STORY için listelediği medya içgörüleri referansındaki metrikler; Story yayında iken GET /<STORY_MEDIA_ID>/insights ile okunur. Instagram Login ile çağrı graph.instagram.com adresine gider, instagram_business_basic ve instagram_business_manage_insights izinlerini taşıyan token ile yapılır ve period her zaman lifetime olur:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Navigation, eylemlere göre nasıl okunur?

navigation'ı breakdown=story_navigation_action_type ile tek başına isteyin. Toplam total_value.value içinde gelir, her eylem total_value.breakdowns[].results içinde gelir ve bunlar toplamı oluşturur: TAP_FORWARD (İleri), TAP_BACK (Geri), TAP_EXIT (Çıkış) ve SWIPE_FORWARD (Sonraki Story). Meta'nın örnek yanıtı değerleri küçük harflerle yazar:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Story metrikleri ne kadar süre kullanılabilir?

24 saat. Meta, Story medya metriklerini yalnızca 24 saat boyunca kullanılabilir yapar, yani Story'nin kendi ömrü boyunca; bu metriklerin arkasındaki veriler ise 48 saate kadar gecikebilir. Story yayındayken bunları bir zamanlamaya göre okuyun ve aldığınız son değerleri saklayın. Meta, Story öne çıkanlara (highlight) eklenirse süresi dolduktan sonra da veri gelebileceğini ve bu durumda API çağrılarının, webhook'ların ve uygulamanın farklı sonuçlar gösterebileceğini belirtir.

Bir Story metriği neden hata 10 döndürür?

Değeri 5'in altında olduğu için. Meta, küçük bir sayı yerine hata kodu 10 ve (#10) Not enough viewers for the media to show insights mesajını döndürür; bu yüzden az kişinin gördüğü bir Story başarısız olabilirken daha kalabalık bir Story başarılı olabilir. Bunu bir kesinti değil, düşük bir sayı olarak değerlendirin ve döngüye sokup tekrar denemeyin.

Bir Story'nin yanıtları neden 0?

Bölgesel kurallar. 1 Aralık 2020'den beri Avrupa'daki ve 14 Nisan 2021'den beri Japonya'daki kişilerden gelen yanıtlar replies metriğinin dışında bırakılır; bu bölgelerden birinde bir hesap tarafından oluşturulan Story 0 döndürür. Meta'nın referansı replies metriğini, Story medya nesnesi üzerindeki IG Comments olarak tanımlar.

story_insights webhook'u var mı?

Instagram Login ile yok. Meta'nın alan tablosu story_insights'ı orada kullanılamaz olarak işaretler, medya içgörüleri referansı içgörü webhook'unun Instagram Login ile desteklenmediğini söyler ve içgörü kılavuzu story_insights'ı yalnızca Facebook Login için listeler. Facebook Login ile alan, bir Story'nin süresi dolduğunda tetiklenir, yalnızca ilk 24 saatin metriklerini taşır ve 5'in altındaki sayıları -1 olarak döndürür.

Hangi Story metrikleri kaldırıldı veya sınırlandı?

Bazı adlar hâlâ eski kodda veya Meta'nın değişiklik günlüğünde görünür:

  • impressions: 2 Temmuz 2024'ten sonra oluşturulan medya için kullanımdan kaldırıldı; bu yüzden güncel bir Story bunun yerine views bildirir.
  • taps_forward, taps_back ve exits: 11 Aralık 2023'te kaldırıldı; story_navigation_action_type'a göre ayrılmış navigation aynı eylemleri bildirir.
  • link_clicks: link çıkartmaları gibi bağlantılara yapılan dokunuşlar, 22 Haziran 2026'da yalnızca Facebook Login için eklendi.
  • total_views: promosyonlu medya dahil, tüm yüzeylerdeki görüntülemeler; yalnızca Facebook Login ile sunulur.

get_social_insights bir Story'yi nasıl okur?

Story'nin medya ID'sini object_id olarak kullanır; bu ID, publish_instagram_post Story'yi yayınlarken media_id olarak döndürür, metrikler ise bir liste olarak gelir. navigation'ı ayrı bir çağrıda, params alanında breakdown story_navigation_action_type olarak isteyin; çünkü tek bir istenen metriğin desteklemediği bir breakdown tüm çağrıyı başarısız kılar. Meta'nın hataları, hata 10 dahil, Meta'nın yazdığı gibi döner.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Yaygın hatalar

  • Bir Story'nin metriklerini ertesi gün okumak. Meta bunları yalnızca 24 saat kullanılabilir yapar, bu yüzden Story yayındayken toplayın.
  • Hata 10'u döngüde tekrar denemek. Bu, 5'in altındaki bir değer ve yeterli izleyici yok anlamına gelir; daha fazla kişi Story'yi görene kadar değişmez.
  • Navigation'ı diğer metriklerin yanında bir breakdown ile istemek. story_navigation_action_type yalnızca navigation ile çalışır ve desteklenmeyen bir breakdown tüm çağrıyı başarısız kılar.
  • Instagram Login ile story_insights webhook'unu beklemek. Meta bu webhook'u orada sunmaz; bu yüzden Story süresi dolmadan içgörü uç noktasını sorgulayın.
Bunu EasyCoexistence'la yapmak

Story'ler publish_instagram_post ile yayınlanır. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında; bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Story öne çıkanlara (highlight) eklenince içgörüler değişir mi?

Değişebilir. Meta, öne çıkanlara eklenen bir Story'nin süresi dolduktan sonra da veri almaya devam edebileceğini söyler; bu yüzden API, webhook'lar ve uygulama bir süre farklı sonuçlar gösterebilir.

Instagram Login ile Story'ler için total_views çalışır mı?

Hayır. Promosyonlu medya dahil tüm yüzeylerdeki görüntülemeleri sayan total_views yalnızca Facebook Login ile sunulur; Instagram Login ile views isteyin.

API, bir Instagram Story'deki link tıklamalarını okuyabilir mi?

Yalnızca Facebook Login ile. Meta, 22 Haziran 2026'da Story'ler için link_clicks metriğini ekledi; bu metrik link çıkartmaları gibi bağlantılara yapılan dokunuşları sayar ve Instagram Login ile sunulmaz.

taps_forward, taps_back ve exits'in yerini neler aldı?

navigation aldı; story_navigation_action_type'a göre TAP_FORWARD, TAP_BACK, TAP_EXIT ve SWIPE_FORWARD olarak ayrılır. Eski metrikler 11 Aralık 2023'te kaldırıldı.

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