Перейти к содержанию
Max Checker

MAX REST API

MAX REST API: один endpoint, $0.01/проверка, без подписки

Один POST /v1/check-account, ответ <300ms, $0.01 за положительный hit, без подписки и минимальных объёмов. Bearer-аутентификация, JSON-ответ с профилем MAX, sync и batch с webhook-уведомлением.

Запросить доступ через ботКак работает

Доступ

Через индивидуальный запрос в /support

Публичного API пока нет. Если вам нужен прямой доступ для интеграции с CRM, рассыльщиком или антифрод-системой — напишите в /support в боте, выдадим индивидуальный доступ с документацией под ваш кейс.

Эндпоинт /checkAccount

Один POST — и MAX-профиль в ответе

Весь MAX REST API — это один endpoint POST /v1/check-account по адресу https://api.checkmaxapp.com. Принимает E.164-номер, возвращает JSON с полем registered и, если true, профилем пользователя в MAX: firstName, lastName, server_id, last_seen, bio. Списывается $0.01 за положительный hit (registered=true); отрицательные ответы бесплатные.

curl -X POST https://api.checkmaxapp.com/v1/check-account \
  -H "Authorization: Bearer $MAXCHECK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+79161234567"}'

# Ответ при registered=true (списывается $0.01):
# {
#   "phone": "+79161234567",
#   "registered": true,
#   "firstName": "Анна",
#   "lastName": "Иванова",
#   "server_id": 847291,
#   "last_seen": "2026-05-11 09:42:15",
#   "bio": "Маркетолог, Москва",
#   "checked_at": "2026-05-11T12:33:21Z"
# }

# Ответ при registered=false (бесплатно):
# {
#   "phone": "+79161234567",
#   "registered": false,
#   "checked_at": "2026-05-11T12:33:21Z"
# }

Полный референс по полям, кодам ошибок и retry-стратегиям — в гайде по checkAccount endpoint и how-it-works.

Сравнение с альтернативами

Цена за один lookup

MAX REST API — единственный сервис в этом списке, который подтверждает регистрацию именно в мессенджере MAX от VK. Остальные провайдеры валидируют только GSM/HLR или carrier, без данных по мессенджерам. Цены — за один lookup на стандартном тарифе:

СервисЦена за lookupЧто проверяет
checkmaxapp$0.01Регистрация в MAX + профиль (ФИО, last seen, BIO)
Numverify$0.50HLR / carrier / line type (без MAX)
AbstractAPI Phone$0.40E.164 + carrier + line type (без MAX)
Twilio Lookup$0.05Carrier / line type, опционально fraud score

Цены конкурентов — публичные тарифы на май 2026. Пересчёт «$0.01 vs $0.50» отражает разницу в задаче: HLR-валидация vs подтверждение регистрации в мессенджере MAX. Для глобальной E.164-валидации Numverify/AbstractAPI остаются разумным выбором — см. честные сравнения vs Numverify и vs AbstractAPI.

Что включает доступ

Что вы получаете

  • REST API. Bearer-аутентификация, JSON, синхронный /check и асинхронный /batch с webhook-уведомлением.
  • Документация под ваш кейс. Примеры запросов, описание полей и кодов ошибок, рекомендации по retry-стратегиям.
  • Выделенный rate-limit. Согласованный под ваш объём — без шумных соседей по shared-токену.
  • SLA. Uptime, p95 latency, время ответа саппорта — часть индивидуального соглашения.

Запрос

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

Напишите в /support в Telegram-боте с темой «API доступ». В сообщении укажите:

  • Use-case (например, верификация лидов в CRM или антифрод-сигналы).
  • Ожидаемый объём проверок в месяц.
  • Желаемый формат интеграции (синхронный /check, асинхронный /batch с webhook, оба).

Отвечаем в течение 1 рабочего дня. После согласования условий — вышлем документацию и тестовый токен.

Запросить доступ через бот

FAQ

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

  • Какой лимит запросов?
    Базовый rate-limit MAX REST API — 100 запросов/мин на токен для синхронного /v1/check-account и до 10 000 номеров за вызов на batch-эндпойнте. Для интеграций с большим объёмом trafik согласуем выделенный лимит индивидуально при выдаче токена через /support.
  • Есть ли пробник?
    Да. При регистрации в боте даём 5 бесплатных проверок через MAX REST API без карты и без подтверждения email — этого хватает, чтобы убедиться, что формат ответа подходит под ваш кейс. Дальше — $0.01 за проверку с минимальным депозитом $10 USDT и без обязательной подписки.
  • Как получить ключ?
    Напишите в /support в Telegram-боте с темой «API доступ» — опишите use-case (CRM, рассыльщик, антифрод), ожидаемый объём и формат интеграции (sync /checkAccount или batch с webhook). Тестовый Bearer-токен для MAX REST API выдаём в течение 1 рабочего дня вместе с документацией под ваш кейс.
  • Какие SLA вы предоставляете?
    SLA — часть индивидуального соглашения. Стандартный пакет: 99.5% uptime, p95 latency < 1.5s на синхронные запросы, выделенный rate-limit. Все инциденты публикуются на /status.
  • Можно ли использовать API без бота?
    Аккаунт создаётся через бот один раз — для пополнения баланса USDT и саппорта. Далее весь трафик идёт через REST.
  • Поддерживаются ли webhooks?
    Да, для batch-операций. Полный результат приходит на ваш callback URL после завершения. Подпись — HMAC-SHA256 в заголовке X-MaxChecker-Signature.

Связанные материалы