facebook/
video-transcript

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

Facebook Video Transcript API

Расшифровки видео
Известные URL
Текст со ссылкой на источник
0,7 кредита за результат
Готово
Готово

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

README

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

Facebook Video Transcript

Записи Facebook Video Transcript содержат устную речь из публичных видеопубликаций и роликов Reels вместе с исходным URL, текстом расшифровки, форматом и временем сбора. Эти записи помогают индексировать речь, проверять отобранный контент, вести архивы со ссылками на источник и дополнять отдельно собранные метаданные публикаций.

Возможности Facebook Video Transcript API

  • Пакеты расшифровок по известным URLПринимает список URL публичных видеопубликаций или роликов Reels в Facebook и удаляет точные дубли строк перед получением расшифровок.
  • Расшифровки со ссылкой на источникВозвращает каждую доступную расшифровку вместе с переданным исходным URL и ID записи, который при отсутствии другого ID заменяется этим URL.
  • Явный формат текстаПомечает возвращенный текст как plaintext или WebVTT и добавляет время сбора расшифровки для последующей обработки.
  • Только доступные результатыСоздает нормализованную запись, только если переданный публичный URL дает непустой текст расшифровки, поэтому результатов может быть меньше, чем входных URL.

Параметры Facebook Video Transcript API

ПараметрыОбязательныйОписание
urlsОбязательныйИзвестные URL публичных видеопубликаций или роликов Reels в Facebook, разделенные запятыми или переводами строки.

Как использовать Facebook Video Transcript API

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

  1. Подготовьте один или несколько известных URL публичных видеопубликаций или роликов Reels в Facebook; этот эндпоинт не находит видеоленту страницы сам.
  2. Отправьте urls методом POST на /v1/facebook/video-transcript и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items, переходите по next_cursor, пока has_more равно true, и используйте url и format каждой записи при сохранении текста.
curl -X POST "https://api.socq.ai/v1/facebook/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/reel/1535656380759655"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

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

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

Практические советы по Facebook Video Transcript API

  • Отправляйте известные URL публичных видеопубликаций или роликов Reels, предварительно проверив, что каждый объект доступен: некорректные, приватные, удаленные или неподдерживаемые медиафайлы могут не дать записи.
  • Приводите строки URL к каноническому виду перед формированием пакета, если одно видео может встречаться с параметрами отслеживания или в другой форме URL: бэкенд удаляет только точные дубли.
  • После успешного завершения сверяйте возвращенные значения url с отправленным списком, чтобы URL без непустой расшифровки оставались видимыми в вашем рабочем процессе.
  • Проверяйте format перед разбором text: запись webvtt может содержать разметку реплик, которую не следует обрабатывать как неструктурированный plaintext.
  • Продолжайте с results.next_cursor, пока has_more равно true, если пакет URL занимает больше одной страницы результатов.

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

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

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

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

Facebook Video Transcript API — FAQ

Facebook Video Transcript API — это программный интерфейс для извлечения доступного текста расшифровок по известным URL публичных видеопубликаций или роликов Reels в Facebook. Если непустая расшифровка доступна, он возвращает исходный URL, текст, формат вывода и время сбора.

Передайте непустой массив urls с известными URL публичных видеопубликаций или роликов Reels в Facebook. Запрос не принимает название страницы, поисковый запрос, выбор языка, формат расшифровки или results_limit.

Каждая нормализованная запись содержит id, platform, resource, type, url, text, language (может быть null), format, created_at, collected_at и extra. Названия видео, авторы, длительность, миниатюры, вовлеченность и метки времени сегментов в ответе не стандартизируются.

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

Этот эндпоинт не принимает параметр языка. В нормализованной схеме зарезервировано поле language, которое может быть null, но текущий сборщик Facebook не поддерживает выбор языка и не гарантирует метку языка источника.

Каждый возвращенный нормализованный результат расшифровки стоит 0,7 кредита. За входной URL, который не дал результата, плата за результат при текущей политике пустых результатов не взимается.