Instagram Story insights through the API
Instagram's media insights endpoint returns these metrics for a Story while it is up: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts and total_interactions. navigation breaks down by story_navigation_action_type into TAP_FORWARD, TAP_BACK, TAP_EXIT and SWIPE_FORWARD. Story metrics are available for 24 hours, values under 5 return error 10, and Instagram Login has no story_insights webhook.
easyCoexistence reads a Story's insights with get_social_insights while it is up, so Claude, ChatGPT or your own code can ask how today's Stories did and get reach, views, replies, shares and navigation straight from Meta for the connected account.
How long Story media metrics are available through the API.
Returned instead of a value when a Story metric is under 5: not enough viewers for the media to show insights.
The only setup Meta's insights guide gives the story_insights webhook; it is not supported with Instagram Login.
The replies value for a Story created by an account in Europe or Japan.
When Meta added link_clicks for Stories, counting taps on links such as link stickers, for Facebook Login only.
Which metrics does a Story return?
Those Meta's media insights reference lists for media_product_type STORY, read with GET /<STORY_MEDIA_ID>/insights while the Story is up. With Instagram Login the call goes to graph.instagram.com with a token holding instagram_business_basic and instagram_business_manage_insights, and period is always lifetime:
How do you read navigation by action?
Request navigation on its own with breakdown=story_navigation_action_type. The total comes back in total_value.value and each action in total_value.breakdowns[].results, which add up to it: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) and SWIPE_FORWARD (Next Story). Meta's sample response writes the values in lower case:
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"
}
]
}How long are Story metrics available?
24 hours. Meta makes Story media metrics available for 24 hours only, the Story's own life, while the data behind them can lag by up to 48 hours. Read them on a schedule while the Story is up and keep the last values you got. Meta notes that data may still arrive after a Story expires if it is added to a highlight, and that API calls, webhooks and the app can then show different results.
Why does a Story metric return error 10?
Because its value is under 5. Meta returns error code 10 with the message (#10) Not enough viewers for the media to show insights instead of a small number, so a Story seen by few people can fail where a busier one succeeds. Treat it as a low count rather than an outage, and do not retry it in a loop.
Why are a Story's replies 0?
Regional rules. Replies from people in Europe, since 1 December 2020, and in Japan, since 14 April 2021, are left out of the replies metric, and a Story created by an account in one of those regions returns 0. Meta's reference defines replies as IG Comments on the Story media object.
Is there a story_insights webhook?
Not with Instagram Login. Meta's fields table marks story_insights unavailable there, its media insights reference says the insights webhook is not supported with Instagram Login, and its insights guide lists story_insights for Facebook Login only. With Facebook Login the field fires when a Story expires, carries only its first 24 hours of metrics, and returns counts under 5 as -1.
Which Story metrics are retired or limited?
A few names still appear in old code or in Meta's changelog:
- impressions: deprecated for media created after 2 July 2024, so a current Story reports views instead.
taps_forward,taps_backand exits: retired on 11 December 2023; navigation, broken down bystory_navigation_action_type, reports the same actions.link_clicks: taps on links such as link stickers, added on 22 June 2026 for Facebook Login only.total_views: views across surfaces, promoted media included, offered with Facebook Login only.
How does get_social_insights read a Story?
With the Story's media ID as object_id, which publish_instagram_post returns as media_id when it publishes the Story, and the metrics as a list. Ask for navigation in a separate call with params set to breakdown story_navigation_action_type, since a breakdown that one requested metric does not support fails the whole call. Meta's errors, error 10 included, come back as Meta wrote them.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Common mistakes
- Reading a Story's metrics the next day. Meta makes them available for 24 hours only, so collect them while the Story is up.
- Retrying error 10 in a loop. It means a value under 5, not enough viewers, and will not change until more people see the Story.
- Asking for navigation with a breakdown next to other metrics. story_navigation_action_type works with navigation only, and an unsupported breakdown fails the whole call.
- Waiting for story_insights with Instagram Login. Meta does not offer that webhook there, so poll the insights endpoint before the Story expires.
Stories go out with publish_instagram_post. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Do Story insights change after a Story is added to a highlight?
They can. Meta says a Story added to a highlight may keep receiving data after it expires, so the API, webhooks and the app can disagree for a while.
Does total_views work for Stories with Instagram Login?
No. total_views, which counts views across surfaces with promoted media included, is offered with Facebook Login only; with Instagram Login, request views.
Can the API read link sticker clicks on an Instagram Story?
With Facebook Login only. Meta added link_clicks for Stories on 22 June 2026, counting taps on links such as link stickers, and does not offer it with Instagram Login.
What replaced taps_forward, taps_back and exits?
navigation, broken down by story_navigation_action_type into TAP_FORWARD, TAP_BACK, TAP_EXIT and SWIPE_FORWARD. The old metrics were retired on 11 December 2023.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on