Facebook Company Reviews
Отзывы о компаниях на Facebook — это публичные рекомендации или оценки страниц с письменным отзывом, данными автора, временем публикации, видимыми лайками и сводными показателями отзывов о компании. Эти записи помогают изучать обратную связь, фиксировать репутацию на определенный момент, анализировать авторов отзывов и сравнивать известные страницы.
Возможности Facebook Company Reviews API
- Сбор по URL отзывов страницыПринимает один или несколько поддерживаемых URL /reviews страниц Facebook и собирает публичные отзывы, доступные для каждого из них.
- Записи отзывов и их авторовВозвращает ID отзывов, исходные URL, текст, имена авторов и ссылки на их профили, видимые лайки, оценки и время публикации в нормализованной структуре.
- Данные на уровне компанииСохраняет название компании, URL страницы, общий рейтинг и общее число отзывов рядом с отдельными отзывами для сравнения источников.
Параметры Facebook Company Reviews API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL отзывов страниц Facebook на facebook.com, www.facebook.com или m.facebook.com, путь которых содержит /reviews, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число отзывов на каждый входной URL, от 20 до 2 000; по умолчанию 100, доступных публичных результатов может оказаться меньше. |
Как использовать Facebook Company Reviews API
Отправьте URL /reviews страниц Facebook как асинхронную задачу, опрашивайте ее по ID задачи и читайте нормализованные записи отзывов с курсорной пагинацией.
- Подготовьте один или несколько URL публичных страниц Facebook, путь которых содержит /reviews.
- Отправьте urls и необязательный results_limit методом POST на /v1/facebook/company-reviews.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor как cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Сценарии использования Facebook Company Reviews API
- Подготовка датасетов отзывов: Используйте текст отзывов, оценки, время публикации и исходные URL, чтобы готовить датасеты публичной обратной связи для последующего тематического анализа или анализа тональности.
- Отчеты о состоянии репутации: Объединяйте оценки отдельных отзывов с рейтингом компании и общим числом отзывов, чтобы фиксировать видимое состояние выбранных страниц.
- Исследование вовлеченности авторов отзывов: Используйте имена авторов, ссылки на профили и видимое число лайков, чтобы понять, кто оставлял публичные отзывы и какие отзывы вызвали отклик.
Практические советы по Facebook Company Reviews API
- Используйте открывающийся URL /reviews страницы Facebook, а не название компании или общий URL страницы.
- Задавайте results_limit для каждого входного URL в зависимости от нужной глубины и учитывайте, что строк будет меньше, если Facebook показывает меньше публичной истории отзывов.
- Отправляйте каждый URL страницы один раз: дубли входных URL удаляются перед сбором.
- Считайте ссылки на авторов, оценки, лайки, метки времени и сводные данные компании значениями, которые могут быть null, если Facebook их не показывает.
- Переходите по results.next_cursor, пока results.has_more не станет false, чтобы читать большие завершенные задачи без пропуска сохраненных записей.
Связанные API
Помимо Facebook Company Reviews API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
- Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
- Facebook Comment Replies API — Получайте публичные ответы на известный комментарий по его feedback ID и токену раскрытия: текст, автор, вовлеченность и родительский контекст.
- Facebook Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.