facebook/
event-details

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

Facebook Event Details API

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

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

README

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

Facebook Event Details

Facebook Event Details — это эндпоинт прямого поиска по уже известным вам URL мероприятий. Передайте один или несколько публичных URL Facebook, содержащих /events/, чтобы получить ID мероприятия, канонический URL, название, описание, время начала и окончания, место проведения, публичные медиафайлы, видимые показатели и контекст сбора, если эти поля доступны.

Возможности Facebook Event Details API

  • Прямой поиск по URL мероприятияОбрабатывает известные URL публичных мероприятий Facebook без поиска по ключевому слову, категории, городу или дате.
  • Нормализованные метаданные мероприятияВозвращает стабильную структуру мероприятия с идентификаторами, каноническим URL, названием, описанием и меткой времени сбора.
  • Расписание и место проведенияФиксирует нормализованное время начала и окончания, а также публичное место проведения, если источник их показывает.
  • Медиафайлы и видимые показателиДобавляет нормализованные публичные медиафайлы и стандартные показатели вовлеченности или откликов, если они доступны для мероприятия.

Параметры Facebook Event Details API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный массив URL публичных мероприятий Facebook. Допустимые хосты: facebook.com, www.facebook.com и m.facebook.com; каждый путь должен содержать /events/.

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

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

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

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

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

  • Обогащение метаданных мероприятий: Дополняйте сохраненный URL мероприятия нормализованными идентификаторами, названием, описанием, местом проведения, временем, медиафайлами и видимыми показателями.
  • Загрузка в календарь: Передавайте доступные названия мероприятий, время начала и окончания, описания, места проведения и исходные URL в календарный пайплайн.
  • Исследование организаторов и площадок: Изучайте публичное описание, место проведения, расписание, медиафайлы и сигналы откликов по имеющемуся списку URL мероприятий.
  • Обновление известных мероприятий: Повторно запускайте сохраненные URL мероприятий, чтобы обновить публичные поля, которые источник отдает сейчас.

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

  • Используйте канонический URL страницы мероприятия, а не список мероприятий страницы или другой URL Facebook, который просто содержит сегмент events.
  • Считайте название, описание, место проведения, расписание, медиафайлы и показатели необязательными: видимость в источнике зависит от мероприятия.
  • Сохраняйте extra.input_url при сверке результатов запроса с несколькими URL; один переданный URL может дать не более одной записи мероприятия.
  • Приватные, удаленные, ограниченные или доступные только после входа мероприятия могут завершиться без возвращенной записи.

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

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

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

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

Facebook Event Details API — FAQ

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

Отправляйте URL на facebook.com, www.facebook.com или m.facebook.com, путь которых содержит /events/. URL списка мероприятий страницы или некорректный путь мероприятия могут пройти базовую проверку формата, но не вернуть записи.

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

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

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