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