API транскрипций YouTube на Python: быстрый старт за 5 минут

Один запрос — один транскрипт

Самый короткий путь — GET на /v1/transcripts/{videoId} с ключом в заголовке Authorization. Ответ — JSON: id видео, язык, длительность и список сегментов. SDK не нужен — достаточно requests или httpx.

Выбор языка и формата

Сначала вызовите /v1/transcripts/{videoId}/languages, если видео может быть многоязычным, выберите дорожку и передайте ?lang= и ?format=. srt или vtt дают готовые к сохранению субтитры; json сохраняет структурированные сегменты.

Пакеты и повторы

Для списков отправьте до 50 id в /v1/transcripts одним вызовом и читайте результат по элементам. Добавьте таймаут и небольшой экспоненциальный backoff: временные сбои и 429 быстро проходят, а каждый ответ несёт X-Request-ID для логов.

Сложные случаи

У одних видео нет субтитров, другие приватные или заблокированы по региону. API отвечает типизированным кодом ошибки и читаемым сообщением, так что код ветвится по коду, а не по тексту. Логируйте request id — это самый быстрый путь к исправлению.