Validar Emails

Integración API y ejemplos de uso práctico para desarrolladores en la verificación de direcciones de correo

Integra la API de VerificarEmails para validar correos en tiempo real, masivos o con WidgetJS y mejora la calidad de tus listas de email.

verificar emails en formularios de registro con Verificaremails

Compartir

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

  1. Desde el panel, entra en la sección Widget del menú lateral y crea un widget nuevo.
  2. Seleccionas los servicios que quieres validar (por ejemplo, solo correos electrónicos).
  3. Configuras las reglas de aceptación (ej. aceptar solo resultados “OK”).
  4. 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.

Compartir

Escrito porAntxon PousEmprendedor y fundador de NewsletterSoft y Skeyon LabFundador de NewsletterSoft, empresa que recibió inversión de Caixa Capital Risc, e impulsor de VerificarEmails.com. Desarrolla soluciones de email marketing, automatización y validación de datos para empresas. Compagina su actividad emprendedora con la formación en Udemy, donde cuenta con más de 70.000 alumnos.Conecta con Antxon en LinkedIn

Automatiza tu marketing con email, SMS y WhatsApp

Te enseñamos la plataforma en una demo personalizada.