facebook/
events-search

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

Facebook Events Search API

Поиск мероприятий
Запрос по ключевому слову
Публичные мероприятия
0,6 кредита за результат
Готово
Готово

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

README

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

Facebook Events Search

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

Возможности Facebook Events Search API

  • Поиск мероприятий по ключевому словуИспользуйте текстовый запрос, чтобы находить записи публичных мероприятий Facebook, связанные с темой, видом деятельности, организацией или местом.
  • Идентификаторы и расписание мероприятияВозвращает ID мероприятий, названия, публичные URL, текст расписания и нормализованное время начала для найденных записей.
  • Место проведения и статус мероприятияСохраняет ID и названия мест, признак онлайн-формата и признак прошедшего мероприятия, чтобы различать площадку и время проведения.
  • Посещаемость и обложкаДобавляет видимое число откликов «интересует», «пойду» и «был(а)» вместе со ссылкой на публичную обложку, если она есть.

Параметры Facebook Events Search API

ПараметрыОбязательныйОписание
queryОбязательныйНепустой запрос с ключевым словом для поиска публичных мероприятий Facebook.
results_limitНеобязательныйМаксимальное число записей мероприятий для сбора, от 7 до 2 000; по умолчанию 100.

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

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

  1. Подготовьте непустой запрос с ключевым словом и при необходимости выберите results_limit от 7 до 2 000.
  2. Отправьте query и results_limit методом POST на /v1/facebook/events-search.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/facebook/events-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"technology conference","results_limit":20}'

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

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

  • Поиск мероприятий по теме: Используйте точный запрос вместе с названиями мероприятий, публичными URL и текстом расписания, чтобы составить список релевантных публичных мероприятий.
  • Мониторинг расписания: Сравнивайте нормализованное время начала, текст расписания, ID мероприятий и признак прошедшего мероприятия между запусками сбора.
  • Исследование площадок и форматов: Группируйте найденные мероприятия по ID места, названию места и признаку онлайн-формата, чтобы понять, где и как они публикуются.
  • Сравнение видимой посещаемости: Сравнивайте число откликов «интересует», «пойду» и «был(а)» в записях мероприятий вместе с их названиями и временем начала.

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

  • Используйте конкретную тему, вид деятельности, организацию или место, если широкий запрос возвращает нерелевантные мероприятия.
  • Задавайте results_limit от 7 до 2 000 в зависимости от нужного охвата; если параметр не указан, запрашиваются 100 записей по умолчанию.
  • При объединении повторных поисков используйте ID или публичный URL каждого мероприятия, чтобы не учитывать одно мероприятие дважды.
  • Считайте место проведения, обложку, число откликов и поля статуса мероприятия необязательными при сопоставлении записей с вашим приложением.

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

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

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

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

Facebook Events Search API — FAQ

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

Передайте непустую строку query. Параметр results_limit необязателен, по умолчанию равен 100 и принимает целое число от 7 до 2 000.

Запись может содержать ID мероприятия, название, публичный URL, текст расписания, время начала, ID и название места, число откликов «интересует», «пойду» и «был(а)», обложку и признаки онлайн-формата или прошедшего мероприятия.

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

Каждая возвращенная запись мероприятия стоит 0,6 кредита, базовой платы за задачу нет.