Документация 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Кредиты и тарифы
| Тариф | Цена | Кредиты/мес | Цена топ-апа | Лимит запросов |
|---|---|---|---|---|
| Бесплатный | $0 | 100 (единоразово) | — | 60 запросов/мин |
| Помесячный | $5.00/мес | 1000 | $2.50 / 1000 | 200 запросов/мин |
| Годовой | $4.50/мес ($54/год) | 1000 | $1.50 / 1000 | 300 запросов/мин |
1 кредит = 1 успешный запрос. Неудачные запросы никогда не списываются. Дополнительные кредиты (топ-ап) истекают через 30 дней с момента покупки или в конце текущего расчётного периода — в зависимости от того, что наступит позже, и требуют активной подписки для использования.
Эндпоинты
/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
}
}/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": "..." }
}
}/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"
}
}/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-статусу:
| Статус | Код | Значение |
|---|---|---|
| 400 | BAD_REQUEST | Отсутствует или некорректен параметр |
| 401 | MISSING_API_KEY / INVALID_API_KEY | Ключ не передан или недействителен/отозван |
| 402 | PAYMENT_REQUIRED | Кредиты закончились — купите топ-ап или обновите тариф |
| 404 | VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND | Видео или ресурс не найден |
| 429 | RATE_LIMITED | Слишком много запросов для вашего тарифа |
| 503 | UPSTREAM_UNAVAILABLE | Временная проблема на стороне источника — можно безопасно повторить запрос |
Скоро
Поиск внутри канала, список всех видео канала и полная постраничная навигация по плейлистам находятся в разработке. Отслеживание новых загрузок через RSS временно недоступно из-за проблемы на стороне YouTube, не связанной с нами.
Использование этого API с AI-инструментом
Предпочитаете, чтобы Claude (или другой AI-инструмент для написания кода) сам вызывал этот API вместо ручного написания запросов? Скачайте навык YouTube Transcript — готовый Claude Skill, который научит его получать транскрипты, выполнять поиск и многое другое.