Вопросы, которые задают до регистрации

Что такое massbots и кому это нужно?

massbots — инфраструктура для скачивания видео с YouTube, к которой вы подключаете собственного Telegram-бота. Она нужна разработчикам ботов и сервисов, которым требуется стабильно отдавать пользователям видео, аудио и субтитры, не содержа для этого собственный парк серверов и не подстраиваясь под изменения площадки. Сейчас к API подключено 56 ботов, через него проходит 4,4 млн скачиваний в месяц.

Нужен ли собственный Telegram-бот?

Да. Готовый файл доставляется в Telegram, а API возвращает его file_id — идентификатор, который ваш бот отправляет пользователям без повторной загрузки. Без бота в цепочке пока никак: автономное скачивание по прямой ссылке или в ваше хранилище мы открываем по запросу и сначала измеряем спрос.

Что доступно по запросу

Какие площадки поддерживаются?

Сейчас — только YouTube: данные о видео и канале, форматы, скачивание до 1080p, выбор языка озвучки, субтитры и поиск. Другие площадки открываем по запросу, сроков не обещаем.

Как войти на сайт?

Через Telegram. Паролей нет: нажмите «Войти», подтвердите вход в Telegram — и вы в кабинете. Там же добавляется бот, выпускается токен и пополняется баланс.

Что такое поинты и сколько они стоят?

Поинты — единица расчёта. 1 000 поинтов равны 1 $. Каждый запрос списывает фиксированное число поинтов: данные о видео — 1, поиск — 5, скачивание — 10, а повторная отдача ролика, который ваш бот уже получал, — 2. Полная таблица опубликована на странице цен.

Смотреть все цены

С какой суммы можно начать?

Пополнение от 5 $ — это 5 000 поинтов, примерно 500 скачиваний. При регистрации вы получаете 200 бесплатных поинтов без карты: их хватит на 20 скачиваний в 720p или 100 повторных отдач уже полученных роликов.

Списываются ли поинты за ошибки?

Нет. Запрос, завершившийся ошибкой HTTP — недоступное видео, неверный параметр, сбой на нашей стороне — не тарифицируется. Стоимость скачивания списывается один раз; последующие запросы статуса той же загрузки бесплатны.

Почему повторная отдача дешевле?

Потому что file_id в Telegram привязан к конкретному боту. Первая выдача ролика вашему боту — это работа: файл нужно получить и передать именно вашему боту, чтобы у него появился собственный file_id. Когда ваш бот уже получал этот ролик в этом формате, файл уже у него есть — мы отдаём готовый идентификатор, и запрос стоит 2 поинта вместо 10. Общий кэш из 95 миллионов файлов на цену не влияет: ролик, который заказывал кто-то другой, а ваш бот ещё нет, стоит полную цену. Кэш даёт другое — скорость: такой ролик не нужно скачивать с YouTube заново, и file_id приходит в первом же ответе.

Что произойдёт, когда баланс закончится?

Запросы, требующие списания, начнут возвращать 403 с сообщением о недостаточном балансе. Токен и подключённые боты остаются на месте: пополните баланс — и запросы снова заработают. Бесплатные методы, например проверка баланса и список форматов, продолжают отвечать.

Чем отличаются пакеты пополнения?

Только размером бонуса. Пакет за 5 $ даёт ровно 5 000 поинтов, пакет за 250 $ — 300 000, то есть на 20% больше расчётного. Стоимость запросов при этом одинакова для всех: 1000 скачиваний обходятся в 10 $ на любом пакете.

Как передавать токен?

В заголовке X-Token каждого запроса. Если к аккаунту подключено несколько ботов, добавьте заголовок X-Bot-Id с числовым идентификатором бота, от имени которого выполняется запрос. С одним ботом второй заголовок не нужен.

Подробнее в быстром старте

Как устроено скачивание?

Один и тот же запрос GET /video/{id}/download/{format} и запускает загрузку, и возвращает её статус. Если файл в кэше, file_id приходит сразу. Иначе вы получаете status: queued или downloading и повторяете запрос раз в несколько секунд, пока не придёт ready с file_id. Загрузку мы доводим до конца сами: в ответе будет либо file_id, либо понятная причина отказа, за которую поинты не списываются.

Пример с опросом статуса

Какие форматы и качество доступны?

Набор зависит от ролика. Запросите GET /video/{id}/formats — в ответе будут доступные варианты качества, отметка cached у тех, что уже лежат в общем кэше, и список дорожек озвучки; размер файла возвращается только у форматов без отметки cached. Максимальное качество — 1080p. Для роликов с несколькими дорожками озвучки язык выбирается параметром lang. Флаг cached говорит о скорости ответа, а не о цене запроса.

Есть ли ограничение на частоту запросов?

Тарифов с лимитом запросов нет — вы платите за фактические вызовы. При этом есть защита от слишком частого опроса статуса одной и той же загрузки: если спрашивать чаще, чем раз в несколько секунд, API ответит status: downloading и подсказкой о рекомендуемой паузе. Разумный интервал — пять-семь секунд.

Нужно ли передавать вам токен моего бота от BotFather?

Нет. В кабинете указывается только @username бота. Токен BotFather остаётся у вас, и все сообщения пользователям отправляет ваш собственный код — мы лишь отдаём file_id.

Можно ли подключить несколько ботов?

Да, к одному аккаунту можно привязать несколько ботов и использовать общий баланс. В запросах указывайте, от имени какого бота работаете, через заголовок X-Bot-Id.

Как файл попадает к моему боту?

Готовый файл доставляется вашему боту внутри Telegram, а API возвращает его file_id. Дальше бот отправляет файл пользователю стандартным методом Bot API — sendVideo или sendAudio — по этому идентификатору, не скачивая файл на свой сервер.