facebook/
reels

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

Facebook Reels API

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

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

README

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

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 с курсорной пагинацией результатов.

  1. Подготовьте один или несколько URL публичных профилей или страниц Facebook с лентами Reels.
  2. Отправьте urls с необязательным results_limit методом POST на /v1/facebook/reels.
  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/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.

Помимо 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: данные аккаунта, описание, аватар, видимые счетчики и контекст входных данных.

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

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

Facebook Reels API — FAQ

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

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

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

Нет. Записи Reels содержат подписи и метаданные видео, а доступный текст устной речи для поддерживаемых URL роликов обрабатывает отдельный Facebook Video Transcript API.

Нет. Этот эндпоинт читает ленты Reels по известным URL публичных профилей или страниц; поиск по ключевым словам, поиск трендов и поиск по аудио он не поддерживает.

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

Нет. Сбор останавливается на лимите для URL, в конце доступной ленты или после 100 страниц ленты, а приватные, ограниченные, удаленные, доступные только после входа или по иной причине недоступные ролики могут отсутствовать.

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