EmailCheckPro

Массовый продукт email_avatar_batch

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

Загрузите целый файл адресов Gmail, Yandex или Mail.ru: узнайте, какие из них доставляемы, и получите аватар каждого.

Дополнение для больших списков целиком — для нескольких адресов проверка в реальном времени отвечает в том же запросе. Проверка в реальном времени →

Посмотреть контракт APIРегистрация

Контракт API

Два шага: отправьте файл, затем проверьте задачу

Полная документация API Открыть ключи API

При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.

1. Отправьте файл

id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки и дубликаты удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.

Запрос cURLPOST /api/v1/bulk-tasks
curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt
Ответ: задача создана200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_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, и средства возвращаются полностью.

Запрос cURLGET /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_avatar_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"
  }
}

Как это работает

Что происходит с массовой задачей

Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.

  1. 01Загрузите файл

    Файл .txt или .csv с одним адресом email на строку. Он передаётся потоком напрямую, ничего не записывается на диск.

  2. 02Предпроверка и резервирование

    Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, проверяется охват провайдеров. Файл, не прошедший этот этап, завершается как неудачная задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.

  3. 03Выполнение в фоне

    Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.

  4. 04Скачайте результат

    Заберите файл на странице массовой проверки. Вы платите только за адреса, по которым действительно получен результат; разница возвращается.

Поля результата

Столбцы файла результата

Для скачивания предоставляется один файл CSV с этой полной таблицей.

Столбцы файла результата

  • identifier · alex.kim@gmail.com — Отправленный адрес в нижнем регистре.
  • activated · true — Доставляем ли адрес у этого провайдера — может ли он принимать почту: true или false. Если значение не true, все остальные столбцы в этой строке остаются пустыми.
  • avatar · true — Установлен ли аватар: true или false. avatar_url может быть пустым, если изображение недоступно.
  • avatar_url · https://lh3.googleusercontent.com/a/example — URL аватара; пусто, если URL недоступен.

Лучше всего подходит для

Когда выбирать этот продукт

Обогащение контактов

activatedavatar_url

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

Например: обогатите контакты Gmail, уже хранящиеся в CRM отдела продаж.

Гигиена базы данных

identifieractivatedavatar

Помечайте недоставляемые адреса и записи без аватара, чтобы позже очистить, объединить или проверить их.

Например: удалите неработающие адреса, а затем проверьте действительные контакты с неполными профилями.

Периодические перепроверки

activatedavataravatar_url

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

Например: ежеквартально обновляйте данные аватаров для ценных контактов.

Краткий ответ

Что такое «Проверка аватара» в массовом режиме?

Массовая проверка аватара — это файловая версия проверки аватара в реальном времени (email_avatar), охватывающая домены Gmail, Yandex и Mail.ru. Их можно свободно смешивать в одном файле: маршрут для каждого адреса выбирается автоматически. Для каждого адреса возвращается, доставляем ли он, установлен ли аватар и URL аватара. Файл с адресами вне этого списка завершается ошибкой на этапе подготовки, и средства возвращаются полностью.

Чёткие границы

Ограничения этого продукта

  • Это не проверка личности. Результат показывает, может ли адрес принимать почту, но не подтверждает, кому он принадлежит.
  • История сообщений, содержимое переписки и любое закрытое содержимое аккаунта никогда не возвращаются.
  • Проверка аватара охватывает домены Gmail, Yandex и Mail.ru. Все три можно свободно смешивать в одном файле; адреса вне этого списка приводят к ошибке задачи с указанием их количества и полным возвратом средств. Проверка доставляемости принимает любой домен.
  • Результаты отражают момент выполнения задачи. Для актуального состояния запустите её снова — сохранённые результаты автоматически не обновляются.
  • Ссылки для скачивания имеют ограниченный срок действия. Скачайте файл вскоре после завершения задачи; если ссылка истекла, проверьте задачу снова, чтобы получить новую.

Когда подходит массовая проверка

Когда массовая проверка оправдана, а когда быстрее проверка в реальном времени

Проверка в реальном времениМассовая проверка
Сколько адресов1 адрес за одиночную проверку; несколько — за множественный запрос; точные лимиты указаны в документации APIБольшой список целиком в одной задаче — текущий диапазон размеров указан на странице цен
Получение результатовСразу: одиночный и множественный эндпоинты отвечают в том же ответе; панель возвращает результаты по одномуСкачайте файл с результатом после завершения задачи
Охват провайдеровБез ограничений — можно смешивать в одном запросеПроверка полного адреса принимает любые домены в одном файле; проверка аватара принимает Gmail, Yandex и Mail.ru вперемешку в одном файле и ничего сверх этих трёх
Формат результатаJSON, поля для каждого адресаФайл результата (один CSV с полной таблицей)
Типичное применениеПроверка форм, запросы операторов, контроль перед отправкойОчистка списков, фильтрация перед кампанией, очистка сохранённых данных

Проверка в реальном времени · Посмотреть цены

FAQ по продукту

О продукте «Проверка аватара»

Когда использовать массовую проверку вместо проверки в реальном времени?

Используйте массовую проверку для большого списка целиком. Для нескольких адресов проверка в реальном времени отвечает в том же запросе, без планирования задачи.

Что происходит с недействительными адресами в файле?

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

Сколько времени занимает задача?

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

Вернутся ли средства, если задача не удалась?

Да. За неудачную задачу средства возвращаются полностью. Если задача выполнена успешно, но по части адресов результат не получен, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.

Похожие продукты

Другие массовые продукты

Массовая проверка доставляемости emailЗагрузите целый файл адресов, узнайте, какие из них могут принимать почту, и скачайте результат по завершении.

Создайте аккаунт, чтобы отправить массовую задачу

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

Регистрация Посмотреть цены