facebook/
pages

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

Facebook Pages API

Страницы
Профили
Публичные данные
2,4 кредита за результат
Готово
Готово

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

README

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

Facebook Pages

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

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

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

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

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

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

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

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

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

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

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

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

  • Перед запуском большого пакета проверяйте, что каждый переданный URL ведет на публичную страницу Facebook.
  • Учитывайте, что у некоторых публичных страниц может не быть контактных полей, изображений, рейтингов или счетчиков аудитории — это зависит от доступности результатов.
  • Храните стабильные ID страниц и канонические URL, чтобы задачи можно было повторять, проверять и очищать от дублей.
  • Используйте Facebook Posts API, если вашему процессу нужны публичные записи публикаций со страницы или другого поддерживаемого URL.
  • Не стройте процессы вокруг приватных страниц, ограниченных публикаций, разделов, доступных после входа, или данных, принадлежащих аккаунту, если отдельная опубликованная документация явно их не поддерживает.

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

  • Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
  • Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
  • Facebook Profile Events API — Собирайте публичные мероприятия, связанные с URL профилей или страниц: названия, расписание, места, медиа, видимые метрики и контекст источника.
  • Facebook Profile Photos API — Собирайте публичные фото по URL профилей или страниц: подписи, контекст автора, вовлеченность, метаданные изображений и ссылки на источник.
  • Facebook Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.
  • Facebook Reels API — Собирайте публичные Reels по URL профилей или страниц: подписи, контекст автора, метаданные видео, видимая вовлеченность и ссылки на источник.

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

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

Facebook Pages API — FAQ

Facebook Pages API получает публично доступные профили страниц по одному или нескольким URL страниц Facebook. Он возвращает нормализованные данные о странице, категории, описания, изображения, контакты, число подписчиков и отметок «Нравится», отзывы и рейтинги.

Для базового сбора публичных страниц не нужны учетные данные приложения Facebook или вход в Facebook. API не следует использовать в расчете на доступ к приватному, ограниченному или доступному только после входа контенту.

Типичные поля: ID страницы, название, канонический URL, категория, текст «О себе», аватар, обложка, число подписчиков и отметок «Нравится», отзывы, рейтинг, сайт, email, телефон и адрес.

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

Нормализованный объект metrics может содержать видимое число подписчиков, отметок «Нравится», отзывов и рейтинг, если публичный результат их показывает.

Контент Facebook динамичен, а структура публичных результатов может меняться. Пустые поля, тайм-ауты, отсутствие контактных данных или заблокированные запросы следует обрабатывать как обычные случаи недоступности данных и нагрузки на лимиты запросов.

Используйте меньшие лимиты, умеренную частоту запросов, паузы с нарастанием после сбоев и более длинные тайм-ауты обработки для крупных страниц. Избегайте частого повторного сбора больших объемов с одной и той же страницы.