facebook/
comments

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

Facebook Comments API

Комментарии
Публичные данные
URL публикаций
0,3 кредита за результат
Готово
Готово

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

README

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

Facebook Comments

Комментарии Facebook — это публичные ответы на публикации с текстом, данными автора, временем публикации, видимым числом лайков и ответов, медиафайлами и связями с источником. Эти сигналы обсуждений помогают анализировать обратную связь аудитории, изучать повторяющиеся вопросы, следить за сообществом и готовить отчеты по контенту.

Возможности Facebook Comments API

  • Сбор комментариев из нескольких публикацийСобирайте публичные комментарии из одного или нескольких URL публикаций Facebook в одном запросе.
  • Нормализованные записи комментариевВозвращает ID комментариев, текст, данные автора, метки времени, видимую вовлеченность, медиафайлы и ссылки на источник в единой структуре.
  • Отслеживаемый контекст обсужденияСохраняет ссылки на публикацию, родительский комментарий и переданные входные данные для объединения, удаления дублей и аудита.
  • Граница публичных данныхПриватный, ограниченный, удаленный и доступный только после входа контент не попадает в результаты.

Параметры Facebook Comments API

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

Как использовать Facebook Comments API

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

  1. Подготовьте один или несколько URL публичных публикаций Facebook.
  2. Отправьте urls методом POST на /v1/facebook/comments.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, если записей больше.
curl -X POST "https://api.socq.ai/v1/facebook/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/facebook/posts/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Сценарии использования Facebook Comments API

  • Анализ отзывов и тональности клиентов: Анализируйте текст публичных комментариев, чтобы понимать мнения, отзывы о продукте, вопросы и повторяющиеся темы.
  • Оптимизация контента кампаний: Сравнивайте тональность комментариев и видимую вовлеченность в публикациях кампании, чтобы уточнять сообщения и креативные решения.
  • Мониторинг обсуждений бренда: Упорядочивайте публичные комментарии к выбранным публикациям бренда по теме, времени, автору и сигналам вовлеченности.
  • Исследование аудитории конкурентов: Изучайте публичные реакции на публикации конкурентов, чтобы сравнивать интересы аудитории, ее вопросы и модели вовлеченности.
  • Поиск тем аудитории: Собирайте датасеты из текста комментариев и меток времени для кластеризации тем, поиска трендов и языкового анализа.
  • Поиск активных комментаторов: Используйте данные авторов, лайки и число ответов, чтобы находить комментаторов, которые постоянно поддерживают обсуждение.
  • Аналитика и обогащение данных: Связывайте структурированные записи комментариев с датасетами кампаний, публикаций и аналитики через ID и исходные URL.

Практические советы по Facebook Comments API

  • Используйте канонические URL публичных публикаций Facebook, чтобы каждый входной URL однозначно соответствовал исходной публикации.
  • Объединяйте связанные URL публичных публикаций в одном запросе, чтобы группировать задачи сбора по кампании или теме.
  • Сохраняйте ID задачи сразу после отправки, чтобы приложение могло опрашивать ее и возобновлять процесс сбора.
  • Переходите по results.next_cursor, пока он не станет пустым, чтобы прочитать все страницы результатов задачи.
  • Храните с каждой записью ID комментария, ID публикации, ID родительского комментария, входной URL и исходный URL.
  • Используйте ID комментария, чтобы находить и объединять повторяющиеся записи в одном датасете.
  • Используйте created_at и collected_at, чтобы упорядочивать историю комментариев и вести инкрементальный анализ.
  • Просматривайте Raw JSON, когда проверяете сопоставление полей или подключаете результаты к новому пайплайну данных.

Помимо Facebook Comments API, используйте эти API, когда нужен другой тип публичных данных Facebook.

  • Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
  • Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
  • Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
  • Facebook Comment Replies API — Получайте публичные ответы на известный комментарий по его feedback ID и токену раскрытия: текст, автор, вовлеченность и родительский контекст.
  • Facebook Company Reviews API — Собирайте публичные отзывы о страницах: текст отзыва, ссылки на авторов, оценки, лайки, метки времени и контекст компании.
  • Facebook Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.

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

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

Facebook Comments API — FAQ

Facebook Comments API собирает публично видимые комментарии по одному или нескольким URL публикаций Facebook. Он возвращает нормализованный текст, данные автора, метки времени, число лайков и ответов, медиафайлы и ссылки на источник.

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

Каждая запись может содержать ID комментария, текст, данные автора, исходный URL, лайки, число ответов, медиафайлы, created_at, collected_at, ID публикации, URL публикации, ID родительского комментария и входной URL.

Да. Добавьте несколько URL публичных публикаций в массив urls одного запроса.

Отправьте URL публикаций на /v1/facebook/comments, сохраните возвращенный ID задачи и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно. Завершенная задача содержит структурированные результаты по комментариям.

После завершения читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока в ответе есть курсор.

Передавайте ваш API-ключ SocQ как Bearer-токен в заголовке Authorization при отправке задачи и получении результатов.

Сопоставляйте нормализованные поля комментариев, авторов, вовлеченности, меток времени и источников с аналитическими таблицами, отчетами или приложениями. Сохраняйте идентификаторы комментариев и публикаций для объединения и удаления дублей.

Каждая возвращенная запись комментария стоит 0,3 кредита. Базовой платы за задачу нет.