Пакетная проверка: как проверить целый файл адресов

Когда адресов не десять, а десятки тысяч, отправлять их через API по одному неудобно. Для этого в личном кабинете есть раздел «Проверка файла». Вы загружаете список, сервис сам проходит по нему и собирает результаты в таблицу, которую потом можно скачать.

Какой файл подойдёт

Принимаются файлы CSV и TXT размером до 50 МБ, по одному за раз. Сервис читает файл построчно и в каждой строке ищет значение похожее на email вида address@email.ru. Значения могут разделяться запятой, точкой с запятой или табуляцией, так что обычная выгрузка из CRM или Excel, скорее всего, подойдёт без доработки.

• Строки без адреса пропускаются мимо, поэтому строка с заголовками не помешает.
• Кавычки вокруг значения и пробелы внутри адреса автоматически стираются, а сам адрес приводится к нижнему регистру.
• Если в строке несколько адресов, берётся только первый. Если у вас несколько столбцов с email - установите нужный столбец первым.
• Дубликаты не проверяются и не удаляются. Каждая строка проверяется и оплачивается отдельно, так что дубликаты лучше убрать заранее.

Имя,Город,Адрес
Иван Петров,Москва,ivan.petrov@mail.ru
"Анна Смирнова","Казань","Anna.Smirnova@Yandex.ru"
sales@example.com

Из такого файла получится три адреса. Первая строка будет пропущена, а Anna.Smirnova@Yandex.ru превратится в anna.smirnova@yandex.ru.

Загрузка и запуск

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

• Откройте раздел «Проверка файла» и нажмите «Загрузить». Перетащите файл в окно или выберите его на диске.
• Пока файл читается, у него статус «Загрузка». Большой файл может разбираться какое-то время, страницу при этом можно закрыть.
• Когда статус сменится на «Загружен», посмотрите, сколько адресов нашёл сервис. Если число сильно отличается от ожидаемого, скорее всего, с форматом файла что-то не так.
• Если всё верно, нажмите «Запустить проверку».

Если в файле не нашлось ни одного адреса, загрузка получит статус «Ошибка» с пояснением. Такой файл нужно поправить и загрузить заново.

Во время проверки

Пока идёт проверка, у загрузки статус «В обработке». На её странице видно, сколько адресов уже проверено, сколько из них Good, Bad и Unknown и примерно сколько времени осталось. Результаты появляются в таблице сразу, ждать окончания не нужно.

Проверку можно остановить кнопкой «Приостановить» и потом продолжить с того же места. Адреса, которые проверялись в момент паузы, успеют завершиться.

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

Сколько это стоит

Оплата такая же, как при запросах через API. Списываются только однозначные ответы Good и Bad, а Unknown и строки с ошибкой для вас бесплатны. Если у вас подписка, сначала расходуется дневной лимит, а всё, что сверх него, списывается с баланса.

Чтобы запустить проверку, баланс должен быть больше нуля. Если деньги закончатся на середине, проверка сама встанет на паузу со статусом «Приостановлен». Пополните баланс и нажмите «Продолжить», сервис продолжит с того места, где остановился. Уже проверенные адреса повторно не списываются.

Результат

Когда все строки пройдены, статус меняется на «Выполнено». Результаты можно смотреть прямо в кабинете с фильтрами или скачать в CSV. Скачать можно и приостановленную проверку, тогда в файле будет всё, что успели проверить.

email;status;detail;humaneness;suspicious;gmailDotTrick;aliasEmail;createdAt
ivan.petrov@mail.ru;Good;Mailbox accepts mail;0.9734;false;false;;2026-10-20T09:15:02.118Z

Файл называется так же, как исходный, с припиской -result. Колонки разделены точкой с запятой, а кодировка помечена так, что Excel открывает файл без проблем, в том числе с кириллицей. В первой колонке сам адрес, дальше идут столбцы:

• status и detail - результат проверки и пояснение к нему, как в ответе API.
• humaneness - оценка от 0 до 1, насколько адрес похож на придуманный человеком. Подробнее в статье Humaneness.
• suspicious - адрес не похож на тот, что написал бы человек. См. Подозрительные адреса.
• gmailDotTrick - адрес оказался вариантом уже встречавшегося. См. Gmail dot trick.
• aliasEmail - нормализованная форма адреса, если она отличается от исходной. См. Нормализация.
• createdAt - время, когда строка попала в загрузку.

Удаление

Загрузку можно удалить вместе с исходным файлом и результатами, если она сейчас не в процессе обработки. Если проверка запущена, сначала поставьте её на паузу.

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