facebook/
company-reviews

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

Facebook Company Reviews API

Отзывы о страницах
Данные авторов отзывов
Рейтинги компаний
0,5 кредита за результат
Готово
Готово

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

README

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

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 задачи и читайте нормализованные записи отзывов с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных страниц Facebook, путь которых содержит /reviews.
  2. Отправьте urls и необязательный results_limit методом POST на /v1/facebook/company-reviews.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте /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, чтобы читать большие завершенные задачи без пропуска сохраненных записей.

Помимо 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: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.

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

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

Facebook Company Reviews API — FAQ

Facebook Company Reviews API — это программный интерфейс, который собирает отзывы и рекомендации по URL /reviews публичной страницы Facebook в единый набор обратной связи. Он дает командам по репутации основу для срезов, анализа тем и сравнения известных страниц, ограничиваясь контентом, видимым на публичных страницах отзывов.

Отправляйте один или несколько URL страниц Facebook на facebook.com, www.facebook.com или m.facebook.com с /reviews в пути. Название компании или посторонний URL страницы не подходят в качестве замены.

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

results_limit по умолчанию равен 100 и принимает целые числа от 20 до 2 000 для каждого входного URL. Это верхний предел, поэтому из-за публичной видимости и доступности источника отзывов может оказаться меньше.

Опрашивайте возвращенный ID задачи, пока ее status не станет succeeded, затем читайте сохраненные записи отзывов через эндпоинт результатов задачи.

Каждая фактически сохраненная запись отзыва стоит 0,5 кредита, базовой платы за задачу нет. Поэтому пустой результат не тарифицируется.