Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram Story insights sa pamamagitan ng API

Ang media insights endpoint ng Instagram ay nagbabalik ng mga metric na ito para sa isang Story habang aktibo ito: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts at total_interactions. Nahahati ang navigation ayon sa story_navigation_action_type sa TAP_FORWARD, TAP_BACK, TAP_EXIT at SWIPE_FORWARD. Available ang Story metrics sa loob ng 24 oras, ang mga value na mas mababa sa 5 ay nagbabalik ng error 10, at walang story_insights webhook sa Instagram Login.

Binabasa ng easyCoexistence ang insights ng Story gamit ang get_social_insights habang aktibo ito, kaya maitatanong ng Claude, ChatGPT o sarili ninyong code kung paano nag-perform ang mga Story ngayong araw, at makukuha ang reach, views, replies, shares at navigation nang direkta mula sa Meta para sa naka-connect na account.

24 hours

Gaano katagal available ang Story media metrics sa pamamagitan ng API.

Error 10

Ibinabalik sa halip na value kapag mas mababa sa 5 ang isang Story metric: kulang ang viewers para magpakita ng insights ang media.

Facebook Login

Ang tanging setup na ibinibigay ng gabay ng Meta sa insights para sa story_insights webhook; hindi ito suportado sa Instagram Login.

0

Ang replies value para sa Story na ginawa ng account sa Europe o Japan.

22 Jun 2026

Nang idagdag ng Meta ang link_clicks para sa Stories, na nagbibilang ng tap sa mga link tulad ng link sticker, para sa Facebook Login lamang.

Aling metric ang ibinabalik ng isang Story?

Ang mga nakalista sa reference ng Meta para sa media insights na may media_product_type STORY, na binabasa gamit ang GET /<STORY_MEDIA_ID>/insights habang aktibo ang Story. Sa Instagram Login, napupunta ang tawag sa graph.instagram.com na may token na may instagram_business_basic at instagram_business_manage_insights, at palaging lifetime ang period:

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.

Paano binabasa ang navigation ayon sa aksyon?

I-request ang navigation nang mag-isa gamit ang breakdown=story_navigation_action_type. Lalabas ang kabuuan sa total_value.value at ang bawat aksyon sa total_value.breakdowns[].results, na nagdadagdag hanggang sa kabuuan: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) at SWIPE_FORWARD (Next Story). Naka-lowercase ang mga value sa halimbawang sagot ng Meta:

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

Gaano katagal available ang Story metrics?

24 oras. Available lamang ang Story media metrics sa loob ng 24 oras, ang sariling buhay ng Story, habang maaaring mahuli ang data sa likod nito ng hanggang 48 oras. Basahin ang mga ito ayon sa iskedyul habang aktibo ang Story at itabi ang huling mga value na nakuha ninyo. Sinasabi ng Meta na maaaring dumating pa rin ang data pagkatapos mag-expire ng Story kung idinagdag ito sa highlight, at maaaring magpakita ng magkaibang resulta ang API calls, webhooks at ang app.

Bakit nagbabalik ng error 10 ang isang Story metric?

Dahil mas mababa sa 5 ang value nito. Nagbabalik ang Meta ng error code 10 na may mensaheng (#10) Not enough viewers for the media to show insights sa halip na maliit na numero, kaya maaaring pumalya ang Story na napanood ng kaunting tao habang nagtagumpay ang mas maraming napanood. Ituring itong mababang bilang at hindi outage, at huwag itong i-retry nang paulit-ulit.

Bakit 0 ang replies ng isang Story?

Mga panuntunan ayon sa rehiyon. Hindi kasama sa replies metric ang mga reply mula sa mga tao sa Europe mula 1 Disyembre 2020, at sa Japan mula 14 Abril 2021, kaya nagbabalik ng 0 ang Story na ginawa ng account sa isa sa mga rehiyong iyon. Tinutukoy ng reference ng Meta ang replies bilang IG Comments sa Story media object.

May story_insights webhook ba?

Wala sa Instagram Login. Minarkahan ng fields table ng Meta na hindi available doon ang story_insights, sinasabi ng media insights reference nito na hindi suportado ang insights webhook sa Instagram Login, at nakalista ang story_insights sa gabay nito sa insights para sa Facebook Login lamang. Sa Facebook Login, nag-trigger ang field kapag nag-expire ang Story, dala lamang ang unang 24 oras ng metrics, at ibinabalik bilang -1 ang mga bilang na mas mababa sa 5.

Aling Story metrics ang retired o limitado na?

May ilang pangalan na lumalabas pa rin sa lumang code o sa changelog ng Meta:

  • impressions: deprecated para sa media na ginawa pagkatapos ng 2 Hulyo 2024, kaya ang kasalukuyang Story ay nag-uulat ng views.
  • taps_forward, taps_back at exits: retired noong 11 Disyembre 2023; ang navigation, na nahahati ayon sa story_navigation_action_type, ay nag-uulat ng parehong aksyon.
  • link_clicks: tap sa mga link tulad ng link sticker, idinagdag noong 22 Hunyo 2026 para sa Facebook Login lamang.
  • total_views: views sa lahat ng surface, kasama ang promoted media, available sa Facebook Login lamang.

Paano binabasa ng get_social_insights ang isang Story?

Gamit ang media ID ng Story bilang object_id, na ibinabalik ng publish_instagram_post bilang media_id kapag ini-publish nito ang Story, at ang mga metric bilang listahan. Humiling ng navigation sa hiwalay na tawag na may params na nakatakda sa breakdown story_navigation_action_type, dahil kapag hindi sinusuportahan ng isang requested metric ang breakdown, pumapalya ang buong tawag. Ibinabalik ang mga error ng Meta, kasama ang error 10, gaya ng pagkakasulat ng Meta.

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

Mga karaniwang pagkakamali

  • Pagbasa sa metrics ng Story kinabukasan. Available lamang ang mga ito sa loob ng 24 oras ayon sa Meta, kaya kolektahin habang aktibo ang Story.
  • Paulit-ulit na pag-retry sa error 10. Ibig sabihin nito ay value na mas mababa sa 5, kulang ang viewers, at hindi ito magbabago hangga't hindi mas maraming tao ang nakakakita ng Story.
  • Paghingi ng navigation kasama ng breakdown na katabi ng ibang metrics. Gumagana ang story_navigation_action_type sa navigation lamang, at pumapalya ang buong tawag kapag hindi suportado ang breakdown.
  • Paghihintay sa story_insights gamit ang Instagram Login. Hindi ito inaalok ng Meta doon, kaya i-poll ang insights endpoint bago mag-expire ang Story.
Ginagawa ito gamit ang EasyCoexistence

Ipinapadala ang mga Story gamit ang publish_instagram_post. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, kasama ang unang 3 araw na free trial.

Mga madalas itanong

Nagbabago ba ang Story insights kapag idinagdag ang Story sa highlight?

Maaari. Sinasabi ng Meta na maaaring patuloy na tumanggap ng data ang Story na idinagdag sa highlight pagkatapos mag-expire, kaya maaaring magkaiba ang API, webhooks at ang app sa loob ng ilang panahon.

Gumagana ba ang total_views para sa Stories gamit ang Instagram Login?

Hindi. Ang total_views, na nagbibilang ng views sa lahat ng surface kasama ang promoted media, ay inaalok sa Facebook Login lamang; sa Instagram Login, humiling ng views.

Mababasa ba ng API ang link sticker clicks sa Instagram Story?

Sa Facebook Login lamang. Idinagdag ng Meta ang link_clicks para sa Stories noong 22 Hunyo 2026, na nagbibilang ng tap sa mga link tulad ng link sticker, at hindi ito inaalok sa Instagram Login.

Ano ang pumalit sa taps_forward, taps_back at exits?

Ang navigation, na nahahati ayon sa story_navigation_action_type sa TAP_FORWARD, TAP_BACK, TAP_EXIT at SWIPE_FORWARD. Na-retire ang lumang metrics noong 11 Disyembre 2023.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong