Facebook Profiles
Профили и страницы Facebook — это публичные карточки с именем, описанием профиля или текстом «О себе», аватаром, каноническими ссылками и видимыми счетчиками аудитории или активности. Эти поля идентичности и публичные сигналы помогают обогащать URL, сопоставлять сущности, фиксировать метаданные на определенный момент и проводить сравнительные исследования.
Возможности Facebook Profiles API
- Прямой поиск по известным URLПередайте несколько URL публичных профилей или страниц Facebook и получите не более одной нормализованной записи профиля на каждый входной URL.
- Нормализованные поля идентичностиВозвращает ID Facebook, канонический URL, отображаемое имя, тип записи и исходный входной URL в единой структуре.
- Публичное представление профиляСохраняет публичное описание профиля, вступление, описание или текст «О себе» вместе с доступным аватаром профиля или страницы.
- Видимые счетчики профиляНормализует стандартные публичные счетчики подписчиков, подписок, публикаций, лайков, комментариев, просмотров, воспроизведений и репостов, которые показывает объект.
Параметры Facebook Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательные URL публичных профилей или страниц Facebook. Допустимые хосты: facebook.com, www.facebook.com и m.facebook.com; несколько значений разделяйте запятыми или переводами строки. |
Как использовать Facebook Profiles API
Отправьте URL профилей или страниц как асинхронную задачу, опрашивайте ее по ID задачи и читайте нормализованные записи профилей.
- Подготовьте один или несколько URL публичных профилей или страниц на facebook.com, www.facebook.com или m.facebook.com.
- Отправьте urls методом POST на /v1/facebook/profiles.
- Опрашивайте /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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Сценарии использования Facebook Profiles API
- Обогащение каталога профилей и страниц: Добавляйте нормализованные ID, имена, канонические ссылки, текст описания, аватары и видимые счетчики в каталог известных URL Facebook.
- Сопоставление сущностей по известным URL: Используйте возвращенные ID, канонические URL, имена и extra.input_url, чтобы связывать переданные ссылки с существующими записями сущностей.
- Снимки публичных метаданных: Храните collected_at вместе с доступным текстом профиля, аватаром и счетчиками, чтобы сравнивать публичные метаданные между запусками сбора.
Практические советы по Facebook Profiles API
- Проверяйте, что каждый URL указывает на нужный профиль или страницу: проверка запроса касается хоста Facebook, но не пути к ресурсу.
- Сохраняйте extra.input_url при сверке задачи с несколькими URL: из-за дублей или недоступных входных данных записей может оказаться меньше, чем переданных URL.
- Считайте имена, текст профиля, аватары и отдельные значения метрик значениями, которые могут быть null: личные профили и страницы показывают разные публичные поля.
- Используйте соответствующий эндпоинт контента Facebook, если вам нужны публикации, фотографии, Reels, мероприятия или отзывы, а не метаданные уровня профиля.
Связанные API
Помимо Facebook Profiles API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Pages API — Получайте публичные профили страниц, контактные данные, изображения и видимые оценки аудитории.
- Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- Facebook Profile Events API — Собирайте публичные мероприятия, связанные с URL профилей или страниц: названия, расписание, места, медиа, видимые метрики и контекст источника.
- Facebook Profile Photos API — Собирайте публичные фото по URL профилей или страниц: подписи, контекст автора, вовлеченность, метаданные изображений и ссылки на источник.
- Facebook Reels API — Собирайте публичные Reels по URL профилей или страниц: подписи, контекст автора, метаданные видео, видимая вовлеченность и ссылки на источник.