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

facebook/pages
Профили2,4 кредита за результат

facebook/posts
Публикации1 кредит за результат

facebook/group-posts
Публикации1,2 кредита за результат

facebook/reels
Публикации0,7 кредита за результат

facebook/comments
Комментарии0,3 кредита за результат

facebook/comment-replies
Комментарии0,3 кредита за результат

facebook/company-reviews
Комментарии0,5 кредита за результат

facebook/video-transcript
Публикации0,7 кредита за результат

facebook/ad-transcript
Публикации0,5 кредита за результат

facebook/events-search
Поиск0,6 кредита за результат

facebook/event-details
Поиск0,5 кредита за результат

facebook/profile-events
Профили0,6 кредита за результат

facebook/profile-photos
Публикации0,5 кредита за результат

facebook/profiles
Профили1,2 кредита за результат
Какие данные Facebook можно получить?
SocQ превращает поддерживаемые публичные результаты Facebook в единообразные JSON-записи для обогащения данных, мониторинга, исследований и отчетности.
Публичные профили страниц
Собирайте названия страниц, категории, описания, канонические URL, фото профиля и обложки, если они публично доступны.
Контакты и аудитория
Получайте публичные сайты, адреса электронной почты, номера телефонов, местоположения, число подписчиков, отметки «Нравится» страницы, рейтинги и число отзывов, если они указаны.
Контент публичных публикаций
Собирайте текст публикаций, авторов, метки времени, ссылки, изображения, ссылки на видео и нормализованные идентификаторы публикаций.
Публичные комментарии и вовлеченность
Собирайте текст публичных комментариев, поля авторов, метки времени, лайки, число ответов, репосты и сигналы реакций, если они доступны.
Поиск публичных мероприятий
Ищите по ключевому слову названия мероприятий, расписание, места проведения, сигналы посещаемости, обложки и статус онлайн-формата или прошедшего мероприятия.
Доступные расшифровки видео
Извлекайте текст расшифровки со ссылкой на источник и форматом plaintext или WebVTT по известным URL публичных видеопубликаций или роликов Reels.
SocQ vs Facebook Graph API
SocQ сосредоточен на сборе поддерживаемых публичных данных. Graph API от Meta — правильный выбор для управления ресурсами, доступ к которым явно разрешил пользователь или компания.
| Возможность | SocQ | Facebook Graph API |
|---|---|---|
| Основное назначение | Сбор данных публичных страниц, публикаций, публикаций в группах, комментариев, мероприятий и расшифровок | Управление авторизованными страницами, приложениями и ресурсами |
| OAuth клиента | API-ключ SocQ; OAuth клиента в Facebook не нужен | Проверка приложения Meta, разрешения и токены доступа |
| Создание и редактирование публикаций | Не поддерживается | Поддерживается при наличии подходящих разрешений страницы |
| Приватные данные или данные с ограниченным доступом | Не поддерживается | Только данные, доступ к которым предоставлен через авторизованные разрешения |
| Формат ответа | Нормализованные записи SocQ | Исходные объекты Graph API |
Как работает API Facebook
Сбор выполняется асинхронно, поэтому ваше приложение может отправлять задачи, отслеживать их статус и обрабатывать страницы результатов независимо.
1. Отправьте входные данные
Отправьте методом POST поддерживаемые публичные URL страниц, публикаций, групп, видеопубликаций или роликов Reels либо поисковый запрос по ключевому слову для поиска мероприятий, используя задокументированные поля выбранного эндпоинта.
2. Опрашивайте задачу
Используйте возвращенный ID задачи, пока обработка не завершится успешно или с ошибкой. При временных ответах о перегрузке увеличивайте интервал между запросами.
3. Читайте и листайте результаты
Получайте нормализованные элементы результатов и переходите по next_cursor, если в задаче есть еще записи.
Пройдите аутентификацию с 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 публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.