Аналитика Reels в Instagram через API
Эндпоинт аналитики медиа Instagram, GET /<IG_MEDIA_ID>/insights, возвращает для Reel эти метрики: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time и reels_skip_rate, а также crossposted_views и facebook_views для Reel, опубликованного через кросс-постинг. plays, clips_replays_count и ig_reels_aggregated_all_plays_count сняты с поддержки в апреле 2025 года, вместо них используется views.
easyCoexistence читает аналитику Reel через get_social_insights, поэтому Claude, ChatGPT или ваш собственный код могут спросить, как прошёл Reel, и получить просмотры, охват, время просмотра и долю пропусков напрямую от Meta для подключённого аккаунта, с собственной ошибкой Meta, если название метрики снято.
Окно измерения reels_skip_rate: доля просмотров, при которых Reel пропустили в первые 3 секунды.
Когда plays, clips_replays_count и ig_reels_aggregated_all_plays_count перестали поддерживаться во всех версиях API.
Когда reels_skip_rate, reposts, crossposted_views и facebook_views добавили в аналитику медиа.
Насколько могут задерживаться данные, на которых основаны метрики медиа.
Как долго Meta хранит метрики медиа.
Какие метрики возвращает Reel?
Метрики из справочника Meta по media_product_type REELS, которые запрашиваются через GET /<IG_MEDIA_ID>/insights и параметр metric со списком через запятую. Meta помечает некоторые из них как оценочные или находящиеся в разработке (это указано рядом с каждой), а лайки и комментарии учитывает только как органическую активность:
Что возвращает запрос аналитики Reels?
Один объект на каждую метрику в data, у каждого есть name, period, values, title, description и id. period всегда равен lifetime: его задаёт Meta для метрик медиа, изменить нельзя, поэтому запрос его не требует. В справочнике Meta обе метрики времени просмотра описаны как промежутки времени без указания единицы измерения, поэтому перед построением графика сверьте их с Reel, который вы хорошо знаете.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}Какие метрики Reels сняты и чем они заменены?
Meta сняла с поддержки первые три метрики в Graph API v22.0 с 21 января 2025 года, в день появления views, и во всех версиях с 21 апреля 2025 года. video_views снята начиная с v21.0 и во всех версиях с 8 января 2025 года. Запрос, который называет снятую метрику, завершается ошибкой, поэтому список метрик, написанный до 2025 года, нужно обновить:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Что считают views и reach у Reel?
views: число воспроизведений Reel в Instagram, метрика, которую Meta помечает как находящуюся в разработке. reach: число уникальных аккаунтов, которые увидели его хотя бы раз, и Meta помечает её как оценочную. likes, comments, views и total_interactions учитывают только органическую активность, без взаимодействий с рекламой, созданной из Reel. total_likes, total_comments и total_views, которые включают продвигаемый контент, доступны только при Facebook Login.
Какие ограничения и задержки действуют?
Справочник Meta по аналитике медиа задаёт для чисел Reel следующие правила:
- Данные, на которых основаны метрики, могут задерживаться до 48 часов.
- Метрики медиа хранятся до 2 лет.
- При отсутствии или недоступности данных возвращается пустой набор data, а не 0.
crossposted_viewsиfacebook_viewsвызывают ошибку для Reel, не опубликованного через кросс-постинг, поэтому запрашивайте их отдельным вызовом.- Разбивка, которую не поддерживает запрошенная метрика, приводит к ошибке всего запроса: An unknown error has occurred.
- При входе через Instagram Login токен должен иметь
instagram_business_basicиinstagram_business_manage_insights, на graph.instagram.com.
Как get_social_insights читает Reel?
По account_id подключения, идентификатору медиа Reel как object_id и списку метрик. easyCoexistence вызывает GET /<IG_MEDIA_ID>/insights на graph.instagram.com с токеном аккаунта, передаёт названия метрик в Meta как есть и возвращает данные Meta или её собственную ошибку, если название метрики снято. list_social_posts возвращает идентификаторы медиа последних публикаций и Reel аккаунта.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}Распространённые ошибки
- Запрос plays или clips_replays_count. Обе метрики сняты во всех версиях API 21 апреля 2025 года; запрашивайте views.
- Добавление crossposted_views или facebook_views в общий запрос. Они вызывают ошибку для Reel, не опубликованного через кросс-постинг, и из-за неё весь вызов завершается неудачей.
- Предположение о единице измерения времени просмотра. Meta не называет единицу для ig_reels_avg_watch_time и ig_reels_video_view_total_time, поэтому проверяйте на известном Reel.
- Трактовка пустого результата как нуля. Meta возвращает пустой набор data, когда данных нет или они временно недоступны.
От US$ 9 до US$ 0,75 за подключение в месяц, с падением по мере добавления подключений, с бесплатным пробным периодом в 3 дня.
Часто задаваемые вопросы
Почему запрос аналитики Reels возвращает пустой результат?
Meta возвращает пустой набор data, а не 0, когда данных нет или они временно недоступны, а данные, на которых основаны метрики, могут отставать до 48 часов.
Как получить время просмотра Reels через API?
Запросите ig_reels_avg_watch_time для среднего значения и ig_reels_video_view_total_time для общего, с учётом повторных просмотров, через GET /<IG_MEDIA_ID>/insights.
Что такое reels_skip_rate?
Доля первых просмотров, при которых Reel пропустили в первые 3 секунды. Meta добавила метрику 3 декабря 2025 года и помечает её как оценочную и находящуюся в разработке.
Учитывает ли аналитика Reels просмотры рекламы?
Нет. likes, comments, views и total_interactions учитывают только органическую активность; total_views, включающий продвигаемый контент, доступен только при Facebook Login.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на