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 задачи и читайте нормализованные записи мероприятий с курсорной пагинацией.
- Подготовьте непустой запрос с ключевым словом и при необходимости выберите results_limit от 7 до 2 000.
- Отправьте query и results_limit методом POST на /v1/facebook/events-search.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте /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 каждого мероприятия, чтобы не учитывать одно мероприятие дважды.
- Считайте место проведения, обложку, число откликов и поля статуса мероприятия необязательными при сопоставлении записей с вашим приложением.
Связанные API
Помимо 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 профилей или страниц: названия, расписание, места, медиа, видимые метрики и контекст источника.