YouTube Downloader API

YouTube Downloader API превращает ссылку на видео в готовую ссылку для скачивания прямо в вашем приложении, боте или бэкенде — без автоматизации браузера и без локальной конвертации. Это руководство показывает, как сделать это одним запросом через Tunelio API.

Что делает YouTube Downloader API

Вместо того чтобы парсить страницы или запускать тяжёлый локальный экстрактор, вы отправляете ссылку на YouTube-видео на эндпоинт и получаете прямую подписанную ссылку на скачивание файла. Ваши серверы остаются лёгкими, а ответ приходит за один запрос — не нужно отслеживать ID задачи и опрашивать статус-эндпоинт.

Tunelio предоставляет ровно два эндпоинта. GET /info анализирует видео и перечисляет все доступные форматы с точным размером файла; GET /create возвращает прямую ссылку на скачивание в выбранном вами качестве. Благодаря этому интеграция остаётся достаточно компактной, чтобы разобраться в ней за один присест.

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

Каждый запрос передаёт ваш API-ключ как Bearer-токен. Новые аккаунты получают 100 бесплатных кредитов, а зарегистрироваться через Telegram или Email можно примерно за минуту — без банковской карты.

Authorization: Bearer tnl_your_api_key

Быстрый старт

Сначала проверьте видео, чтобы узнать, какие форматы доступны, а затем запросите прямую ссылку в нужном качестве. Ниже — весь процесс на cURL:

# 1. List available formats (6 credits)
curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_your_api_key"

# 2. Get a direct download URL for 1080p (10 credits)
curl "https://tunelio.dev/create?url=https://youtu.be/dQw4w9WgXcQ&quality=1080p" \
  -H "Authorization: Bearer tnl_your_api_key"

Ответ /create содержит поле url — подписанную ссылку на скачивание, которую можно сразу отдать пользователю или потоково сохранить в хранилище. Она остаётся действительной несколько часов.

Python

import os, requests

H = {"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"}

info = requests.get(
    "https://tunelio.dev/info",
    params={"url": "https://youtu.be/dQw4w9WgXcQ"},
    headers=H,
).json()
print(info["formats"][0]["quality"])  # e.g. "1080p"

dl = requests.get(
    "https://tunelio.dev/create",
    params={"url": "https://youtu.be/dQw4w9WgXcQ", "quality": "1080p"},
    headers=H,
).json()
print(dl["url"])  # direct download URL

Выбор качества и формата

Параметр quality принимает видео-метку — например, 144p, 240p, 360p, 480p, 720p или 1080p, а также 2160p (4K) на тарифе Mega. Передайте quality=mp3, чтобы получить файл только со звуком в формате MP3. Поскольку GET /info заранее сообщает точный размер каждого формата в байтах, вы можете показать пользователю размер ещё до того, как он решит скачивать.

Тарифы и кредиты

Каждый вызов /info стоит 6 кредитов, а каждый /create — 10; само скачивание файла по полученной ссылке бесплатно. Тарифы — от бесплатного пробного пакета на 100 кредитов до Pro ($9/мес, 100 000 кредитов), Ultra ($39/мес, 500 000 кредитов) и Mega ($89/мес, 1,5 млн кредитов с 4K MP4).

Дальнейшие шаги

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