Инсайты сторис в Instagram через API
Эндпоинт медиа-инсайтов Instagram возвращает для сторис, пока она активна, метрики: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts и total_interactions. navigation разбивается по story_navigation_action_type на TAP_FORWARD, TAP_BACK, TAP_EXIT и SWIPE_FORWARD. Метрики сторис доступны в течение 24 часов, значения меньше 5 возвращают ошибку 10, а у Instagram Login нет вебхука story_insights.
easyCoexistence читает инсайты сторис через get_social_insights, пока она активна, поэтому Claude, ChatGPT или ваш собственный код могут спросить, как прошли сегодняшние сторис, и получить охват, просмотры, ответы, пересылки и навигацию напрямую от Meta для подключённого аккаунта.
Срок, в течение которого метрики сторис доступны через API.
Значение, которое вместо числа возвращается, когда метрика сторис меньше 5: зрителей недостаточно, чтобы медиа показало инсайты.
Единственная настройка вебхука story_insights, которую приводит руководство Meta по инсайтам; с Instagram Login он не поддерживается.
Значение replies для сторис, созданной аккаунтом в Европе или Японии.
Когда Meta добавила link_clicks для сторис: подсчёт нажатий по ссылкам, например по стикерам со ссылкой, только для Facebook Login.
Какие метрики возвращает сторис?
Те, что медиа-справочник Meta перечисляет для media_product_type STORY, читаются через GET /<STORY_MEDIA_ID>/insights, пока сторис активна. При Instagram Login запрос идёт на graph.instagram.com с токеном, в котором есть instagram_business_basic и instagram_business_manage_insights, а period всегда равен lifetime:
Как читать навигацию по действиям?
Запросите navigation отдельно с breakdown=story_navigation_action_type. Итог приходит в total_value.value, а каждое действие в total_value.breakdowns[].results, и они в сумме дают итог: TAP_FORWARD («Вперёд»), TAP_BACK («Назад»), TAP_EXIT («Выход») и SWIPE_FORWARD («Следующая сторис»). В примере ответа Meta значения записаны строчными буквами:
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"
}
]
}Сколько времени доступны метрики сторис?
24 часа. Meta делает метрики медиа сторис доступными только 24 часа, на время жизни самой сторис, хотя данные, на которых они основаны, могут отставать до 48 часов. Читайте их по расписанию, пока сторис активна, и сохраняйте последние полученные значения. Meta отмечает, что данные могут поступать и после истечения сторис, если она добавлена в актуальное, и тогда вызовы API, вебхуки и приложение могут показывать разные результаты.
Почему метрика сторис возвращает ошибку 10?
Потому что её значение меньше 5. Meta возвращает код ошибки 10 с сообщением (#10) Not enough viewers for the media to show insights вместо маленького числа, поэтому сторис, которую увидели несколько человек, может не вернуть данные, тогда как более популярная сработает. Считайте это низким числом просмотров, а не сбоем, и не повторяйте попытку в цикле.
Почему у сторис replies равны 0?
Региональные правила. Ответы от людей в Европе, начиная с 1 декабря 2020 г., и в Японии, начиная с 14 апреля 2021 г., не учитываются в метрике replies, поэтому сторис, созданная аккаунтом в одном из этих регионов, возвращает 0. Справочник Meta определяет replies как IG Comments на медиа-объекте сторис.
Есть ли вебхук story_insights?
Не с Instagram Login. В таблице полей Meta story_insights помечен как недоступный, в справочнике медиа-инсайтов сказано, что вебхук инсайтов с Instagram Login не поддерживается, а руководство по инсайтам указывает story_insights только для Facebook Login. С Facebook Login поле срабатывает, когда сторис истекает, передаёт только первые 24 часа метрик и возвращает значения меньше 5 как -1.
Какие метрики сторис выведены из употребления или ограничены?
Некоторые названия ещё встречаются в старом коде или в журнале изменений Meta:
- impressions: устарела для медиа, созданных после 2 июля 2024 г., поэтому актуальная сторис вместо неё отдаёт views.
taps_forward,taps_backи exits: выведены из употребления 11 декабря 2023 г.; navigation с разбивкой поstory_navigation_action_typeвозвращает те же действия.link_clicks: нажатия по ссылкам, например по стикерам-ссылкам, добавлены 22 июня 2026 г. только для Facebook Login.total_views: просмотры на всех поверхностях, включая продвигаемые медиа, доступны только с Facebook Login.
Как get_social_insights читает сторис?
По ID медиа сторис как object_id, который publish_instagram_post возвращает как media_id при публикации сторис, а метрики передаются списком. Запросите navigation отдельным вызовом, с параметрами, где breakdown равен story_navigation_action_type, потому что неподдерживаемая разбивка ломает весь вызов. Ошибки Meta, включая ошибку 10, приходят в том виде, в котором их написала Meta.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Распространённые ошибки
- Чтение метрик сторис на следующий день. Meta делает их доступными только 24 часа, поэтому собирайте их, пока сторис активна.
- Повторение ошибки 10 в цикле. Она означает значение меньше 5, то есть зрителей недостаточно, и не изменится, пока сторис не увидит больше людей.
- Запрос navigation с разбивкой рядом с другими метриками. story_navigation_action_type работает только с navigation, а неподдерживаемая разбивка ломает весь вызов.
- Ожидание story_insights с Instagram Login. Meta не предлагает этот вебхук там, поэтому опрашивайте эндпоинт инсайтов до истечения сторис.
Публиковать сторис можно через publish_instagram_post. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Меняются ли инсайты сторис после добавления в актуальное?
Могут. Meta говорит, что сторис, добавленная в актуальное, может продолжать получать данные после истечения срока, поэтому API, вебхуки и приложение какое-то время могут расходиться.
Работает ли total_views для сторис с Instagram Login?
Нет. total_views, который считает просмотры на всех поверхностях, включая продвигаемые медиа, доступен только с Facebook Login; с Instagram Login запрашивайте views.
Может ли API читать клики по стикерам-ссылкам в сторис Instagram?
Только с Facebook Login. Meta добавила link_clicks для сторис 22 июня 2026 г., этот показатель считает нажатия по ссылкам, например по стикерам-ссылкам, и не предлагается с Instagram Login.
Что пришло на смену taps_forward, taps_back и exits?
navigation с разбивкой по story_navigation_action_type на TAP_FORWARD, TAP_BACK, TAP_EXIT и SWIPE_FORWARD. Старые метрики выведены из употребления 11 декабря 2023 г.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на