Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Uvidi Instagram Storyja putem API-ja

Instagramov endpoint za uvide medija vraća ove metrike za Story dok je aktivan: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts i total_interactions. navigation se po story_navigation_action_type razlaže na TAP_FORWARD, TAP_BACK, TAP_EXIT i SWIPE_FORWARD. Metrike Storyja dostupne su 24 sata, vrijednosti manje od 5 vraćaju pogrešku 10, a Instagram Login nema webhook story_insights.

easyCoexistence čita uvide Storyja pomoću get_social_insights dok je Story aktivan, pa Claude, ChatGPT ili vaš vlastiti kod mogu pitati kako su prošli današnji Storyji i odmah dobiti doseg, prikaze, odgovore, dijeljenja i navigaciju izravno od Mete za povezani račun.

24 hours

Koliko dugo su metrike medija Storyja dostupne putem API-ja.

Error 10

Vraća se umjesto vrijednosti kad je metrika Storyja manja od 5: premalo gledatelja da bi medij prikazao uvide.

Facebook Login

Jedina postavka koju vodič za uvide tvrtke Meta navodi za webhook story_insights; nije podržan uz Instagram Login.

0

Vrijednost replies za Story koji je stvoren s računa u Europi ili Japanu.

22 Jun 2026

Kad je Meta dodala link_clicks za Storyje, koji broji dodire na poveznice poput naljepnica s poveznicom, samo za Facebook Login.

Koje metrike vraća Story?

One koje referenca tvrtke Meta za media_product_type STORY navodi za media insights, čitane pozivom GET /<STORY_MEDIA_ID>/insights dok je Story aktivan. Uz Instagram Login poziv ide na graph.instagram.com s tokenom koji ima instagram_business_basic i instagram_business_manage_insights, a period je uvijek lifetime:

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.

Kako se čita navigacija po radnji?

Zatražite navigation zasebno uz breakdown=story_navigation_action_type. Ukupno dolazi u total_value.value, a svaka radnja u total_value.breakdowns[].results, koje zbrojene daju taj iznos: TAP_FORWARD (Naprijed), TAP_BACK (Nazad), TAP_EXIT (Izlaz) i SWIPE_FORWARD (Sljedeći Story). Primjer odgovora tvrtke Meta piše vrijednosti malim slovima:

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"
    }
  ]
}

Koliko dugo su metrike Storyja dostupne?

24 sata. Meta metrike medija Storyja čini dostupnima samo 24 sata, dakle samo koliko traje sam Story, dok podaci iza njih mogu kasniti do 48 sati. Čitajte ih po rasporedu dok je Story aktivan i zadržite zadnje dobivene vrijednosti. Meta napominje da podaci mogu stići i nakon isteka Storyja ako se doda u istaknute priče, pa se pozivi API-ja, webhookovi i aplikacija tada mogu razlikovati.

Zašto metrika Storyja vraća pogrešku 10?

Zato što je njezina vrijednost manja od 5. Meta vraća kôd pogreške 10 s porukom (#10) Nema dovoljno gledatelja da bi medij prikazao uvide, umjesto malog broja, pa Story koji je vidjelo malo ljudi može pasti tamo gdje posjećeniji uspije. Shvatite to kao mali broj, a ne kao prekid rada, i ne ponavljajte zahtjev u petlji.

Zašto su replies Storyja 0?

Regionalna pravila. Odgovori od ljudi u Europi, od 1. prosinca 2020., i u Japanu, od 14. travnja 2021., ne ulaze u metriku replies, pa Story koji je stvorio račun u jednoj od tih regija vraća 0. Referenca tvrtke Meta replies definira kao IG Comments na media objektu Storyja.

Postoji li webhook story_insights?

Ne uz Instagram Login. Tablica polja tvrtke Meta označava story_insights kao nedostupan tamo, referenca za media insights kaže da webhook za uvide nije podržan uz Instagram Login, a vodič za uvide navodi story_insights samo za Facebook Login. Uz Facebook Login polje se aktivira kad Story istekne, nosi samo prvih 24 sata metrika, a vrijednosti manje od 5 vraća kao -1.

Koje metrike Storyja su ukinute ili ograničene?

Neki nazivi još se pojavljuju u starom kodu ili u popisu promjena tvrtke Meta:

  • impressions: zastarjela za medije stvorene nakon 2. srpnja 2024., pa aktualni Story umjesto toga prijavljuje views.
  • taps_forward, taps_back i exits: ukinute 11. prosinca 2023.; navigation, razložena po story_navigation_action_type, prijavljuje iste radnje.
  • link_clicks: dodiri na poveznice poput naljepnica s poveznicom, dodani 22. lipnja 2026. samo za Facebook Login.
  • total_views: prikazi na svim površinama, uključujući promovirane medije, dostupni samo uz Facebook Login.

Kako get_social_insights čita Story?

Uz ID medija Storyja kao object_id, koji publish_instagram_post vraća kao media_id kad objavi Story, a metrike kao popis. Navigaciju zatražite u zasebnom pozivu s params postavljenim na breakdown story_navigation_action_type, jer breakdown koji jedna zatražena metrika ne podržava obara cijeli poziv. Pogreške tvrtke Meta, uključujući pogrešku 10, vraćaju se točno onako kako ih je Meta napisala.

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

Uobičajene pogreške

  • Čitanje metrika Storyja sutradan. Meta ih čini dostupnima samo 24 sata, pa ih prikupljajte dok je Story aktivan.
  • Ponavljanje pogreške 10 u petlji. Ona znači vrijednost manju od 5, premalo gledatelja, i neće se promijeniti dok Story ne vidi više ljudi.
  • Traženje navigacije s breakdownom uz druge metrike. story_navigation_action_type radi samo s navigacijom, a nepodržani breakdown obara cijeli poziv.
  • Čekanje story_insights uz Instagram Login. Meta tamo ne nudi taj webhook, pa redovito pozivajte endpoint za uvide prije isteka Storyja.
Radite ovo uz EasyCoexistence

Storyji se objavljuju pomoću publish_instagram_post. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.

Često postavljana pitanja

Mijenjaju li se uvidi Storyja nakon što se doda u istaknute priče?

Mogu. Meta kaže da Story dodan u istaknute priče može i nakon isteka nastaviti primati podatke, pa se API, webhookovi i aplikacija neko vrijeme mogu razlikovati.

Radi li total_views za Storyje uz Instagram Login?

Ne. total_views, koji broji prikaze na svim površinama uključujući promovirane medije, nudi se samo uz Facebook Login; uz Instagram Login zatražite views.

Može li API čitati klikove na naljepnicu s poveznicom na Instagram Storyju?

Samo uz Facebook Login. Meta je 22. lipnja 2026. dodala link_clicks za Storyje, koji broji dodire na poveznice poput naljepnica s poveznicom, a uz Instagram Login ga ne nudi.

Što je zamijenilo taps_forward, taps_back i exits?

navigation, razložena po story_navigation_action_type na TAP_FORWARD, TAP_BACK, TAP_EXIT i SWIPE_FORWARD. Stare metrike ukinute su 11. prosinca 2023.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na