Документация MailVerifier.ru

REST API для проверки email-адресов. Все запросы — HTTPS, JSON.

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

Шаг 1: Регистрация

Зарегистрируйтесь — email, без телефона и карты. В личном кабинете создайте API-ключ.

Шаг 2: Запрос

POST https://mailverifier.ru/api/v1/validate
Content-Type: application/json
Authorization: Bearer ВАШ_API_КЛЮЧ

{"email": "user@company.com"}

Шаг 3: Ответ

Получите JSON с полями valid, рейтинг (score), checks и reason.

POST /api/v1/validate

Проверяет один email через 6 уровней валидации.

Параметр	Описание
email	Строка, до 254 символов
Authorization	Bearer + UUID API-ключа (опционально для демо с лимитом 5/день по IP)

Формат ответа

Важно: сервис проверяет качество адреса (синтаксис, DNS, disposable, эвристики), а не гарантирует 100% существование конкретного ящика. Поле valid означает «адрес выглядит пригодным для рассылок», а не «почтовый ящик точно существует».

{
  "valid": true,
  "score": 92,
  "verification_level": "dns_heuristics",
  "mailbox_exists": null,
  "smtp_checked": false,
  "disclaimer_ru": "Проверяется качество адреса...",
  "disclaimer_short_ru": "Не гарантирует 100% существование ящика",
  "email": "user@company.com",
  "domain": "company.com",
  "local_part": "user",
  "checks": {
    "syntax": true,
    "mx_record": true,
    "disposable": false,
    "role_based": false,
    "free_email": false,
    "business_email": true,
    "spf_record": true,
    "dkim_record": true,
    "dmarc_record": true,
    "typo_detected": false
  },
  "reason": "valid"
}

Поле checks	Описание
syntax	Корректный формат RFC 5322
mx_record / a_record	Домен принимает почту
disposable	Временная почта (mailinator и др.)
role_based	Роликовый адрес (info@, admin@)
free_email / business_email	Личная или корпоративная почта
spf_record / dkim_record / dmarc_record	DNS-аутентификация домена

Рейтинг качества (score)

Рейтинг качества — число от 0 до 100. Это сводная оценка надёжности адреса для рассылок и регистрации.

80–100 — хороший адрес, высокая вероятность доставки
50–79 — сомнительный (роликовый, free-почта, нет SPF и т.д.)
0–49 — ненадёжный (нет MX, disposable, опечатка в домене)

Штрафы: нет MX (−60), disposable (−40), роликовый (−10), free-почта (−5), нет SPF/DKIM/DMARC, опечатка в домене.

Поле valid: true — адрес прошёл базовые проверки (синтаксис, MX, не disposable, рейтинг ≥ 50).

Примеры кода

PHP

$ch = curl_init('https://mailverifier.ru/api/v1/validate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['email' => $_POST['email']]),
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $apiKey,
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
if ($result['valid'] && $result['score'] >= 70) {
    // принять email
}

Python

import requests

r = requests.post(
    'https://mailverifier.ru/api/v1/validate',
    headers={'Authorization': f'Bearer {API_KEY}'},
    json={'email': email},
)
data = r.json()
if data['valid'] and data['score'] >= 70:
    print('OK')

JavaScript

const res = await fetch('https://mailverifier.ru/api/v1/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + API_KEY,
  },
  body: JSON.stringify({ email }),
});
const data = await res.json();

Коды ошибок

HTTP	Описание
401	Неверный или неактивный API-ключ
429	Исчерпан дневной/месячный лимит
422	Некорректное тело запроса

Технический FAQ

Гарантирует ли API существование ящика?

Нет. Проверяется качество адреса, а не факт существования mailbox на стороне Gmail, Mail.ru и т.д. Для 100% подтверждения — отправьте письмо с кодом (double opt-in).

Нужен ли SMTP?

Нет. Мы не используем SMTP RCPT TO — только DNS, синтаксис и эвристики. Это быстрее и надёжнее для массовых проверок.

Как получить API-ключ?

Регистрация → Личный кабинет → API-ключи → Создать ключ.

Лимиты бесплатного тарифа?

5 проверок в день с одного IP без ключа. С ключом — по тарифу.