YouTube Transcripts
Расшифровки YouTube — это текстовые версии доступных субтитров публичных видео с языком, источником субтитров, контекстом канала, сведениями о публикации и длительностью. Такой текст помогает с доступностью контента, поиском, проверкой цитат, тематическим анализом, резюмированием и индексацией контента.
Возможности YouTube Transcripts API
- Расшифровки нескольких видеоПолучайте доступный текст расшифровок по нескольким URL публичных видео в одном запросе.
- Выбор предпочтительного языкаЗапрашивайте предпочтительный язык с корректным кодом BCP-47, например en или zh-CN.
- Метаданные о доступных языкахВозвращает фактически выбранный язык и список языков, на которых доступны расшифровки.
- Расшифровка в виде простого текстаПредоставляет единообразный простой текст со сведениями об источнике расшифровки, если они известны.
- Прослеживаемый контекст видеоСвязывает каждую расшифровку с ID видео, названием, сведениями о канале, датой публикации, длительностью и collected_at.
Параметры YouTube Transcripts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных видео YouTube, разделенные запятыми или переводами строки. |
language | Необязательный | Необязательный предпочтительный язык субтитров в формате BCP-47, например en или zh-CN; возвращенный язык может отличаться. |
Как использовать YouTube Transcripts API
Запрашивайте субтитры только после того, как выбрали нужные видео. Затем проверяйте возвращенный язык и источник, прежде чем текст попадет в процессы поиска, RAG, резюмирования, перевода или комплаенса.
- Выберите URL публичных видео — лучше после того, как поиск или проверка метаданных отсеяли нерелевантные элементы.
- Отправьте urls и необязательный язык в формате BCP-47 методом POST на /v1/youtube/transcripts и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}; успешный пакет все же может содержать меньше результатов, чем было передано URL.
- Для каждого элемента проверяйте language, available_languages и transcript_source, прежде чем разбивать простой текст на фрагменты; листайте страницы, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/transcripts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Сценарии использования YouTube Transcripts API
- Резюмирование видео: Используйте доступный текст расшифровок, чтобы создавать резюме, исследовательские заметки или контентные брифы по длинным видео.
- Архивы видео с поиском: Индексируйте текст расшифровок вместе с ID видео, названиями, сведениями о канале и метаданными языка.
- Извлечение тем и информации: Выявляйте темы, сущности, утверждения и ключевые слова в выбранной подборке публичных видео.
- Перевод и локализация: Используйте поля выбранного и доступных языков, чтобы направлять текст расшифровок в процессы перевода.
Практические советы по YouTube Transcripts API
- Всегда ориентируйтесь на возвращенный язык, а не на запрошенный. Резервный вариант вполне может выбрать другую доступную дорожку.
- Автоматически созданные субтитры могут содержать ошибки в именах, пунктуации и отраслевых терминах. Сохраняйте transcript_source и сверяйте с видео фрагменты, от которых многое зависит.
- Успешная задача с меньшим числом элементов обычно означает, что у части видео не было пригодных публичных субтитров; это не обязательно сбой пакета.
- Простой текст не содержит временных меток сегментов и меток говорящих. Не восстанавливайте по этому ответу точное время цитат.
- Разбивайте текст на фрагменты на своей стороне, но сохраняйте ID видео, язык, источник и collected_at в каждом фрагменте, чтобы цитаты оставались прослеживаемыми.
- Используйте Videos, чтобы добавить название, медиа и публичные метрики, если расшифровка будет показана в каталоге с поиском.
- Если обязательно точное покрытие языков, сначала сравните available_languages и считайте результаты с резервным языком исключениями, требующими проверки.
Связанные API
Помимо YouTube Transcripts API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Channel Live Videos API — Собирайте публичные записи трансляций из разделов прямых эфиров канала с контекстом источника и видимыми метриками.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API