facebook/
profile-events

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

Facebook Profile Events API

Мероприятия профилей
Пакеты URL
Публичные данные
0,6 кредита за результат
Готово
Готово

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

README

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

Facebook Profile Events

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

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

  • Ленты мероприятий профилей и страницСобирайте публичные анонсы мероприятий, связанные с одним или несколькими переданными URL профилей или страниц Facebook.
  • Идентификаторы и расписание мероприятийВозвращает ID мероприятий, публичные URL, названия, описания, места проведения, нормализованное время начала и окончания.
  • Медиафайлы и видимые метрикиСохраняет нормализованные ссылки на публичные изображения или видео и стандартные видимые метрики, переданные с каждым мероприятием.
  • Нормализованный контекст источникаДобавляет переданный исходный URL к каждой нормализованной записи и удаляет дубли мероприятий по ID или URL в пределах ленты этого источника.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько URL профилей или страниц Facebook на facebook.com, www.facebook.com или m.facebook.com.
results_limitНеобязательныйМаксимальное число записей мероприятий для сбора на каждый входной URL, от 20 до 2 000; по умолчанию 100.

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

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

  1. Подготовьте один или несколько URL профилей или страниц Facebook и при необходимости выберите results_limit от 20 до 2 000 для каждого URL.
  2. Отправьте urls и необязательный results_limit методом POST на /v1/facebook/profile-events.
  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/profile-events" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'

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

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

  • Обогащение календарей организаторов: Используйте названия, описания, места проведения, время начала и окончания мероприятий, чтобы обогащать календари на основе известных публичных страниц организаторов.
  • Перечень мероприятий по разным страницам: Группируйте нормализованные ID и URL мероприятий по input_url, чтобы сравнивать публичные анонсы выбранных профилей или страниц.
  • Очереди сбора данных о мероприятиях: Используйте возвращенные URL мероприятий, чтобы формировать очередь без дублей для получения подробных данных о каждом мероприятии.
  • Отчеты о публичном расписании: Объединяйте поля расписания, ссылки на медиафайлы и видимые метрики в отчеты о мероприятиях, связанных с отслеживаемыми публичными источниками.

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

  • Отправляйте профили или страницы, у которых есть лента мероприятий: проверка хоста сама по себе не подтверждает, что URL Facebook подходит в качестве источника.
  • Выбирайте results_limit с учетом числа входных URL: лимит и расчетная стоимость за результаты применяются к каждому URL отдельно.
  • Если одно мероприятие может быть связано с несколькими переданными источниками, удаляйте дубли в объединенных результатах по ID мероприятия или публичному URL.
  • Считайте текст описания, место проведения, время окончания, медиафайлы и отдельные значения метрик необязательными при сопоставлении записей с вашим приложением.

Помимо Facebook Profile Events 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 Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.

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

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

Facebook Profile Events API — FAQ

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

Отправляйте один или несколько URL на facebook.com, www.facebook.com или m.facebook.com. Проверка касается только хоста, поэтому используйте профили или страницы, подходящие для публичной ленты мероприятий.

results_limit по умолчанию равен 100 и принимает целые числа от 20 до 2 000. Лимит применяется к каждому переданному URL отдельно, а сбор по источнику может завершиться раньше, если публичных мероприятий больше нет.

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

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

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