La validación de correos electrónicos es un paso crítico para garantizar que los datos de contacto que entran en tu sistema son correctos y utilizables. Con la API de VerificarEmails puedes integrar la verificación de emails de tres formas principales: validaciones individuales en tiempo real, validaciones masivas de listas mediante ficheros y validación directa en formularios gracias al widget WidgetJS.
A continuación, se explican estas modalidades con ejemplos prácticos. Los puntos que trataremos son:
Explicar la validación individual de emails con ejemplos cURL.
Incluir el flujo de validación masiva por ficheros con
/multiple.Mostrar cómo usar WidgetJS en formularios web con snippet de código.
Referenciar el uso de Postman para generar snippets en varios lenguajes.
Reforzar la idea de entregabilidad y calidad de datos.
Verificación individual con la API
Cuando necesitas validar un único correo (por ejemplo, en un formulario de registro o en un proceso puntual), puedes utilizar el endpoint /email/validate/single.
Ejemplo con cURL
curl -i "https://dashboard.verificaremails.com/myapi/email/validate/single?auth-token=TU_TOKEN&term=test@example.com" \
-H "accept: application/json"
Respuesta típica
{
"id": "364637",
"term": "test@example.com",
"request_id": "364637",
"result_code": "114",
"result_type": "Inconclusive",
"result": {
"status": "ok_for_all"
}
}
El resultado de la validación está en result.status. Con ok, la dirección ha superado todas las comprobaciones; cualquier otro valor indica que no se ha podido confirmar o que ha fallado. En el ejemplo, ok_for_all significa que el servidor de correo acepta cualquier dirección de su dominio, así que no se puede saber si ese buzón existe. Tienes el significado de cada estado en la guía de resultados de la documentación.
👉 En la guía de Postman tienes la colección lista para importar y generar snippets en Python, Node.js, PHP, etc.
Verificación masiva con ficheros
Cuando se trata de validar listas completas, la API ofrece el endpoint /email/validate/multiple. Este endpoint permite subir un fichero con miles de correos para validarlos en lote y obtener los resultados en un archivo procesado.
Ejemplo de subida de fichero con cURL
curl -X POST "https://dashboard.verificaremails.com/myapi/email/validate/multiple?auth-token=TU_TOKEN" \
-F "file=@/ruta/a/tu/archivo_emails.csv" \
-F "column=A"
Respuesta típica
{
"request_id": "368228"
}
Con el request_id puedes consultar el estado del procesamiento (total, procesados y pendientes) y, cuando termine, descargar el fichero. Vuelve con el mismo formato y dos columnas más, status y result, con la clasificación de cada correo. Si lo prefieres, añade callback_url para que te avisen al terminar.
👉 Al igual que en la validación individual, en Postman encontrarás ejemplos que generan código en múltiples lenguajes, lo que facilita la integración en tus proyectos.
Validación en formularios con WidgetJS
Para los casos donde necesitas verificar emails directamente en tu web, VerificarEmails ofrece un widget JavaScript que puedes insertar en formularios sin necesidad de programar desde cero.
Cómo funciona
- Desde el panel, entra en la sección Widget del menú lateral y crea un widget nuevo.
- Seleccionas los servicios que quieres validar (por ejemplo, solo correos electrónicos).
- Configuras las reglas de aceptación (ej. aceptar solo resultados “OK”).
- Obtienes un snippet de código que insertas en tu formulario web.
Ejemplo de uso
No copies un código de ejemplo: al terminar el asistente, el panel te da el código de tu widget con su configuración. Pégalo en la página del formulario y comprueba con una dirección que sepas que no existe que el formulario la rechaza.
El widget intercepta el campo de email, consulta en segundo plano la API y muestra al usuario si la dirección es válida antes de que pueda enviar el formulario.
Y si no quieres integrar nada, el servicio de validación de emails valida tu lista completa antes de cada campaña.
Conclusión
La API de VerificarEmails.com te permite cubrir todas las necesidades de validación:
- Individual, para registros en tiempo real.
- Masiva, para limpiar grandes listas con el endpoint
/multiple. - WidgetJS, para integrar verificación en tus formularios web sin código adicional.
Con soporte en Postman, es sencillo extender estos ejemplos a cualquier lenguaje de programación. Esto asegura que tus sistemas trabajen siempre con datos limpios y que tus campañas de email marketing mantengan la mejor entregabilidad posible. Verificaremails según la opinión de los clientes de NewsletterSoft, plataforma de marketing automation con más de 20 años de experiencia en email marketing, es el mejor servicio de validación de correos electrónicos mediante API que han probado. La encuesta se realizó sobre un base de más de 300 clientes de la plataforma.


