Статистика Instagram через API: метрики аккаунта и постов
API Instagram возвращает статистику для профессионального аккаунта и каждого его поста, Reels и Stories. Метрики аккаунта включают охват, просмотры, аккаунты с взаимодействиями, подписки и отписки, лайки, комментарии, сохранения и отправки; метрики постов включают охват, просмотры, лайки, комментарии, сохранения и отправки. Meta отмечает, что данные могут отставать до 48 часов.
easyCoexistence читает статистику Instagram через get_social_insights, поэтому можно спросить Claude или ChatGPT, как прошли посты за прошлую неделю, и получить охват, просмотры, лайки, комментарии, сохранения и отправки напрямую из Meta, для аккаунта или отдельного поста.
Насколько могут задерживаться данные, на которых основана статистика Instagram.
Ниже 100 подписчиков не возвращаются подписки, отписки и демография подписчиков аккаунта.
Как долго Meta хранит метрики медиа.
Как долго метрики Stories остаются доступными через API.
Когда impressions перестал работать во всех версиях API, кроме медиа, созданных до 2 июля 2024 года; его заменил views.
Какие метрики аккаунта доступны?
Читаются через GET /<IG_ID>/insights, в основном с period=day и metric_type=total_value:
- reach: уникальные аккаунты, которые увидели контент, включая рекламу; оценка.
- views: сколько раз контент был воспроизведён или показан.
accounts_engaged: аккаунты, которые взаимодействовали с контентом, включая рекламу; оценка.follows_and_unfollows: подписки и отписки за период; нужно не менее 100 подписчиков.- likes, comments, saves, shares, replies и reposts, а также
total_interactions. profile_links_taps: нажатия на кнопки адреса бизнеса, звонка, e-mail и текстового сообщения.follower_demographicsиengaged_audience_demographics: возраст, город, страна и пол.
Какие метрики доступны для постов?
Читаются через GET /<IG_MEDIA_ID>/insights; набор метрик зависит от формата. Для поста или Reels лайки, комментарии, views и total_interactions учитывают только органическую активность, без взаимодействий с рекламой, созданной на их основе.
- Посты и Reels: reach, views, likes, comments, saved, shares,
total_interactionsи reposts. - Только Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeиreels_skip_rate. - Посты и Stories: follows,
profile_visitsиprofile_activity. - Stories: reach, views, shares, replies, navigation, reposts и
total_interactions.
Как работают period, metric_type и разбивки?
Метрики аккаунта принимают period=day. metric_type=total_value возвращает одно значение за период и нужен для разбивок; time_series возвращает значение за каждый день и доступен для reach. Разбивки делят итог по media_product_type (посты, карусели, Reels, Stories и реклама), по follow_type (подписчики или нет) или по contact_button_type.
Демографические метрики принимают период, например this_week или this_month, вместо since и until; без since и until остальные метрики берут данные за последние 24 часа. Запрос разбивки, которую не поддерживает одна из запрошенных метрик, завершается неизвестной ошибкой для всего запроса.
Какие пороги и задержки действуют?
Правила Meta о том, когда появляется число и как долго оно остаётся доступным:
- Данные могут задерживаться до 48 часов.
- У аккаунтов с менее чем 100 подписчиками нет
follows_and_unfollowsиfollower_demographics;engaged_audience_demographicsтребует 100 взаимодействий за период. - Отсутствующие или недоступные данные возвращаются как пустой набор, а не как 0.
- Демографические метрики возвращают только первые 45 значений.
- Метрики аккаунта хранятся до 90 дней, метрики медиа до 2 лет.
Чем отличаются Stories и карусели?
Метрики Stories доступны только 24 часа, а при значении меньше 5 вместо числа возвращается код ошибки 10 (недостаточно зрителей). Ответы от людей в Европе и Японии не учитываются, и Stories, созданная аккаунтом там, показывает 0 ответов. С Instagram Login нет вебхука story_insights, поэтому цифры Stories нужно считывать, пока Stories опубликована.
Карусель отображается как один пост: Meta не возвращает статистику для фото и видео внутри неё.
Почему меняются названия метрик?
Потому что Meta выводит из эксплуатации и переименовывает метрики между версиями API. impressions устарел в v22.0 и перестал работать во всех версиях 21 апреля 2025 года, кроме медиа, созданных до 2 июля 2024 года; вместо него введены views, а plays, clips_replays_count и ig_reels_aggregated_all_plays_count были удалены одновременно. video_views и несколько временных рядов профиля, среди которых profile_views, удалили раньше. Запрос с выведенным из эксплуатации названием завершается ошибкой, поэтому список метрик, написанный для более ранней версии API, может потребовать обновления.
Распространённые ошибки
- Запрос impressions. Он больше не работает ни в одной версии API; запрашивайте views.
- Пустой результат как ноль. Meta возвращает пустой набор данных, когда метрика недоступна, а это не то же самое, что отсутствие активности.
- Чтение метрик Stories после того, как Stories исчезла. Они доступны только 24 часа.
- Добавление разбивки к запросу нескольких метрик. Если одна из них её не поддерживает, весь вызов завершается ошибкой.
От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, с бесплатным пробным периодом в 3 дня.
Часто задаваемые вопросы
Что заменило impressions в API Instagram?
views, который считает, сколько раз контент был воспроизведён или показан. Meta вывела impressions из всех версий API 21 апреля 2025 года, кроме медиа, созданных до 2 июля 2024 года.
Почему аккаунт не возвращает данные о подписчиках?
Meta не возвращает follows_and_unfollows и демографию подписчиков для аккаунтов с менее чем 100 подписчиками.
Как далеко назад можно читать статистику Instagram?
До 90 дней метрик аккаунта и до 2 лет метрик медиа; online_followers охватывает только последние 30 дней.
Учитывается ли реклама в цифрах?
Частично. Охват и аккаунты с взаимодействиями включают рекламу, а лайки, комментарии и просмотры поста учитывают только органическую активность.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на