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 задачи и читайте нормализованные записи мероприятий с курсорной пагинацией.
- Подготовьте один или несколько URL профилей или страниц Facebook и при необходимости выберите results_limit от 20 до 2 000 для каждого URL.
- Отправьте urls и необязательный results_limit методом POST на /v1/facebook/profile-events.
- Опрашивайте /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/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.
- Считайте текст описания, место проведения, время окончания, медиафайлы и отдельные значения метрик необязательными при сопоставлении записей с вашим приложением.
Связанные API
Помимо 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: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.