Документация API

REST API для транскриптов YouTube, поиска и метаданных. Получите API-ключ в своей панели управления — 100 бесплатных кредитов, карта не требуется.

Аутентификация

Передайте свой API-ключ как bearer-токен или через x-api-key:

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

Базовый URL

https://getyoutubetranscript.com/api/v1

Кредиты и тарифы

ТарифЦенаКредиты/месЦена топ-апаЛимит запросов
Бесплатный$0100 (единоразово)60 запросов/мин
Помесячный$5.00/мес1000$2.50 / 1000200 запросов/мин
Годовой$4.50/мес ($54/год)1000$1.50 / 1000300 запросов/мин

1 кредит = 1 успешный запрос. Неудачные запросы никогда не списываются. Дополнительные кредиты (топ-ап) истекают через 30 дней с момента покупки или в конце текущего расчётного периода — в зависимости от того, что наступит позже, и требуют активной подписки для использования.

Эндпоинты

GET/transcript1 кредит

Получить транскрипт видео YouTube с метаданными (название, канал, миниатюра).

ПараметрОбязательныйОписание
vДаID видео или полная ссылка YouTube
languageНетКод языка (по умолчанию: en)

Запрос

curl "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw" \
  -H "Authorization: Bearer sk_live_..."

Ответ

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39
  }
}
GET/search1 кредит / страница

Поиск видео YouTube с фильтрами и постраничной навигацией.

ПараметрОбязательныйОписание
qДаПоисковый запрос (минимум 2 символа)
countryНетДвухбуквенный код страны (по умолчанию: us)
languageНетКод языка (по умолчанию: en)
page_tokenНетЗначение pagination.next_page_token из предыдущего ответа для получения следующей страницы
limitНетМаксимум результатов (по умолчанию 20, максимум 50)

Запрос

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

Ответ

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}
GET/resolveБесплатно

Определить реальный ID канала по его хэндлу, URL или имени пользователя. Синтаксический ввод (уже являющийся ID канала или URL, содержащим его) обрабатывается мгновенно без сетевого запроса; обычный хэндл запускает один реальный поиск.

ПараметрОбязательныйОписание
handleДаID канала, URL или @хэндл

Запрос

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Ответ

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "scrape"
  }
}
GET/playlist1 кредит / страница

Получить видео из плейлиста. В настоящее время возвращается только первая страница — has_more показывает, есть ли ещё видео, но загрузка дополнительных страниц пока не поддерживается.

ПараметрОбязательныйОписание
listДаID или URL плейлиста

Запрос

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

Ответ

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true
  }
}

Ошибки

Ошибки возвращают тело JSON со стабильным полем code для ветвления логики, в дополнение к HTTP-статусу:

СтатусКодЗначение
400BAD_REQUESTОтсутствует или некорректен параметр
401MISSING_API_KEY / INVALID_API_KEYКлюч не передан или недействителен/отозван
402PAYMENT_REQUIREDКредиты закончились — купите топ-ап или обновите тариф
404VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUNDВидео или ресурс не найден
429RATE_LIMITEDСлишком много запросов для вашего тарифа
503UPSTREAM_UNAVAILABLEВременная проблема на стороне источника — можно безопасно повторить запрос

Скоро

Поиск внутри канала, список всех видео канала и полная постраничная навигация по плейлистам находятся в разработке. Отслеживание новых загрузок через RSS временно недоступно из-за проблемы на стороне YouTube, не связанной с нами.

Использование этого API с AI-инструментом

Предпочитаете, чтобы Claude (или другой AI-инструмент для написания кода) сам вызывал этот API вместо ручного написания запросов? Скачайте навык YouTube Transcript — готовый Claude Skill, который научит его получать транскрипты, выполнять поиск и многое другое.