Facebook Posts
Публикации Facebook — это публичные обновления страниц, профилей или групп с текстом, ссылками, медиафайлами, данными автора, метками времени и видимой вовлеченностью. Эти сигналы контента и вовлеченности помогают отслеживать кампании, проводить редакционные исследования, анализировать аудиторию и готовить отчеты.
Возможности Facebook Posts API
- Поддерживаемые публичные URLСобирайте публикации по URL публичных страниц, профилей, групп или отдельных публикаций Facebook в единой нормализованной структуре ответа.
- Поля контента и медиафайловВозвращает текст и ID публикаций, данные автора, метки времени, ссылки, медиафайлы, число репостов, комментариев и видимых реакций в нормализованных полях.
- Разбивка реакцийПредоставляет видимую разбивку реакций по типам like, love, wow, care, sad, angry и haha.
- Лимит запрашиваемых результатовПринимает один или несколько поддерживаемых URL и использует results_limit, чтобы ограничить число запрашиваемых записей публикаций.
- Граница публичных данныхПриватный, ограниченный, доступный только после входа или удаленный контент в ответ не попадает.
Параметры Facebook Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных страниц, профилей, групп или публикаций Facebook, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом. |
Как использовать Facebook Posts API
Отправьте асинхронную задачу сбора, опрашивайте ее по ID задачи и читайте нормализованные записи публичных публикаций с курсорной пагинацией.
- Подготовьте один или несколько URL публичных страниц, профилей, групп или публикаций Facebook.
- Отправьте urls и необязательный results_limit методом POST на /v1/facebook/posts.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, если записей больше.
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Сценарии использования Facebook Posts API
- Мониторинг публичных страниц: Собирайте публичные публикации, метки времени, ссылки, ссылки на медиафайлы и видимые счетчики со страниц Facebook, которые отслеживает ваш продукт.
- Отчетность по кампаниям и бренду: Нормализуйте текст публикаций, реакции, комментарии, репосты и медиаполя перед отправкой данных кампаний в аналитические панели или BI-инструменты.
- Исследование контента: Анализируйте публичные подписи, темы публикаций, ссылки, изображения, видео и модели вовлеченности вокруг бренда, события или темы.
- Процессы мониторинга соцсетей: Направляйте сигналы публичных публикаций в очереди проверки, системы оповещений или внутренние исследовательские инструменты без поддержки хрупких парсеров страниц.
- Архив публикаций и аудит: Храните нормализованные ID публикаций, исходные URL, метки времени, видимые счетчики и время сбора для воспроизводимых архивов и отчетности.
Практические советы по Facebook Posts API
- Начинайте с небольших пакетов публичных страниц и увеличивайте лимит только после того, как повторные попытки и паузы с нарастанием работают корректно.
- Храните нормализованные ID публикаций, URL, ID задач и next_cursor, чтобы сбор публикаций можно было возобновить после сбоев.
- Учитывайте, что у некоторых публичных публикаций может не быть комментариев, медиафайлов, деталей реакций или меток времени — это зависит от доступности источника.
- Используйте Comments API, если нужны более глубокие публичные ветки комментариев, чем легкие поля предпросмотра.
- Не закладывайте в интеграцию приватные, ограниченные, доступные только после входа или принадлежащие аккаунту данные, если опубликованная документация API явно их не поддерживает.
Связанные API
Помимо Facebook Posts API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
- Facebook Group Posts API — Собирайте публичные публикации по URL групп Facebook с выбором порядка, лимитом на группу, контекстом автора, видео и видимой вовлеченностью.
- Facebook Ad Transcript API — Извлекайте доступный текст речи, язык, формат и контекст источника по URL из Facebook Ad Library.
- Facebook Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.