facebook/
profiles

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

Facebook Profiles API

Поиск профилей
Поиск страниц
Известные URL
1,2 кредита за результат
Готово
Готово

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

README

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

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 задачи и читайте нормализованные записи профилей.

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

Помимо 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 профилей или страниц: подписи, контекст автора, метаданные видео, видимая вовлеченность и ссылки на источник.

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

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

Facebook Profiles API — FAQ

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

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

Нормализованная запись содержит id, platform, resource, type, url, name, text, avatar_url, metrics, created_at, collected_at и extra.input_url. Сейчас created_at возвращается как null.

Да, поиск рассчитан на URL публичных профилей или страниц. Их видимые поля различаются, поэтому клиентам не следует ожидать, что у каждой записи будут одинаковые описание, аватар или счетчики.

Каждый URL может дать не более одной записи, а дублирующиеся, приватные, доступные только после входа, удаленные, введенные с ошибкой или недоступные объекты могут не дать ни одной. Используйте extra.input_url, чтобы сопоставлять возвращенные записи с исходным запросом.

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