Solicitud 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_avatar_batch \
-F file=@emails.txtProducto masivo email_avatar_batch
Verificación masiva de avatar de correo
Suba un archivo completo de direcciones de Gmail, Yandex o Mail.ru: sepa cuáles son entregables y obtenga el avatar de cada una.
Un complemento para listas grandes completas: para unos pocos correos, la verificación en tiempo real responde en la misma solicitud. Verificación en tiempo real →
Contrato de la API
Dos pasos: enviar el archivo y consultar la tarea
Al enviar se devuelve de inmediato un ID de tarea; consulte la tarea con ese ID y, cuando se complete correctamente, la respuesta incluirá el enlace de descarga del archivo de resultados. Cada solicitud se muestra con su propia respuesta.
1. Enviar el archivo
El ID de tarea se devuelve de inmediato con preparing en true mientras el archivo se prepara en segundo plano: se eliminan las líneas no válidas y los duplicados, que no se cobran. El saldo se reserva para las líneas enviadas y se liquida al completarse; la diferencia se reembolsa.
Respuesta: tarea creada
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. Consultar la tarea
Sondee por ID de tarea. Cuando finaliza la preparación, submitted_lines = total + invalid_cnt + duplicate_cnt, donde total es lo que se verifica y se cobra; no_code_cnt y other_country_cnt siempre valen 0 en las tareas de correo. Una respuesta correcta incluye los recuentos de éxitos y fallos y el enlace de descarga del archivo de resultados; una tarea rechazada durante la preparación queda en failed con reason_detail y se reembolsa íntegramente.
Solicitud cURL
GET /api/v1/bulk-tasks/{id}curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Respuesta: tarea finalizada
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"
}
}Cómo se ejecuta
Qué ocurre con una tarea masiva
El modo masivo no es una versión ampliada del tiempo real: se envía una vez, se ejecuta en segundo plano y se recoge más tarde. No necesita mantener la página abierta; el estado de la tarea y los resultados permanecen en su panel.
01Suba el archivo
Un .txt o .csv con un correo por línea. Se procesa en streaming directamente; no se escribe nada en disco.
02Comprobación previa y reserva
Los problemas evidentes (un archivo vacío, un formato incorrecto, muy pocas líneas) se rechazan al subirlo. A continuación se reserva el saldo y el archivo se prepara en segundo plano: se eliminan las líneas duplicadas y no válidas y se comprueba el alcance de proveedores. Un archivo que no supera esa fase termina como tarea fallida y se reembolsa íntegramente; en caso contrario, solo se verifican las líneas restantes y la tarea se liquida al completarse.
03Ejecución en segundo plano
La tarea se ejecuta por sí sola: puede cerrar la página si lo desea. Un fallo se notifica de inmediato y se reembolsa íntegramente.
04Descargue el resultado
Recoja el archivo en la página de verificación masiva. Solo paga por los correos que realmente devolvieron un resultado; la diferencia se reembolsa.
Campos del resultado
Columnas del archivo de resultados
La descarga es un único archivo CSV que contiene esta tabla completa.
Columnas del archivo de resultados
identifier·alex.kim@gmail.com— La dirección enviada, en minúsculas.activated·true— Si la dirección es entregable en ese proveedor, es decir, si puede recibir correo: true o false. Cuando no es true, todas las demás columnas de esa fila quedan vacías.avatar·true— Si hay un avatar configurado: true o false. avatar_url puede estar vacía cuando la imagen no está disponible.avatar_url·https://lh3.googleusercontent.com/a/example— La URL del avatar; vacía cuando no hay ninguna URL disponible.
Ideal para
Cuándo recurrir a este producto
Enriquecimiento de contactos
activatedavatar_urlTras confirmar que una dirección puede recibir correo, añada su enlace de avatar público al registro del contacto para reconocerlo con más facilidad.
Por ejemplo: enriquecer los contactos de Gmail ya almacenados en un CRM de ventas.
Higiene de la base de datos
identifieractivatedavatarMarque las direcciones no entregables y las entradas sin avatar para limpiarlas, fusionarlas o revisarlas más adelante.
Por ejemplo: eliminar las direcciones fallidas y después revisar los contactos válidos con perfiles incompletos.
Reverificaciones periódicas
activatedavataravatar_urlVuelva a ejecutar periódicamente una lista almacenada para ver si la entregabilidad o el avatar público han cambiado.
Por ejemplo: actualizar cada trimestre los datos de avatar de los contactos de alto valor.
Respuesta directa
¿Qué es la Verificación de avatar masiva?
La verificación masiva de avatar es la versión por archivo de la verificación de avatar en tiempo real (email_avatar) y cubre los dominios de Gmail, Yandex y Mail.ru. Puede mezclarlos libremente en un mismo archivo; cada dirección se encamina por usted. Para cada dirección devuelve si es entregable, si tiene un avatar configurado y la URL del avatar. Un archivo con direcciones fuera de esa lista falla mientras se prepara y se reembolsa íntegramente.
Límites claros
Límites de este producto
- No es una verificación de identidad. Un resultado indica si la dirección puede recibir correo; no puede confirmar quién es su titular.
- Nunca devuelve el historial de mensajes, el contenido de las conversaciones ni ningún contenido privado de la cuenta.
- La verificación de avatar cubre los dominios de Gmail, Yandex y Mail.ru. Puede mezclar libremente los tres en un mismo archivo; las direcciones fuera de esa lista hacen fallar la tarea, con el recuento correspondiente y reembolso íntegro. La verificación de entregabilidad acepta cualquier dominio.
- Los resultados reflejan el momento en que se ejecutó la tarea. Vuelva a ejecutarla para obtener un estado actualizado: los resultados almacenados nunca se actualizan automáticamente.
- Los enlaces de descarga caducan. Obtenga el archivo poco después de que termine la tarea; si un enlace caduca, vuelva a consultar la tarea para obtener uno nuevo.
Cuándo encaja el modo masivo
Cuándo merece la pena el modo masivo y cuándo es más rápido el tiempo real
| Verificación en tiempo real | Verificación masiva | |
|---|---|---|
| Cuántos correos | 1 correo por verificación individual; varios por solicitud múltiple (los límites exactos figuran en la documentación de la API) | Una lista grande completa en una sola tarea: el intervalo de tamaño actual figura en la página de precios |
| Obtención de resultados | De inmediato: el endpoint individual y el múltiple responden en la misma respuesta; el panel los devuelve uno a uno | Descargue un archivo de resultados cuando termine la tarea |
| Alcance de proveedores | Sin restricciones: combine libremente en una sola solicitud | La verificación de dirección completa admite cualquier dominio en un mismo archivo; la verificación de avatar acepta Gmail, Yandex y Mail.ru mezclados en un mismo archivo, y nada fuera de esos tres |
| Formato del resultado | JSON, campos por correo | Archivo de resultados (un CSV con la tabla completa) |
| Uso habitual | Validación de formularios, consultas de agentes, filtrado previo al envío | Depuración de listas, filtrado previo a campañas, limpieza de datos almacenados |
Preguntas frecuentes del producto
Acerca de Verificación de avatar
¿Cuándo debo usar el modo masivo en lugar de una verificación en tiempo real?
Use la verificación masiva para una lista grande completa. Para unos pocos correos, la verificación en tiempo real responde en la misma solicitud, sin ninguna tarea que programar.
¿Qué ocurre con los correos no válidos del archivo?
La comprobación previa descarta las líneas mal formadas, por lo que nunca entran en el recuento facturable. De los correos restantes, tampoco se cobran los que el servicio de origen no pueda resolver. Solo paga por los correos que realmente devuelven un resultado.
¿Cuánto tarda una tarea?
Depende del número de correos y del producto. Puede cerrar la página después de enviarla; la tarea se ejecuta en segundo plano y el resultado le espera en la página de verificación masiva.
¿Se me reembolsa si falla?
Sí. Una tarea fallida se reembolsa íntegramente. Si la tarea se completa pero algunos correos no devuelven nada, esa parte se reembolsa automáticamente. La diferencia entre el importe reservado y lo realmente cobrado siempre se le devuelve.
Productos relacionados
Otros productos masivos
Cree una cuenta para enviar una tarea masiva
Las verificaciones masivas y en tiempo real consumen el mismo saldo: no hay nada adicional que activar. Regístrese y suba su primer archivo en la página de verificación masiva.