Запрос cURL
POST /api/v1/bulk-taskscurl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=email_batch \
-F file=@emails.txtМассовый продукт email_batch
Массовая проверка доставляемости email
Загрузите целый файл адресов, узнайте, какие из них могут принимать почту, и скачайте результат по завершении.
Дополнение для больших списков целиком — для нескольких адресов проверка в реальном времени отвечает в том же запросе. Проверка в реальном времени →
Контракт API
Два шага: отправьте файл, затем проверьте задачу
При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.
1. Отправьте файл
id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки и дубликаты удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.
Ответ: задача создана
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "email_batch",
"status": "processing",
"submitted_lines": 1015,
"total": 1015,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Проверьте задачу
Опрашивайте по id задачи. После завершения подготовки submitted_lines = total + invalid_cnt + duplicate_cnt, где total — то, что проверяется и оплачивается; для задач с email no_code_cnt и other_country_cnt всегда равны 0. Успешный ответ содержит количество успешных и неудачных проверок и ссылку для скачивания файла результата; задача, отклонённая при подготовке, получает статус failed с reason_detail, и средства возвращаются полностью.
Запрос cURL
GET /api/v1/bulk-tasks/{id}curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Ответ: задача завершена
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "email_batch",
"status": "success",
"submitted_lines": 1015,
"total": 1000,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 12,
"preparing": false,
"success_cnt": 990,
"failure_cnt": 10,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Как это работает
Что происходит с массовой задачей
Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.
01Загрузите файл
Файл .txt или .csv с одним адресом email на строку. Он передаётся потоком напрямую, ничего не записывается на диск.
02Предпроверка и резервирование
Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, проверяется охват провайдеров. Файл, не прошедший этот этап, завершается как неудачная задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.
03Выполнение в фоне
Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.
04Скачайте результат
Заберите файл на странице массовой проверки. Вы платите только за адреса, по которым действительно получен результат; разница возвращается.
Поля результата
Столбцы файла результата
Для скачивания предоставляется один файл CSV с этой полной таблицей.
Столбцы файла результата
identifier·alex.kim@example.com— Отправленный адрес email в нижнем регистре.activated·true— Может ли адрес принимать почту: true (доступен) или false (недоступен).
Лучше всего подходит для
Когда выбирать этот продукт
- Очистка списков
- Гигиена базы данных
- Периодические перепроверки
Краткий ответ
Что такое «Проверка доставляемости» в массовом режиме?
Массовая проверка доставляемости предназначена для списков от тысячи адресов: загрузите файл, задача выполнится в фоне, а по завершении вы скачаете CSV с результатом. В одном файле допускаются любые домены — выбирать провайдера не нужно.
Чёткие границы
Ограничения этого продукта
- Это не проверка личности. Результат показывает, может ли адрес принимать почту, но не подтверждает, кому он принадлежит.
- История сообщений, содержимое переписки и любое закрытое содержимое аккаунта никогда не возвращаются.
- Проверка аватара охватывает домены Gmail, Yandex и Mail.ru. Все три можно свободно смешивать в одном файле; адреса вне этого списка приводят к ошибке задачи с указанием их количества и полным возвратом средств. Проверка доставляемости принимает любой домен.
- Результаты отражают момент выполнения задачи. Для актуального состояния запустите её снова — сохранённые результаты автоматически не обновляются.
- Ссылки для скачивания имеют ограниченный срок действия. Скачайте файл вскоре после завершения задачи; если ссылка истекла, проверьте задачу снова, чтобы получить новую.
Когда подходит массовая проверка
Когда массовая проверка оправдана, а когда быстрее проверка в реальном времени
| Проверка в реальном времени | Массовая проверка | |
|---|---|---|
| Сколько адресов | 1 адрес за одиночную проверку; несколько — за множественный запрос; точные лимиты указаны в документации API | Большой список целиком в одной задаче — текущий диапазон размеров указан на странице цен |
| Получение результатов | Сразу: одиночный и множественный эндпоинты отвечают в том же ответе; панель возвращает результаты по одному | Скачайте файл с результатом после завершения задачи |
| Охват провайдеров | Без ограничений — можно смешивать в одном запросе | Проверка полного адреса принимает любые домены в одном файле; проверка аватара принимает Gmail, Yandex и Mail.ru вперемешку в одном файле и ничего сверх этих трёх |
| Формат результата | JSON, поля для каждого адреса | Файл результата (один CSV с полной таблицей) |
| Типичное применение | Проверка форм, запросы операторов, контроль перед отправкой | Очистка списков, фильтрация перед кампанией, очистка сохранённых данных |
FAQ по продукту
О продукте «Проверка доставляемости»
Когда использовать массовую проверку вместо проверки в реальном времени?
Используйте массовую проверку для большого списка целиком. Для нескольких адресов проверка в реальном времени отвечает в том же запросе, без планирования задачи.
Что происходит с недействительными адресами в файле?
Предпроверка отбрасывает строки с ошибками, поэтому они не попадают в оплачиваемое количество. Из оставшихся адресов те, которые вышестоящий сервис не может определить, тоже не оплачиваются. Вы платите только за адреса, по которым действительно получен результат.
Сколько времени занимает задача?
Зависит от количества адресов и продукта. После отправки страницу можно закрыть: задача выполняется в фоне, а результат будет ждать вас на странице массовой проверки.
Вернутся ли средства, если задача не удалась?
Да. За неудачную задачу средства возвращаются полностью. Если задача выполнена успешно, но по части адресов результат не получен, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.
Похожие продукты
Другие массовые продукты
Создайте аккаунт, чтобы отправить массовую задачу
Массовые проверки и проверки в реальном времени расходуют один баланс — ничего дополнительно включать не нужно. Зарегистрируйтесь и загрузите первый файл на странице массовой проверки.