API для выгрузки постов публичных каналов

Создавайте выгрузки запросом с токеном, проверяйте статус задания и получайте ссылку на готовый файл. Баланс и цена те же, что в кабинете, до 50 каналов в одном запросе.

Получить токен Интерактивная документация

Как подключиться

Зарегистрируйтесь и пополните баланс, API списывает деньги с него.
Создайте токен в разделе «API» личного кабинета. Полный ключ показывается один раз.
Передавайте токен в заголовке Authorization: Bearer YOUR_TOKEN. Адрес API начинается с https://vygruzka.online/api/v1.
Полное описание методов смотрите в интерактивной документации.

Какие методы есть

Методы API Выгрузки
Метод	Путь	Что делает
POST	`/jobs`	Создать задание для одного канала
POST	`/jobs/batch`	Создать одно задание по списку каналов, до 50 в запросе
GET	`/jobs`	Список ваших заданий, по умолчанию 50 записей, максимум 100
GET	`/jobs/{job_id}`	Статус задания
GET	`/jobs/{job_id}/download`	Ссылка на готовый файл
DELETE	`/jobs/{job_id}`	Отменить задание
GET	`/billing/balance`	Баланс аккаунта
GET	`/channels/preview`	Проверка канала и оценка до запуска

Пример: выгрузка трёх каналов

Запрос создаёт задание для трёх публичных каналов без комментариев. Три канала стоят 40 ₽ (20 + 2 × 10), то есть 4000 копеек в поле total_cost_kopecks. Ключ client_idempotency_key необязателен: повторный запрос с тем же ключом вернёт уже созданное задание и не создаст второе. Ключ не длиннее 64 символов.

Создание заданий

curl -X POST https://vygruzka.online/api/v1/jobs/batch \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_urls": [
      "https://t.me/channel_one",
      "https://t.me/channel_two",
      "https://t.me/channel_three"
    ],
    "format": "xlsx",
    "merge": true,
    "filters": { "collect_comments": false },
    "client_idempotency_key": "report-2026-11-01"
  }'

Ответ

{
  "job_ids": ["JOB_ID"],
  "total_cost_kopecks": 4000,
  "already_running": false
}

Статус задания запрашивается по номеру из ответа. Когда в поле status значение done, можно получить ссылку на файл. Ссылка действует час, сам файл хранится 7 дней.

Статус задания

curl https://vygruzka.online/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Ссылка на файл

curl https://vygruzka.online/api/v1/jobs/JOB_ID/download \
  -H "Authorization: Bearer YOUR_TOKEN"

Ответ со ссылкой

{
  "download_url": "https://vygruzka.online/api/files/JOB_ID/download?token=...",
  "expires_at": "2026-11-01T12:00:00+00:00",
  "size_bytes": 48210
}

Лимиты и ошибки

На один токен действует лимит 60 запросов в минуту. Сверх лимита API отвечает HTTP 429 с кодом rate_limited. В одном запросе принимается до 50 каналов, больше 50 отклоняется с ошибкой 400 invalid_filters. Ошибки приходят в одном формате: объект error с полями code и message.

Коды ошибок API
HTTP	Код	Когда
401	`invalid_api_token`	Токена нет или он неверный, либо нет префикса Bearer
402	`insufficient_funds`	На балансе не хватает денег на заказ
429	`rate_limited`	Больше 60 запросов в минуту на один токен
400	`invalid_channel_url`	Ссылка на канал не распознана
404	`job_not_found`	Задания с таким номером нет у вашего аккаунта
409	`result_not_ready`	Файл ещё не готов, задание не в статусе done
400	`invalid_filters`	Больше 50 каналов, неподдерживаемый формат или комментарии для платформы, где их нет
409	`cannot_cancel_completed`	Отмена задания, которое уже завершено
502	`dispatch_failed`	Не удалось поставить задание в очередь

Пример ответа при нехватке денег (HTTP 402)

{
  "error": {
    "code": "insufficient_funds",
    "message": "Insufficient balance",
    "balance_rub": 15
  }
}

Цена и баланс

API списывает деньги с того же баланса, что и кабинет, по той же формуле: 20 ₽ за первый канал в запросе, 10 ₽ за каждый следующий. Один канал стоит 20 ₽, пять каналов 60 ₽, пятьдесят каналов 510 ₽. Комментарии добавляют 10 ₽ за канал там, где они собираются, например в Telegram. Если задание упало из-за технической ошибки, деньги возвращаются на баланс сами.

Баланс можно проверить запросом GET /billing/balance, а оценку канала получить через GET /channels/preview до запуска.

Что учесть

Работает только с публичными каналами. Закрытые каналы и личные чаты не выгружаются.
Для регулярных запусков есть расписания в кабинете, подробности на странице мониторинг каналов по расписанию.
Если нужна разовая выгрузка без программирования, используйте форму выгрузки Telegram-канала или выгрузку канала MAX.

Частые вопросы

Как получить токен для API Выгрузки?

Зарегистрируйтесь на сайте и откройте раздел «API» в личном кабинете. Нажмите «Создать токен». Полный ключ показывается один раз, сохраните его сразу.

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

В заголовке Authorization в виде Bearer YOUR_TOKEN. Запрос без префикса Bearer отклоняется с кодом 401.

Какой лимит запросов?

60 запросов в минуту на один токен. Сверх лимита API отвечает кодом 429 и ошибкой rate_limited. В одном запросе можно передать до 50 каналов.

Сколько стоит выгрузка через API?

Так же, как на сайте: 20 ₽ за первый канал в запросе и 10 ₽ за каждый следующий, плюс 10 ₽ за канал, если вы заказали комментарии там, где они собираются. Деньги списываются с того же баланса, что и в кабинете.

Что будет, если на балансе не хватит денег?

Заказ не создаётся, API отвечает кодом 402 и ошибкой insufficient_funds. В ответе указан баланс в рублях. Если задание упало из-за технической ошибки, деньги за него возвращаются на баланс.

Где посмотреть полное описание методов?

В интерактивной документации по адресу https://vygruzka.online/api/v1/docs. В заголовке спецификации пока стоит прежнее название MAX Parser API, это старое имя той же службы.

Начните с токена

Зарегистрируйтесь, пополните баланс от 100 ₽ и создайте токен в разделе «API».

Получить токен