Facebook Comment Replies
Ответы на комментарии Facebook — это публичные реплики, вложенные под известный комментарий, с текстом ответа, данными автора, видимой вовлеченностью, метками времени и ссылкой на родительский контекст обсуждения. Эти записи помогают восстанавливать ветки, анализировать реакции и отслеживать отдельные ответы.
Возможности Facebook Comment Replies API
- Стабильная ссылка на комментарийИспользуйте публичный URL публикации и ID родительского комментария, а актуальные токены ответов провайдера SocQ определит сам.
- Нормализованный контекст ответовПолучайте ID ответов, URL, текст, ID и имена авторов, видимую вовлеченность, метки времени и ID родительского обсуждения в единой структуре.
- Ограниченный сбор по курсоруПереходит по курсорам ответов, удаляет дубли ID комментариев и останавливается при достижении запрошенного лимита, исчерпании ветки или предела страниц сбора.
Параметры Facebook Comment Replies API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный стабильный URL публикации Facebook, содержащей родительский комментарий. |
comment_id | Обязательный | Обязательный ID родительского комментария, относящегося к переданному URL публикации. |
results_limit | Необязательный | Максимальное число ответов для сбора, от 20 до 2 000; в примере из документации используется 20. |
Как использовать Facebook Comment Replies API
Отправьте стабильный URL публикации и ID родительского комментария как асинхронную задачу, опрашивайте ее по ID задачи и читайте нормализованные записи ответов с курсорной пагинацией результатов.
- Выберите публичный URL публикации Facebook и ID родительского комментария, полученный для этой публикации.
- Отправьте url, comment_id и results_limit методом POST на /v1/facebook/comment-replies.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, если сохраненных записей больше.
curl -X POST "https://api.socq.ai/v1/facebook/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.facebook.com/NASA/posts/would-you-lie-in-bed-for-60-days-for-scientific-research11-volunteers-did-exactl/1271494461012594/","comment_id":"Y29tbWVudDoxMjcxNDk0NDYxMDEyNTk0XzU4NzcxOTAzMTA0Mjk5MQ==","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Сценарии использования Facebook Comment Replies API
- Восстановление веток комментариев: Связывайте ID ответов и extra.parent_feedback_id, чтобы восстановить публичную ветку ответов под выбранным комментарием.
- Анализ реакций на уровне ответов: Используйте текст ответов, данные авторов, метки времени и видимую вовлеченность, чтобы изучать, как люди реагируют внутри обсуждения.
- Мониторинг обсуждений и отчетность: Отслеживайте нормализованные записи ответов для выбранных родительских комментариев и сравнивайте активность ответов между запусками сбора.
Практические советы по Facebook Comment Replies API
- Передавайте URL публикации и ID комментария в паре: SocQ ищет эту публикацию и сам определяет токены ответов провайдера.
- Задавайте results_limit осознанно для длинных веток: сбор останавливается на этом лимите, при исчерпании ветки или после 100 страниц ответов.
- При объединении запусков убирайте дубли по id ответа вместе с extra.parent_feedback_id, чтобы одинаковые ID ответов оставались привязаны к правильному родителю.
- Считайте url, text, поля автора, видимые метрики и created_at необязательными, а текст ответов обрабатывайте как недоверенный пользовательский контент.
Связанные API
Помимо Facebook Comment Replies API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
- Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
- Facebook Group Posts API — Собирайте публичные публикации по URL групп Facebook с выбором порядка, лимитом на группу, контекстом автора, видео и видимой вовлеченностью.
- Facebook Company Reviews API — Собирайте публичные отзывы о страницах: текст отзыва, ссылки на авторов, оценки, лайки, метки времени и контекст компании.