youtube/
transcripts

Получайте доступные расшифровки по URL видео YouTube с необязательным выбором языка: нормализованный текст, язык и источник субтитров, контекст канала и длительность.

YouTube Transcripts API

Расшифровки
Простой текст
Предпочтительный язык
0,5 кредита за результат
Готово
Готово

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

README

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

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, резюмирования, перевода или комплаенса.

  1. Выберите URL публичных видео — лучше после того, как поиск или проверка метаданных отсеяли нерелевантные элементы.
  2. Отправьте urls и необязательный язык в формате BCP-47 методом POST на /v1/youtube/transcripts и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}; успешный пакет все же может содержать меньше результатов, чем было передано URL.
  4. Для каждого элемента проверяйте 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 и считайте результаты с резервным языком исключениями, требующими проверки.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

YouTube Transcripts API — FAQ

YouTube Transcripts API получает доступный текст субтитров по URL публичных видео YouTube с необязательным предпочтительным языком. Он возвращает нормализованный простой текст, фактический и доступные языки, источник субтитров, контекст видео, длительность и время сбора.

Передайте один или несколько URL публичных видео YouTube и необязательный предпочтительный язык в формате BCP-47.

Можно запросить предпочтительный язык. Если точного совпадения нет, API может выбрать базовый язык или другую доступную расшифровку. Всегда читайте возвращенное поле language.

Видео без доступных публичных субтитров или текста расшифровки не дает результата расшифровки.

Нет. Ответ возвращается в виде простого текста и не содержит временных меток сегментов или гарантированных меток говорящих.

Нет. Точность зависит от того, добавлены ли субтитры автором или созданы автоматически, а также от качества звука, языка и говорящих.

Каждый возвращенный нормализованный результат расшифровки стоит 0,5 кредита.