---
title: "Массовая проверка email через API | Emvero"
description: "Проверяйте списки email-адресов через API. Сохраняйте статусы, рекомендации и коды причин в своем файле или базе. Проверка не отправляет письма."
url: https://emvero.io/ru/bulk-email-verification/
language: ru
updated: 2026-10-07
---

Массовая проверка email

# Массовая проверка email-адресов через API

Проверьте адреса из CSV-файла, выгрузки CRM или базы данных. Ваш скрипт отправляет в Emvero по одному адресу, получает результат проверки и сохраняет его рядом с исходными данными.

Для работы нужен аккаунт и API-ключ. Список обрабатывается в вашей системе: загрузки CSV и отдельного интерфейса массовой проверки в Emvero нет. Проверочные письма не отправляются.

Начать бесплатно

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

Один запрос на адрес · Результаты в вашей системе · Без отправки писем

Распределение исходов адресов: 125 420

| Результат | Строк | Доля |
| --- | --- | --- |
| Доставляемый | 104 852 | 83,6 % |
| Рискованный | 9 112 | 7,3 % |
| Недоставляемый | 9 804 | 7,8 % |
| Неизвестно | 1 652 | 1,3 % |

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

## Как проверить существующий список

Массовая и одиночная проверка используют один API. Для списка вы повторяете запрос по каждому адресу в своем скрипте, приложении или задаче по расписанию. Emvero возвращает результат для каждого адреса, а ваш процесс связывает его с нужной строкой.

### Список остается у вас

Скрипт читает адреса из CSV, выгрузки CRM или базы данных. В Emvero передаются отдельные адреса; исходный файл остается в вашей системе.

### Выберите глубину проверки

Полная проверка может получить сведения о конкретном получателе от почтового сервера. Проверка домена оценивает общие настройки и известные признаки риска без SMTP-сессии. Существование отдельного ящика она не устанавливает.

### Сохраните результат и его основания

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

## Порядок запросов к API

Создайте ключ в аккаунте и вызывайте API со своего сервера. Ключ не должен попадать в браузерный код.

1. Прочитайте адрес и сохраните идентификатор строки из своего файла или базы.
2. Отправьте адрес на `POST /v1/verifications` с ключом авторизации.
3. Если ответ содержит `pending`, сохраните идентификатор проверки. Подождите время из `retry_after_ms`, затем запросите результат по этому идентификатору с тем же ключом.
4. Когда проверка завершится, запишите итоговые поля в исходную строку. Обработайте остальные адреса так же.

Состояние `pending` означает, что проверка еще идет. Оно отличается и от итогового `unknown`, и от ошибки запроса. В своем процессе задайте число одновременных запросов, правила повторов и предел ожидания. На странице [API проверки email](https://emvero.io/ru/email-verification-api/) описаны запрос, получение отложенного результата и поля ответа, включая `action`, `checks` и `reason_codes`.

## Как обработать результаты

После завершения проверки поле `status` содержит один из четырех статусов:

- `deliverable`: полученные свидетельства указывают, что адрес может принимать письма.
- `risky`: выявлены признаки риска, которые требуют отдельного решения об адресе.
- `undeliverable`: установлена постоянная техническая причина, по которой адрес не может принимать почту.
- `unknown`: имеющихся свидетельств недостаточно для вывода. Например, сервер не ответил вовремя или не предоставил сведения о получателе.

Рекомендация хранится отдельно, в поле `action`. Ниже показано, как один и тот же статус `risky` может сопровождаться разными действиями и кодами причин.

Результаты Статус: рискованные

| Адрес | Статус | Действие | Коды причин |
| --- | --- | --- | --- |
| k.novak@catchall.example | Рискованный | `allow_with_email_confirmation` | `SMTP_RCPT_ACCEPTED` `ACCEPT_ALL_DOMAIN` |
| a.dvorak@corp.example | Рискованный | `allow_with_email_confirmation` | `SMTP_MAILBOX_DISABLED` |
| p.ruiz@corp.example | Рискованный | `allow_with_email_confirmation` | `SMTP_MAILBOX_STATUS_ERROR` |
| test@mailinator.example | Рискованный | `allow` | `SMTP_RCPT_ACCEPTED` `DISPOSABLE_DOMAIN` |

Вымышленные адреса для примера. Домены `.example` зарезервированы для документации и не принадлежат реальным получателям.

Действие `allow` означает, что проверка не нашла технической причины отклонить адрес. `allow_with_email_confirmation` рекомендует продолжить процесс с подтверждением по email, а `reject` — отклонить адрес на основании полученных свидетельств. Подтверждение требует отдельного письма: сама проверка его не отправляет.

Catch-all домен принимает любого получателя, поэтому согласие сервера не подтверждает существование отдельного ящика. Одноразовый адрес может принимать письма, пока ящик действует. Ролевой адрес, например адрес службы поддержки, тоже может быть рабочим. Эти признаки имеют разный смысл; учитывайте `reason_codes`, когда задаете правила для своего списка.

Адреса с `unknown` сохраняйте отдельно от `undeliverable`. Таймаут или ограничения сервера не доказывают, что ящик не существует. Повторная проверка позже может дать больше сведений, но однозначный ответ не гарантирован.

## Глубина проверки и расход кредитов

За полную проверку списывается до 10 кредитов, за проверку домена — до 2. Это верхние пределы: окончательное списание зависит от полученного результата. Обе глубины доступны каждому аккаунту и используют общий баланс.

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

## Что проверка может установить перед отправкой

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

Даже положительный результат не гарантирует будущую доставку или отсутствие возвратов. На доставку влияют также репутация отправителя, настройки аутентификации, содержание письма, действия получателя и правила принимающего сервера. В [сравнении проверки и гигиены списка](https://emvero.io/ru/compare/verification-vs-list-hygiene/) объясняется, какие задачи решает каждый подход.

## Когда проверять список, а когда адрес в форме

| Массовая | В реальном времени |
| --- | --- |
| Проверяет сохраненные адреса | Проверяет адрес при вводе |
| Работает в фоновом процессе | Работает при регистрации, заказе или отправке формы |
| Сохраняет ответы рядом с адресами | Помогает решить, как обработать введенный адрес |
| Получает итог после `pending` | Требует правила ожидания для формы при `pending` |

[Проверка в реальном времени](https://emvero.io/ru/real-time-email-verification/) помогает обработать адрес, пока человек заполняет форму и может исправить ошибку. Массовая проверка нужна для уже сохраненных контактов. Оба сценария используют один серверный API и общий баланс кредитов.

## Как обрабатываются данные проверки

### Результаты и ответы почтовых серверов

Проверка не отправляет письма на адреса из списка. Emvero сохраняет результаты и может использовать их повторно, пока они актуальны, без нового запроса к почтовому серверу. Вместо текста ответа сервера API возвращает данные проверки и стабильные коды причин.

### Хранение и обработка данных

При хранении данные шифруются с помощью AES-256. Срок хранения результатов — 30 дней; удаление по запросу выполняется в течение 72 часов. Данные обрабатываются в пределах ЕЭЗ.

Допустимое использование

## Проверяйте адреса, которые у вас уже есть

Emvero проверяет переданные адреса. Сервис не собирает контакты и не устанавливает, дал ли получатель согласие на письма.

### Адреса для проверки предоставляете вы

Emvero не ищет, не угадывает, не продает и не подсказывает email-адреса, не дополняет ими контактные данные. Передавайте на проверку адреса, которые вы уже получили.

### Согласие на письма

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

### Что запрещено

Запрещены перебор ящиков на домене, проверка купленных списков и адресов, собранных парсерами или массовым извлечением из чужих источников, а также использование сервиса для нежелательных рассылок. Признаки перебора считаются злоупотреблением при любом объеме и приводят к приостановке доступа. Подробнее об этих ограничениях читайте в [условиях использования](https://emvero.io/ru/terms/).

### Проверка не отправляет письмо

Полная проверка может обратиться к почтовому серверу получателя. SMTP-сессия заканчивается до передачи данных сообщения, поэтому письмо на проверяемый адрес не отправляется.

Вопросы

## Часто спрашивают.

**Что такое массовая проверка email?**

Это проверка адресов из уже собранного списка. В Emvero ваш скрипт или приложение отправляет отдельный запрос для каждого адреса и сохраняет результат в исходном файле или базе. Файлы в сервис не загружаются, отдельного эндпоинта для передачи списка целиком нет.

**Можно ли проверить CSV-файл?**

Да, с помощью своего скрипта или приложения. Прочитайте колонку с email-адресами, отправьте каждый адрес в API и запишите результат в соответствующую строку. При ответе `pending` дождитесь указанного интервала и запросите результат повторно по идентификатору проверки. Сам CSV-файл в Emvero не загружается.

**Получат ли адресаты письма во время проверки?**

Нет. Полная проверка может обратиться к почтовому серверу получателя, но SMTP-сессия заканчивается до стадии `DATA`. Тема и текст письма не передаются, письмо в ящик не поступает.

**Что делать с адресами со статусом unknown?**

Сохраните их отдельно от недоставляемых адресов. `unknown` означает, что данных не хватило для вывода, например из-за таймаута или ограничений почтового сервера. Можно повторить проверку позже. Если человек сейчас регистрируется и важно подтвердить владение ящиком, используйте отдельное письмо подтверждения.

**Гарантирует ли проверка, что все письма будут доставлены?**

Нет. После проверки ящик может закрыться или переполниться, а почтовый сервер может отклонить письмо из-за репутации отправителя или содержания сообщения. Проверка выявляет технические проблемы, которые уже можно установить, но не гарантирует будущую доставку или попадание во входящие.

## Прямое сравнение

### Реальное время против массовой проверки

В реальном времени адрес проверяется, пока человек заполняет форму и может исправить ошибку. Массовая проверка обрабатывает уже сохраненный список через тот же API.

### Проверка против гигиены базы

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

### Catch-all-домен

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

Первый список для проверки

## Создайте API-ключ и начните проверку

Создайте аккаунт и подтвердите email-адрес, чтобы получить 1 000 кредитов без банковской карты. Их хватит на 100 полных проверок или до 500 проверок домена. Затем создайте ключ в аккаунте и подключите свой скрипт к API.

Начать бесплатно

Связаться с отделом продаж