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