facebook/
group-posts

Собирайте публикации из публичных групп Facebook по URL групп с выбором порядка сортировки: текст, авторы, метки времени, видео и видимая вовлеченность в виде нормализованных записей.

Facebook Group Posts API

Публикации публичных групп
Четыре режима сортировки
Лимит результатов на группу
1,2 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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 публичных групп с необязательной сортировкой и лимитом результатов на группу, затем читайте результаты асинхронной задачи с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных групп Facebook.
  2. Отправьте urls с необязательными results_limit и sort_by методом POST на /v1/facebook/group-posts и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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, если завершенная задача содержит больше одной страницы результатов.

Помимо 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 профилей или страниц: подписи, контекст автора, вовлеченность, метаданные изображений и ссылки на источник.

Другие платформы

Объединяйте данные Facebook с публичными данными других поддерживаемых соцсетей.

Facebook Group Posts API — FAQ

Facebook Group Posts API — это программный интерфейс для получения публичных публикаций из одной или нескольких групп Facebook по их URL с необязательной сортировкой. Он возвращает нормализованный текст публикаций, данные авторов, метки времени, видео, видимую вовлеченность и исходный URL группы.

Передайте один или несколько URL публичных групп Facebook в urls. Пустые списки отклоняются, а контент, который публичная страница группы не показывает, не может попасть в результаты.

sort_by принимает top_posts, recent_activity, chronological или chronological_listings. Выбранное значение применяется ко всем URL групп в запросе.

results_limit по умолчанию равен 100, принимает целые числа от 3 до 2 000 и применяется к каждому URL группы отдельно. Два URL с results_limit 30 запрашивают до 60 публикаций.

Нормализованная запись может содержать id, url, message, author, reactions_count, comments_count, views_count, видео, created_at, collected_at и extra.group_url. Поля, которых нет в публичной публикации, остаются null, нулем или пустыми в зависимости от их нормализованного типа.

Читайте data.results.items из GET /v1/tasks/{task_id}. Если has_more равно true, передайте results.next_cursor как cursor в следующем запросе задачи; каждая страница принимает limit от 1 до 500.

Каждая возвращенная запись публикации из группы стоит 1,2 кредита SocQ. Предварительная оценка запроса рассчитывается как число urls, умноженное на results_limit, а пустой набор результатов не тарифицируется.