Parsertgchat API v1

Для доступа к API необходимо передавать API-ключ в заголовке запроса:

Authorization-Apikey: ваш_ключ

Ключ можно получить в поддержке (бот или телеграм-чат). Никому не передавайте ключ — это ваш цифровой паспорт.

💰 Как мы списываем средства

Средства списываются в момент создания задачи, независимо от того, завершится она успешно или упадёт с ошибкой. Вы платите за использование наших мощностей, а не за гарантированный результат. Поэтому перед запуском убедитесь, что ссылка корректна, и вы выбрали правильный тип задачи.

📊 Тарифы и лимиты

Тарифы зависят от вашего плана подписки. Информацию о текущем тарифе и лимитах можно получить через эндпоинт /get_user/.

• limit_type: "messages" или "days" — тип лимита на задачи.
• messages_limit — максимальное количество сообщений, которое можно собрать за один расчётный период.
• days_limit — максимальная глубина парсинга по времени (в днях).

🔄 Возвраты

Мы не делаем возвраты за уже созданные задачи, даже если они завершились ошибкой. Исключение — технический сбой на нашей стороне (например, сервер лёг). В таких случаях пишите в поддержку — разберёмся.

Заголовки

Тело запроса

Поле source_link может содержать несколько ссылок (разделители: запятая, пробел, новая строка). Максимальное количество ссылок за один раз — 100.

Опциональный параметр limits (число) ограничивает количество собираемых объектов (по умолчанию 50000). Если вы хотите собрать меньше, укажите лимит — это сэкономит время и ресурсы.

Пример для поиска чатов по ключевым словам

{
  "task_type": "search_chats",
  "params": {
    "keywords": ["маркетинг", "продажи"]
  }
}

Пример для парсинга всех чатов из источника

{
  "task_type": "parse_all_chats",
  "source_link": "https://t.me/chspisokWB"
}

Ответ при успехе

{
  "status": "success",
  "task_ids": [123, 124],
  "created_count": 2,
  "total_links": 2,
  "debug": {
    "tariff": 2,
    "limits": {"total_tasks": 5},
    "current_total_tasks": 3,
    "errors": []
  }
}

Поле debug содержит служебную информацию — может пригодиться для отладки.

Заголовки

Пример ответа

{"status":"success","balance":150.50}

Баланс отображается в условных единицах (рублях). Отрицательный баланс не допускается — задачи не будут создаваться.

Заголовки

Пример ответа

{
  "status":"success",
  "user": {
    "balance":150.5,
    "sale":0,
    "dostup":1704067200,
    "email":"user@example.com",
    "email_verified":true,
    "limit_type":"messages",
    "messages_limit":25000,
    "days_limit":3,
    "referal_count":5
  },
  "offer_subscription":true,
  "subscription_message": "Подпишитесь на наш канал и получите 1 час бесплатного доступа!"
}

dostup — timestamp окончания подписки. Если подписка истекла, некоторые функции могут быть недоступны.

Параметры

Допустимые статусы для перезапуска

• join_failed
• waiting_stop
• message_history_error
• members_error
• failed

Перезапустить можно только задачи, которые не завершились успешно и не были остановлены пользователем. При перезапуске создаётся новая задача с теми же параметрами, но списание средств происходит повторно (да, это платная операция).

Пример ответа

{"status":"success","message":"Task restarted","task_id":123,"previous_status":"join_failed","new_status":"pending"}

Параметры

Допустимые статусы для остановки

• pending
• processing

Остановка полезна, если вы поняли, что задача собирает не то, или процесс затянулся. Средства за задачу не возвращаются.

Пример ответа

{"status":"success","message":"Task stopped","task_id":123,"previous_status":"processing","new_status":"stop"}

Тело запроса

{
  "tariff_id": 1,       // 1-день, 2-месяц, 3-полгода, 4-год
  "provider": "cryptopay", // cryptopay, yookassa, sbp, mir
  "orders_id": "опционально" // ваш внутренний ID заказа
}

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

Пример ответа

{"status":"success","payment_id":12345,"payment_url":"https://..."}

Используется для загрузки файлов со списками ссылок (например, для массового создания задач). Формат: multipart/form-data с полем file. Только текстовые файлы (.txt), каждая ссылка с новой строки.

Максимальный размер файла — 10 МБ.

Пример ответа

{"status":"success","file_id":6789,"file_name":"original.txt"}

Полученный file_id можно использовать в других эндпоинтах (например, в /create_task/ как источник ссылок).

Параметры (опционально)

Пример ответа

{
  "status":"success",
  "user_id": 123456789,
  "total_tasks":150,
  "tasks": [
    {
      "id":1,
      "source_link":"...",
      "task_type":"parse_all_chats",
      "status":"completed",
      "created_at":"2025-01-01T12:00:00Z",
      "completed_at":"2025-01-01T12:05:00Z",
      "download_links": {
        "xlsx":"https://api.parsertgchat.ru/download/123.xlsx",
        "txt":"https://api.parsertgchat.ru/download/123.txt"
      },
      "json_result": null
    }
  ],
  "pagination": { "total":150, "limit":50, "offset":0, "has_more":true }
}

Ссылки на скачивание результатов доступны в течение 7 дней после завершения задачи.

Тело запроса

{
  "limit_type": "messages",   // "messages" или "days"
  "messages_limit": 25000,
  "days_limit": 3
}

Изменяет лимиты для будущих задач. На уже запущенные задачи не влияет.

Пример ответа

{"status":"success","message":"Настройки сохранены"}