YouTube Full

YouTube Full

Полноценный инструмент для работы с YouTube на базе TranscriptAPI.com. Всё необходимое — в одном навыке.

Настройка

Если переменная $TRANSCRIPT_API_KEY не задана, необходимо создать аккаунт (100 бесплатных кредитов, без привязки карты).

Шаг 1 — Регистрация: укажите email пользователя и создайте безопасный пароль.

node ./scripts/tapi-auth.js register --email USER_EMAIL --password SECURE_PASS --json

→ На email будет отправлен OTP-код. Проверьте почту и введите 6-значный код подтверждения. ⚠️ Сохраните пароль — он понадобится на следующем шаге.

Шаг 2 — Подтверждение: используйте тот же пароль и полученный OTP.

node ./scripts/tapi-auth.js verify --email USER_EMAIL --password SECURE_PASS --otp CODE --json

→ В ответ вы получите api_key (начинается с sk_).

Шаг 3 — Сохранение: сохраните ключ (автоматически настраивает окружение и агент).

node ./scripts/tapi-auth.js save-key --key API_KEY --json

→ После этого всё готово к работе. Ключ будет автоматически подхвачен системой.

Альтернативный способ: зарегистрироваться на transcriptapi.com → Dashboard → API Keys.

Получение транскрипта — 1 кредит

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
-H "Authorization: Bearer $TRANSCRIPT_API_KEY"

Параметры:

• video_url — обязателен (URL видео или ID)
• format — json / text
• include_timestamp — включить таймкоды
• send_metadata — добавить метаданные

Поиск — 1 кредит

# Видео
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20"

# Каналы
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10"

Параметры:

• q — поисковый запрос (1–200 символов)
• type — video или channel
• limit — от 1 до 50

Каналы

Определение channel ID — бесплатно

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@handle"

Последние 15 видео — бесплатно

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel_id=UC_ID"

Все видео канала — 1 кредит за страницу

# Первая страница
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel_id=UC_ID"

# Следующие страницы
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN"

Поиск внутри канала — 1 кредит

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\
?channel_id=UC_ID&q=QUERY&limit=30"

Плейлисты — 1 кредит за страницу

# Первая страница
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist_id=PL_ID"

# Следующие страницы
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN"

Стоимость операций

• Транскрипт — 1 кредит
• Поиск — 1 кредит
• Resolve канала — бесплатно
• Последние видео — бесплатно
• Видео канала — 1 кредит/страница
• Поиск по каналу — 1 кредит
• Плейлисты — 1 кредит/страница

Правила валидации

• channel_id — формат UCxxxxxxxxxxxxxxxxxxxxxx
• playlist_id — начинается с PL, UU, LL, FL или OL
• q — 1–200 символов
• limit — 1–50

Ошибки

• 401 — неверный API-ключ
• 402 — закончились кредиты
• 404 — ресурс не найден
• 408 — таймаут (повторить запрос)
• 422 — ошибка параметров
• 429 — превышен лимит запросов

Типовые сценарии

Исследование: поиск → выбор видео → получение транскрипта.

# Поиск
curl -s ".../search?q=machine+learning"

# Транскрипт
curl -s ".../transcript?video_url=VIDEO_ID"

Мониторинг канала: resolve → последние видео → транскрипт.

# Resolve
curl -s ".../channel/resolve?input=@channel"

# Последние видео
curl -s ".../channel/latest?channel_id=UC_ID"

# Транскрипт
curl -s ".../transcript?video_url=VIDEO_ID"