¿Qué es la API de verificación de emails?

Es una API que permite validar direcciones de correo en tiempo real mediante peticiones HTTP. La API comprueba sintaxis, registros MX, listas negras y realiza verificación SMTP a nivel de buzón.

¿Cómo me autentico en la API?

Debes usar una API key válida generada desde tu panel de EmailVerify.io. Las peticiones sin clave o con una clave inválida serán rechazadas.

¿Qué comprobaciones realiza la API durante la validación?

La API realiza validación por expresión regular, búsqueda de registros MX, comprobación de listas negras de MX y verificación SMTP para confirmar si el buzón existe.

¿Qué tipos de errores puede devolver la API?

Entre los errores más comunes están: Invalid API Key, Invalid Request, 0 credits remaining y mensajes genéricos cuando el servidor no puede procesar la petición.

¿Puedo consultar mis créditos restantes mediante la API?

Sí. El endpoint /check-account-balance/ te permite consultar créditos restantes, límites diarios y estado general de tu cuenta de API.

Documentación de API

Instrucciones de Verificación Instantánea

Introducción

¡Bienvenido a la API de Validación de Correo Electrónico Único de EmailVerify.io! Esta API te permite validar una única dirección de correo electrónico en tiempo real mediante una solicitud simple, garantizando precisión y fiabilidad en tus comunicaciones por correo.

Autenticación

Para acceder a la API, necesitas una clave API válida. Puedes generar tu clave personal en la sección de API después de iniciar sesión en tu cuenta. Esta clave es necesaria para la autenticación y para realizar solicitudes de forma segura.

Endpoint de la API

Valida una única dirección de correo electrónico reemplazando los marcadores de posición con tu clave API única y la dirección de correo electrónico a validar en la siguiente URL:

URL de Solicitud GET (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

Ejemplo de Respuesta Exitosa

Recibirás una respuesta como esta si tu solicitud de correo electrónico único se procesa correctamente:

URL

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

Validaciones Realizadas en la Verificación de Correo Único

Validación Regex: Verifica la estructura de las direcciones de correo contra patrones estándar para detectar errores tipográficos y de formato antes del procesamiento.

Validación MX: Verifica registros MX válidos para confirmar que el dominio está configurado para recibir correos y que existe y está activo.

Validación de Lista Negra MX: Identifica dominios en listas negras conocidos por spam o actividad maliciosa para evitar destinos de correo poco confiables.

Validación SMTP: Realiza verificación en tiempo real contactando el servidor SMTP del destinatario para confirmar que la dirección está activa y puede recibir correos.

Respuestas de Error

Mensaje de Error

Descripción

Clave API Inválida

Si la clave está deshabilitada o no existe

Solicitud Inválida

parámetros inválidos en el Endpoint de la API

0 créditos restantes

El usuario no tiene créditos disponibles

Por favor, inténtalo de nuevo

Cuando algo salió mal de nuestro lado

Consultar Saldo de la Cuenta

Por favor, utiliza la siguiente solicitud GET para consultar el saldo actual de la cuenta (créditos diarios e instantáneos restantes).

URL de Solicitud GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aquí, reemplaza <Your_API_Key> con tu clave API activa.

Respuesta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instrucciones de Verificación Masiva

Introducción

¡Bienvenido a la API de Verificación Masiva de EmailVerify.io! Esta API te permite validar hasta 5000 correos electrónicos en tiempo real con una simple solicitud, asegurando precisión y confiabilidad.

Este endpoint te permite enviarnos lotes de hasta 5000 correos a la vez. Si deseas validaciones de correos únicos, usa el endpoint de validador único.

Autenticación

Para acceder a la API, necesitarás una clave API válida. Genera tu clave personal en la sección de API después de iniciar sesión en tu cuenta. Esta clave es necesaria para la autenticación y para realizar solicitudes de forma segura.

Endpoint de la API

Valida una sola dirección de correo reemplazando los marcadores de posición con tu clave API única y el correo a validar en la siguiente URL

URL de Solicitud POST (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

Solicitud POST

Puedes validar hasta 5000 direcciones de correo electrónico enviándolas en la siguiente solicitud POST.

Solicitud POST

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

Ejemplo de Respuesta Exitosa

Recibirás una respuesta como esta cuando tu tarea de verificación masiva se cree con éxito.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

Solicitud GET

Este punto final recupera los resultados de una tarea de verificación masiva de correos electrónicos creada previamente. Los resultados incluirán el estado general de la tarea y, si ha finalizado, los resultados de la verificación.

URL de Solicitud GET

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

Ejemplo de Respuesta Exitosa

Aquí tienes un ejemplo de respuesta una vez que se complete tu tarea de verificación:

Solicitud POST

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

Validaciones Realizadas en la Verificación Masiva de Correos

Validación Regex: Verifica la estructura de las direcciones de correo contra patrones estándar para detectar errores tipográficos y de formato antes del procesamiento.

Validación MX: Verifica registros MX válidos para confirmar que el dominio está configurado para recibir correos y que existe y está activo.

Validación de Lista Negra MX: Identifica dominios en listas negras conocidos por spam o actividad maliciosa para evitar destinos de correo poco confiables.

Validación SMTP: Realiza verificación en tiempo real contactando el servidor SMTP del destinatario para confirmar que la dirección está activa y puede recibir correos.

Respuestas de Error

Mensaje de Error

Descripción

Clave API Inválida

Si la clave está desactivada o no existe

Solicitud Inválida

Parámetros inválidos en el endpoint de la API

0 créditos restantes

El usuario no tiene créditos disponibles

Por favor, inténtalo de nuevo

Cuando algo salió mal de nuestro lado

Consultar Saldo de la Cuenta

Por favor, utiliza la siguiente solicitud GET para consultar el saldo actual de la cuenta (créditos diarios e instantáneos restantes).

URL de Solicitud GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aquí, reemplaza <Your_API_Key> con tu clave API activa.

Respuesta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instrucciones del Buscador de Correo Único

Introducción

La API de correo único te permite encontrar una dirección de correo profesional en tiempo real usando el nombre de una persona y el dominio de su empresa. Es ideal para generación de prospectos y contacto rápido y confiable.

Este endpoint te permite recuperar direcciones de correo por solicitud proporcionando nombre y dominio. El primer resultado encontrado se devolverá como respuesta. Cada solicitud descuenta diez créditos.

Autenticación

Para acceder a la API, necesitas una clave API válida. Puedes generar tu clave API personal desde la sección API después de iniciar sesión en tu cuenta. Esta clave es requerida para autenticación y para hacer solicitudes de forma segura.

Endpoint de la API

URL

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

Ejemplo de Respuesta si se encuentra un correo

Recibirás una respuesta idéntica si se encuentra el correo

Respuesta si se encuentra

{
  "email": "[email protected]",
  "status": "found"
}

Ejemplo de Respuesta si no se encuentra un correo

Recibirás una respuesta idéntica si no se encuentra el correo

Respuesta si no se encuentra

{
  "email": "null",
  "status": "not_found"
}

Verificaciones Realizadas en el Buscador de Correos

Verificación de Combinaciones: Verifica el nombre proporcionado contra veinticinco combinaciones junto con el dominio e identifica cuál resulta en un correo válido.

Validación MX: Verifica registros MX válidos para confirmar que el dominio está configurado para recibir correos y que existe y está activo.

Validación de Lista Negra MX: Identifica dominios en listas negras conocidos por spam o actividad maliciosa para evitar destinos de correo poco confiables.

Validación SMTP: Realiza verificación en tiempo real contactando el servidor SMTP del destinatario para confirmar que la dirección está activa y puede recibir correos.

Respuestas de Error

Mensaje de Error

Descripción

Clave API Inválida

Si la clave está desactivada o no existe

Solicitud Inválida

Parámetros inválidos en el endpoint de la API

0 créditos restantes

El usuario no tiene créditos disponibles

Los dominios gratuitos están bloqueados

Cuando el usuario intenta encontrar correos de un dominio gratuito

Consultar Saldo de la Cuenta

Verifica registros MX válidos para confirmar que el dominio está configurado para recibir correos y que existe y está activo.

URL de Solicitud GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance?key=<Su clave API>

Aquí, reemplaza <Su clave API> con tu clave API activa.

Respuesta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}