Инсайты постов Facebook через API: просмотры, охват и вовлечённость
Инсайты постов Facebook берутся из GET /{page-post-id}/insights с метриками вроде post_media_view, число воспроизведений или показов поста, post_total_media_view_unique, его уникальные зрители, post_clicks и post_reactions_by_type_total. Meta объявила устаревшими post_impressions в ноябре 2025 года и post_impressions_unique в июне 2026 года, поэтому просмотры и уникальные зрители теперь заменяют показы и охват.
easyCoexistence читает инсайты постов Facebook через get_social_insights, поэтому Claude, ChatGPT или ваш собственный код может спросить, как сработал пост, и получить от Meta актуальные просмотры, уникальных зрителей, клики и реакции, а список постов находится через list_social_posts.
Рекомендованная Meta замена для post_impressions_unique, отказ от которого для всех версий API она назначила на июнь 2026 года.
Когда post_impressions перестал возвращать данные во всех версиях; Meta называет альтернативой post_media_view.
Период, который Meta указывает для метрик постов, таких как post_media_view, post_clicks и итоги реакций.
Что входит в счётчики реакции «Нравится» у Meta: и «Нравится», и «Забота».
Что Meta возвращает вместо ошибки, если приложению не хватает разрешения read_insights.
Какие метрики постов работают в 2026 году?
Они есть в справочнике инсайтов Meta и не входят в её списки устаревших по состоянию на 1 ноября 2026 года. Каждая читается по ID поста, с периодом lifetime, если не указано иное:
post_media_view: сколько раз пост был воспроизведён или показан, с разбивкойis_from_adsиis_from_followers.post_total_media_view_unique: уникальные зрители поста, замена охвату по версии Meta.post_clicks: клики по любому месту поста, не создавшие историю;post_clicks_by_typeделит их по типу потребления.post_reactions_by_type_total: реакции по типам плюс общий итог по каждому типу, напримерpost_reactions_love_totalилиpost_reactions_anger_total.post_video_views: воспроизведения видео длительностью не менее 3 секунд, с периодом lifetime или day.
Что заменило показы и охват постов?
Meta перевела измерение постов с показов на просмотры медиа в два этапа, каждый сразу для всех версий API, и устаревшее имя теперь возвращает ошибку invalid metric. В её журнале изменений, на странице устаревших метрик и в заметках к Graph API v25 указаны такие альтернативы:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
В чём разница между просмотрами и уникальными зрителями?
Просмотры считают показы, уникальные зрители считают людей. post_media_view суммирует каждое воспроизведение или показ поста, поэтому один человек, увидевший пост дважды, засчитывается дважды, а post_total_media_view_unique учитывает уникальных зрителей поста по одному разу каждого. Meta помечает метрики с окончанием _unique как приблизительные и считает уникальные значения независимо, поэтому итог не обязан совпадать с суммой своих частей.
Как запросить инсайты поста?
Запросом GET /{page-post-id}/insights с параметром metric в виде списка через запятую или GET /{page-post-id}/insights/{metric} для одной метрики. Токен должен получить тот, кто может выполнять задачу ANALYZE на Странице, с выданными разрешениями read_insights и pages_read_engagement, а каждый результат содержит name, period, values, title и description. Пример Meta, запрашивающий итоги реакций:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}Как посчитать реакции, комментарии и репосты?
Берутся из собственных полей поста, рядом с его инсайтами. fields=reactions.summary(total_count) возвращает общее число реакций, а reactions.type(LOVE).limit(0).summary(total_count) возвращает число реакций одного типа: LIKE, LOVE, WOW, HAHA, SORRY или ANGRY. Поле shares содержит число репостов, которое, по словам Meta, может включать удалённые посты и посты, которые токен не видит, а связь comments с параметром summary=true добавляет total_count.
Как метрики поста связаны с метриками Страницы?
Метрики Страницы суммируют содержимое Страницы за период, а метрики поста дают итоги за всё время жизни одного поста. page_post_engagements считает вовлечённость в посты Страницы через реакции, комментарии, репосты и другое, по day, week или days_28, а page_media_view и page_total_media_view_unique делают то же для просмотров и зрителей. Meta убрала post_engaged_users в 2024 году, поэтому вовлечённость по каждому посту складывается из кликов, реакций, комментариев и репостов.
Насколько свежи данные и как далеко они уходят назад?
Большинство метрик обновляется раз в сутки, а помеченные Meta звёздочкой, например post_clicks, несколько раз в день. Meta хранит двухлетние инсайты для публичных Страниц, но только 5 дней для неопубликованных. lifetime означает период, за который доступны данные, по умолчанию два года или меньше. Для Page Insights нужна Страница со 100 и более отметками «Нравится», а несколько видеометрик показывают 0 у видео, переопубликованного с другой Страницы.
Как easyCoexistence читает инсайты постов?
get_social_insights принимает метрики и для одного поста object_id, ID поста, который возвращает list_social_posts; без object_id он читает Страницу. Параметры period и дополнительные, например since и until, передаются в Meta без изменений, а устаревшая метрика возвращает ошибку invalid metric от Meta, поэтому ИИ может перейти на актуальное имя.
Распространённые ошибки
- Запрос post_impressions_unique. Meta признала его устаревшим для всех версий API в июне 2026 года; запрашивайте post_total_media_view_unique, чтобы считать уникальных зрителей.
- Сложение уникальных зрителей по постам. Каждый пост считает своих зрителей приблизительно, поэтому человек, увидевший два поста, засчитывается дважды.
- Чтение инсайтов видео, переопубликованного с другой Страницы. Несколько видеометрик возвращают 0 для репостов; точные значения есть только у Страницы, которая создала видео.
- Доверие нулю из пустого ответа. Без read_insights Meta возвращает пустой набор данных, а не ошибку, поэтому сначала проверьте разрешение.
Цена от US$ 9 до US$ 0,75 за подключение в месяц снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Что заменило охват поста в Facebook?
post_total_media_view_unique, число уникальных зрителей поста, после того как Meta признала устаревшим post_impressions_unique в июне 2026 года.
Можно ли увидеть, кто поставил реакцию на пост Страницы?
Нет. Meta возвращает количество реакций по типам, но Страница или человек может запросить только собственную реакцию; остальные остаются закрытыми.
Учитывает ли счётчик «Нравится» реакцию «Забота»?
Да. Итоги «Нравится» у Meta включают и «Нравится», и «Заботу», как в инсайтах, так и в связи reactions.
Можно ли читать инсайты поста на другой Странице?
Не через инсайты Страницы: нужен токен от того, кто может выполнять задачу ANALYZE на Странице, которая создала пост.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на