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 задачи и читайте нормализованные записи мероприятий.
- Подготовьте один или несколько публичных URL на facebook.com, www.facebook.com или m.facebook.com, путь которых содержит /events/.
- Отправьте urls методом POST на /v1/facebook/event-details.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте 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 может дать не более одной записи мероприятия.
- Приватные, удаленные, ограниченные или доступные только после входа мероприятия могут завершиться без возвращенной записи.
Связанные API
Помимо 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 профилей или страниц: названия, расписание, места, медиа, видимые метрики и контекст источника.