Ко всем API
Публичные данные Facebook

Facebook Public Data API

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

Доступные API Facebook

Используйте Pages для публичных полей профиля, Posts — для общего контента, Group Posts — для записей по URL групп, Comments — для обсуждений, Events Search — для мероприятий по ключевому слову, а Video Transcripts — для доступного текста речи по известным URL видеопубликаций или роликов Reels. Все шесть используют одинаковую аутентификацию и схему получения результатов задачи.

Какие данные Facebook можно получить?

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

Публичные профили страниц

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

Контакты и аудитория

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

Контент публичных публикаций

Собирайте текст публикаций, авторов, метки времени, ссылки, изображения, ссылки на видео и нормализованные идентификаторы публикаций.

Публичные комментарии и вовлеченность

Собирайте текст публичных комментариев, поля авторов, метки времени, лайки, число ответов, репосты и сигналы реакций, если они доступны.

Поиск публичных мероприятий

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

Доступные расшифровки видео

Извлекайте текст расшифровки со ссылкой на источник и форматом plaintext или WebVTT по известным URL публичных видеопубликаций или роликов Reels.

SocQ vs Facebook Graph API

SocQ сосредоточен на сборе поддерживаемых публичных данных. Graph API от Meta — правильный выбор для управления ресурсами, доступ к которым явно разрешил пользователь или компания.

ВозможностьSocQFacebook Graph API
Основное назначениеСбор данных публичных страниц, публикаций, публикаций в группах, комментариев, мероприятий и расшифровокУправление авторизованными страницами, приложениями и ресурсами
OAuth клиентаAPI-ключ SocQ; OAuth клиента в Facebook не нуженПроверка приложения Meta, разрешения и токены доступа
Создание и редактирование публикацийНе поддерживаетсяПоддерживается при наличии подходящих разрешений страницы
Приватные данные или данные с ограниченным доступомНе поддерживаетсяТолько данные, доступ к которым предоставлен через авторизованные разрешения
Формат ответаНормализованные записи SocQИсходные объекты Graph API

Как работает API Facebook

Сбор выполняется асинхронно, поэтому ваше приложение может отправлять задачи, отслеживать их статус и обрабатывать страницы результатов независимо.

  1. 1. Отправьте входные данные

    Отправьте методом POST поддерживаемые публичные URL страниц, публикаций, групп, видеопубликаций или роликов Reels либо поисковый запрос по ключевому слову для поиска мероприятий, используя задокументированные поля выбранного эндпоинта.

  2. 2. Опрашивайте задачу

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

  3. 3. Читайте и листайте результаты

    Получайте нормализованные элементы результатов и переходите по next_cursor, если в задаче есть еще записи.

Начните с одного запроса к API

Пройдите аутентификацию с API-ключом SocQ. Этот пример запускает задачу для публичной страницы Facebook; для общих публикаций используйте /v1/facebook/posts, для публикаций в группах — /v1/facebook/group-posts, для комментариев — /v1/facebook/comments, для поиска мероприятий — /v1/facebook/events-search, а для известных URL видеопубликаций и роликов Reels — /v1/facebook/video-transcript.

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}
# Read GET /v1/tasks/{task_id}?limit=50

Типичные сценарии использования API Facebook

Мониторинг брендов

Отслеживайте публичные данные страниц, контакты, аудиторию и сигналы публикаций собственных брендов или конкурентов.

Исследование контента и реакции аудитории

Анализируйте публичные публикации, текст комментариев, авторов, метки времени, медиа и видимую вовлеченность для отчетности или редакционных исследований.

Обогащение данных страниц

Добавляйте публичные данные Facebook об идентичности, категории, контактах и аудитории в CRM, каталоги или записи аккаунтов.

Поиск и мониторинг мероприятий

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

Пайплайны отчетности

Передавайте нормализованные записи публичных страниц и публикаций в панели мониторинга, хранилища данных и внутренние инструменты проверки.

Индексация устной речи

Индексируйте доступный текст расшифровок вместе с URL источника и форматом для выбранных публичных видеопубликаций и роликов Reels.

Ограничения и политика публичных данных

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

  • Закрытые группы, профили с ограниченным доступом, удаленные публикации и контент, доступный только после входа, не поддерживаются.
  • В публичных записях могут отсутствовать контактные поля, авторы комментариев, медиа, счетчики, метки времени, ответы или разбивка реакций.
  • Для переданного URL публичного видео запись расшифровки не создается, если непустой текст расшифровки недоступен.
  • Используйте небольшие пакеты, умеренную частоту запросов и увеличивайте интервал после временных блокировок или превышения лимита запросов.
  • Эти эндпоинты не создают, не обновляют, не модерируют и не удаляют контент Facebook.

Частые вопросы об API Facebook

Это официальный Facebook Graph API?

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

Нужно ли пользователям подключать аккаунты Facebook?

Для поддерживаемых эндпоинтов публичных данных OAuth клиента в Facebook не требуется. Запросы проходят аутентификацию с API-ключом SocQ.

Может ли SocQ собирать данные закрытых групп или профилей?

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

Как рассчитывается стоимость?

В карточке каждого эндпоинта указана текущая цена в кредитах за результат. Задачи оплачиваются по возвращенным нормализованным записям.

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

X API

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

LinkedIn API

Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.

Reddit API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Pinterest API

Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.

Threads API

Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.

Bluesky API

Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.