facebook/
profile-photos

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

Facebook Profile Photos API

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

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

README

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

Facebook Profile Photos

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

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

  • Фотоленты нескольких профилейСобирайте публичные записи фотографий по одному или нескольким URL профилей или страниц Facebook; запрошенный лимит применяется к каждому входному URL отдельно.
  • Нормализованные метаданные изображенийВозвращает URL изображений, миниатюры, ширину, высоту и длительность вместе с ID фотографий и каноническими ссылками.
  • Контекст фотографии и источникаСохраняет подписи, публичные данные автора, видимую вовлеченность, метки времени и extra.input_url для анализа и указания источника.
  • Обход ленты по курсоруПереходит по курсорам публичной фотоленты и удаляет дубли по стабильному ID, URL или идентичности изображения, пока не будет достигнут лимит на входной URL.

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

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

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

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

  1. Подготовьте один или несколько URL публичных профилей или страниц Facebook.
  2. Отправьте urls с необязательным results_limit методом POST на /v1/facebook/profile-photos.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, если сохраненных фотографий больше.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'

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

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

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

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

  • Используйте URL профилей и страниц на facebook.com, www.facebook.com или m.facebook.com, у которых есть публичная фотолента; проверка хоста сама по себе не гарантирует, что ресурс подходит.
  • Задавайте results_limit с учетом числа входных URL: лимит от 20 до 2 000 применяется к каждому URL независимо.
  • При объединении запусков удаляйте дубли по id фотографии, URL или идентичности изображения вместе с extra.input_url, чтобы сохранить правильный исходный профиль.
  • Считайте подписи, поля автора, метрики, метки времени и размеры медиафайлов необязательными и проверяйте, что media содержит URL изображения, прежде чем отображать или скачивать его.

Помимо Facebook Profile Photos API, используйте эти API, когда нужен другой тип публичных данных Facebook.

  • Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
  • Facebook Video Transcript API — Извлекайте доступный текст расшифровки и формат по URL известных публичных видеопубликаций или Reels.
  • Facebook Group Posts API — Собирайте публичные публикации по URL групп Facebook с выбором порядка, лимитом на группу, контекстом автора, видео и видимой вовлеченностью.
  • Facebook Ad Transcript API — Извлекайте доступный текст речи, язык, формат и контекст источника по URL из Facebook Ad Library.
  • Facebook Profiles API — Получайте публичные профили или страницы по известным URL Facebook: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.
  • Facebook Reels API — Собирайте публичные Reels по URL профилей или страниц: подписи, контекст автора, метаданные видео, видимая вовлеченность и ссылки на источник.

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

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

Facebook Profile Photos API — FAQ

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

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

Запись может содержать ID фотографии, канонический URL, текст подписи, исходные публичные данные автора, видимые метрики, URL и размеры медиафайлов, created_at, collected_at и extra.input_url.

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

Приватные, ограниченные, удаленные, доступные только после входа или по иной причине недоступные фотографии не возвращаются. Структура альбомов, комментарии, отмеченные люди, полная разбивка реакций и загрузка оригинальных файлов не гарантируются.

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