Facebook Reels
Facebook Reels — это короткие публичные видео в лентах профилей или страниц с подписями, данными автора, метаданными воспроизведения, метками времени и видимой вовлеченностью. Эти записи помогают вести каталоги контента, исследовать короткие видео, следить за лентами и проводить сравнительный анализ.
Возможности Facebook Reels API
- Ленты Reels нескольких профилейСобирайте публичные записи роликов Reels по одному или нескольким URL профилей или страниц Facebook; запрошенный лимит применяется к каждому входному URL, а extra.input_url сохраняется для указания источника.
- Нормализованные видеоданныеВозвращает URL видео, миниатюры, размеры и длительность вместе с ID роликов Reels и публичными ссылками на источник.
- Автор и вовлеченностьСохраняет подписи, исходные публичные данные автора, видимые лайки, комментарии, просмотры, воспроизведения, репосты и время публикации для каждого нормализованного ролика.
- Стабильный обход лентыПереходит по курсорам конкретного профиля и удаляет дубли роликов Reels по ID, ID публикации или URL, пока не будет достигнут лимит на входной URL.
Параметры Facebook Reels API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных профилей или страниц Facebook, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число роликов Reels для сбора на каждый входной URL, от 20 до 2 000; по умолчанию 100. |
Как использовать Facebook Reels API
Отправьте URL публичных профилей или страниц как асинхронную задачу, опрашивайте ее по ID задачи и читайте нормализованные записи роликов Reels с курсорной пагинацией результатов.
- Подготовьте один или несколько URL публичных профилей или страниц Facebook с лентами Reels.
- Отправьте urls с необязательным results_limit методом POST на /v1/facebook/reels.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, если сохраненных роликов больше.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
-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 Reels API
- Каталог Reels профиля: Сводите ID роликов, ссылки на источник, подписи, ссылки на видео, метки времени и extra.input_url в индекс контента по каждому профилю.
- Исследование формата коротких видео: Сравнивайте длительность, размеры, миниатюры, подписи и видимую вовлеченность, чтобы изучать, как оформляются и воспринимаются публичные Reels.
- Мониторинг лент Reels: Повторяйте сбор для выбранных URL профилей или страниц и используйте стабильную идентичность ролика и время публикации, чтобы находить новые записи.
Практические советы по Facebook Reels API
- Используйте URL профилей и страниц на facebook.com, www.facebook.com или m.facebook.com, у которых есть публичная лента Reels; проверка хоста сама по себе не гарантирует, что ресурс подходит.
- Задавайте results_limit с учетом числа входных URL: лимит от 20 до 2 000 применяется к каждому URL независимо.
- При объединении повторных запусков удаляйте дубли по ID ролика, ID публикации или URL вместе с extra.input_url, чтобы сохранить правильный исходный профиль.
- Считайте подписи, поля автора, метрики, метки времени и метаданные медиафайлов необязательными и проверяйте, что media содержит URL видео, прежде чем воспроизводить или скачивать его.
- Если нужен текст устной речи, передайте известный URL ролика в Facebook Video Transcript API, а не ожидайте расшифровку в записях Reels.
Связанные API
Помимо Facebook Reels API, используйте эти API, когда нужен другой тип публичных данных Facebook.
- Facebook Posts API — Собирайте публичные публикации, медиа, реакции, комментарии и репосты по поддерживаемым URL Facebook.
- Facebook Comments API — Собирайте публичные комментарии, авторов, вовлеченность, медиа и ссылки на источник по URL публикаций.
- 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: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.