Получение постов Страницы Facebook через API: feed, posts и published_posts
Посты Страницы Facebook читаются из трёх рёбер (edges) Graph API: /{page-id}/feed возвращает ленту Страницы, включая посты посетителей и публичные посты, которые отмечают Страницу, /{page-id}/posts возвращает собственные посты Страницы, а /{page-id}/published_posts возвращает её опубликованные посты. Один запрос отдаёт до 100 постов, следующие страницы приходят по курсору, а Meta возвращает около 600 ранжированных опубликованных постов в год.
easyCoexistence перечисляет последние посты Страницы Facebook через list_social_posts из Claude, ChatGPT или вашего собственного кода, до 100 за вызов.
Наибольшее число постов, которое один запрос может прочитать с параметром limit; большее значение возвращает ошибку.
Ранжированные опубликованные посты в год, которые API возвращает при чтении постов Страницы.
Поле, которое отделяет опубликованные посты от неопубликованных, которые ребро feed возвращает вместе.
Ребро Страницы, на которое ссылается справочник Meta по feed для получения Reels, опубликованных на Странице.
Ссылка на следующую страницу, по которой нужно идти, пока она не исчезнет; короткая или пустая страница не означает конец.
Собственные посты Страницы, которые справочник Meta описывает как производные от ребра /feed.
В чём разница между feed, posts и published_posts?
В том, кто написал пост и опубликован ли он. Справочник Meta по Страницам описывает три основных ребра и три более узких именно так; при этом feed возвращает и неопубликованные посты наряду с опубликованными, которые различает is_published:
Какие поля стоит запрашивать?
Перечислите их в fields: пример Meta для чтения постов Страницы возвращает id, created_time и message. Справочник Page Post среди полей поста перечисляет следующие:
- id, message и
created_time: пост, его текст и время публикации. permalink_url: постоянный адрес поста на facebook.com.full_picture: полноразмерное изображение из вложения.status_type,is_publishedиscheduled_publish_time.- shares, с числом репостов поста.
- attachments, comments и reactions, которые являются рёбрами, а не простыми полями.
Как получить количество реакций и комментариев?
Через расширение полей при чтении постов. reactions.summary(total_count) добавляет число реакций, и Meta отмечает, что счётчик лайков включает care. shares несёт собственный счётчик. Ребро comments возвращает total_count, когда запрошен summary; Meta указывает, что это значение может превышать число возвращённых комментариев из-за приватности или удаления.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25Как работает постраничная навигация?
По курсору. Каждый ответ содержит paging с курсорами before и after и ссылками next и previous; идите по next, пока она не исчезнет. Meta предупреждает не считать концом страницу с результатами меньше limit: страница может быть даже пустой и всё же содержать next. Курсоры быстро теряют актуальность при добавлении или удалении элементов, поэтому для диапазона, к которому потом придётся вернуться, используйте since и until.
Какие ограничения действуют?
Справочник Meta по feed задаёт такие ограничения на чтение постов Страницы:
- 100 постов за запрос с limit; большее значение возвращает ошибку с требованием не превышать 100.
- Около 600 ранжированных опубликованных постов в год.
- Содержимое истёкшего поста больше не доступно через Graph API.
- Для получения видеопостов автор запроса должен быть администратором Страницы.
- Пост, который делится чужим, может быть не виден, если оригинал не виден токену, с которым выполняется запрос.
- Данные людей появляются в ответах только тогда, когда запрос использует токен доступа Страницы.
Где перечисляются Reels и истории?
На собственных рёбрах. Справочник Meta по feed указывает на ребро video_reels Страницы для Reels, опубликованных на Странице, а GET /{page-id}/video_reels перечисляет их с since и until. GET /{page-id}/stories перечисляет истории Страницы как PUBLISHED или ARCHIVED, при этом архивные доступны только пока включён архив историй Страницы.
Что возвращает list_social_posts для Страницы?
Последние посты Страницы из /{page-id}/posts, по 25 по умолчанию и до 100 за вызов, каждый с id, message, created_time, permalink_url и full_picture, вместе с курсорами пагинации Meta. Счётчики не запрашиваются, и читается одна страница результатов: list_social_comments читает комментарии поста, а get_social_insights читает метрики поста с его ID в качестве object_id.
Как получить посты, созданные через easyCoexistence?
С помощью list_scheduled_posts, который перечисляет посты, созданные через easyCoexistence, опубликованные сейчас или запланированные: ближайшие сначала, по статусу или один по post_id. Каждый содержит статус (scheduled, publishing, processing, published, failed или canceled), publish_at, ссылку после публикации и ошибку, если она произошла. Экран «Посты» в панели управления показывает их в разделах «Требуют внимания», «Скоро» и «Опубликованные».
Распространённые ошибки
- Ожидание счётчиков от list_social_posts. Он читает текст, время, ссылку и изображение; метрики поста берутся из get_social_insights с его ID в качестве object_id.
- Чтение /feed ради собственных постов Страницы. Он также возвращает посты посетителей, публичные посты с отметкой Страницы и неопубликованные; используйте /published_posts или фильтруйте по is_published.
- Считать короткую страницу последней. Останавливайтесь только тогда, когда исчезнет ссылка next, так как Meta говорит, что страница может быть пустой и всё же содержать её.
- Сохранение курсоров на потом. Meta указывает, что они быстро становятся недействительными при добавлении или удалении постов; храните вместо них значения since и until.
list_scheduled_posts отслеживает то, что ушло через easyCoexistence. Цена от US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Включает ли ребро feed запланированные посты?
Оно возвращает опубликованные и неопубликованные посты вместе, поэтому различайте их по is_published или запрашивайте GET /{page-id}/scheduled_posts для тех, что запланированы на потом.
Может ли API перечислять посты другой Страницы?
Только с функцией Meta Page Public Content Access и пользовательским токеном доступа. easyCoexistence читает Страницы, которые вы подключили, с их собственными токенами Страницы.
Как получить посты за диапазон дат?
Добавьте since и until к чтению в виде UNIX-меток времени или значений strtotime; руководство Meta по пагинации рекомендует оба параметра для согласованных результатов.
Сколько стоит easyCoexistence для Страницы Facebook?
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня бесплатно. Каждая подключённая Страница считается одним подключением.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на