Facebook Comments
Комментарии Facebook — это публичные ответы на публикации с текстом, данными автора, временем публикации, видимым числом лайков и ответов, медиафайлами и связями с источником. Эти сигналы обсуждений помогают анализировать обратную связь аудитории, изучать повторяющиеся вопросы, следить за сообществом и готовить отчеты по контенту.
Возможности Facebook Comments API
- Сбор комментариев из нескольких публикацийСобирайте публичные комментарии из одного или нескольких URL публикаций Facebook в одном запросе.
- Нормализованные записи комментариевВозвращает ID комментариев, текст, данные автора, метки времени, видимую вовлеченность, медиафайлы и ссылки на источник в единой структуре.
- Отслеживаемый контекст обсужденияСохраняет ссылки на публикацию, родительский комментарий и переданные входные данные для объединения, удаления дублей и аудита.
- Граница публичных данныхПриватный, ограниченный, удаленный и доступный только после входа контент не попадает в результаты.
Параметры Facebook Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных публикаций Facebook, разделенные запятыми или переводами строки. |
Как использовать Facebook Comments API
Отправьте URL публичных публикаций Facebook как асинхронную задачу, опрашивайте ее по ID задачи и читайте нормализованные записи комментариев с курсорной пагинацией.
- Подготовьте один или несколько URL публичных публикаций Facebook.
- Отправьте urls методом POST на /v1/facebook/comments.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте /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, когда проверяете сопоставление полей или подключаете результаты к новому пайплайну данных.
Связанные API
Помимо 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: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.