Facebook Group Posts
Публикации в группах Facebook — это публичные обновления групп с текстом сообщения, данными автора, временем публикации, ссылками на источник, видимыми реакциями, комментариями, просмотрами и видео. Эти записи помогают следить за активностью групп, исследовать обсуждения, сравнивать вовлеченность и готовить отчеты по публичному контенту.
Возможности Facebook Group Posts API
- Пакеты URL публичных группПринимает один или несколько URL публичных групп Facebook и сохраняет исходный URL группы в каждой нормализованной записи публикации.
- Четыре режима сортировки в группахИспользуйте top_posts, recent_activity, chronological или chronological_listings, чтобы выбрать порядок, применяемый ко всем переданным группам.
- Глубина сбора для каждой группыПрименяет results_limit отдельно к каждому URL группы: по умолчанию 100, допустимый диапазон — от 3 до 2 000.
- Публикация и ее авторВозвращает ID публикаций, исходные URL, текст сообщения, ID и имена авторов, время публикации и время сбора в единой структуре.
- Видимая вовлеченность и видеоДобавляет видимое число реакций, комментариев и просмотров видео, а также нормализованные URL видео и миниатюр, если публичная публикация их показывает.
Параметры Facebook Group Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательные URL публичных групп Facebook, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число публикаций для каждого URL группы; по умолчанию 100, допускаются целые числа от 3 до 2 000. |
sort_by | Необязательный | Необязательный порядок сортировки, применяемый ко всем переданным группам: top_posts, recent_activity, chronological или chronological_listings. |
Как использовать Facebook Group Posts API
Отправьте URL публичных групп с необязательной сортировкой и лимитом результатов на группу, затем читайте результаты асинхронной задачи с курсорной пагинацией.
- Подготовьте один или несколько URL публичных групп Facebook.
- Отправьте urls с необязательными results_limit и sort_by методом POST на /v1/facebook/group-posts и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more остается true.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Facebook Group Posts API
- Обзор активности публичных групп: Используйте сортировку recent_activity или chronological вместе с полями message, author, created_at и group_url, чтобы просматривать публичные обновления выбранных групп.
- Архивы обсуждений в группах: Храните ID публикаций, текст сообщений, данные авторов, исходные URL, время публикации и время сбора как публичные записи групп с указанием источника.
- Сравнение вовлеченности в равных условиях: Применяйте одинаковый sort_by ко всем URL групп и сравнивайте reactions_count, comments_count и views_count при одном порядке сортировки.
Практические советы по Facebook Group Posts API
- Передавайте прямые URL публичных групп, а не название группы, чтобы каждый входной URL однозначно указывал на источник.
- Рассчитывайте запрошенную глубину как число urls, умноженное на results_limit: лимит применяется к каждой группе отдельно.
- Запускайте отдельные задачи, если сравниваете режимы сортировки: одно значение sort_by применяется ко всем URL групп в запросе.
- Храните id и extra.group_url вместе, чтобы последующие записи сохраняли привязку к источнику и могли очищаться от дублей внутри каждой группы.
- Считайте автора, текст сообщения, время публикации, видео и число просмотров видео необязательными, если публичная публикация их не показывает.
- Переходите по results.next_cursor, пока has_more не станет false, если завершенная задача содержит больше одной страницы результатов.
Связанные API
Помимо Facebook Group Posts API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
- Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
- Facebook Ad Transcript API — Извлекайте доступный текст речи, язык, формат и контекст источника по URL из Facebook Ad Library.
- Facebook Profile Photos API — Собирайте публичные фото по URL профилей или страниц: подписи, контекст автора, вовлеченность, метаданные изображений и ссылки на источник.