Documentación API
API de Verificación de Email
Verificación de email simple, rápida y precisa para sus aplicaciones
Descripción General
Email Verifier es una API diseñada para ayudar a empresas y desarrolladores a identificar y prevenir direcciones de correo electrónico y dominios desechables (temporales) en tiempo real. Al garantizar que solo usuarios legítimos puedan registrarse o interactuar con su plataforma, Email Verifier protege su negocio del fraude, mejora la integridad de los datos y reduce los costos operativos.
¿Qué puede hacer Email Verifier?
- Validar emails y dominios – Verifique instantáneamente si una dirección de correo electrónico o dominio es válido, activo y confiable.
- Detectar fuentes desechables y de spam – Bloquee direcciones de correo electrónico temporales, desechables o de spam conocidas antes de que ingresen a su sistema.
- Verificar la reputación del dominio – Identifique proveedores de correo electrónico públicos, relays y dominios sospechosos.
- Verificación en tiempo real – Obtenga resultados instantáneos durante el registro de usuarios o el envío de formularios.
¿Por qué usar Email Verifier?
- Prevenir el abuso de la plataforma – Detenga la explotación de pruebas gratuitas, reduzca el spam y mantenga comunidades de usuarios auténticas.
- Mejorar la calidad de los datos – Asegúrese de que sus esfuerzos de marketing, análisis y soporte lleguen a usuarios reales, no a cuentas falsas.
- Reducir costos – Ahorre recursos al prevenir registros falsos, mejorar la entregabilidad del correo electrónico y minimizar el fraude.
- Integración sencilla – API REST simple, documentación clara y configuración directa hacen que la integración sea rápida y amigable para desarrolladores.
- Escalable y confiable – Construido sobre infraestructura moderna para alto rendimiento, confiabilidad y alcance global.
Inicio Rápido
¿Listo para proteger su plataforma y mejorar la calidad de sus datos? Siga estos pasos para obtener su clave API y realizar su primera llamada a la API:
Paso 1: Crear Cuenta
- Visite la Consola de Email Verifier.
- Complete sus datos y finalice el proceso de registro.
Una vez creada su cuenta, será redirigido automáticamente a la Consola de Email Verifier.
Paso 2: Acceder a tus Claves API
- En la Consola, navegue al menú de la izquierda y seleccione Primeros Pasos → Claves API.
- Copie su clave API de la lista mostrada o genere una nueva si es necesario.
⚠️ Importante: ¡Mantenga su clave API segura! Otorga acceso a su cuenta de Email Verifier y no debe compartirse públicamente.
Autenticación
Todas las solicitudes a la API requieren autenticación mediante un token Bearer. Incluya su clave API en el encabezado de Autorización:
Authorization: Bearer TU_CLAVE_APIURL Base
https://api.getemailverifier.comEndpoints de la API
Email Verifier proporciona dos endpoints principales para verificar emails y dominios.
Verificar Email
Verifica si una dirección de correo electrónico proviene de un servicio de correo desechable. Devuelve un análisis completo que incluye el estado desechable, detección de cuentas de rol, identificación de dominios públicos y detección de alias.
/v1/email/checkEncabezados de Solicitud
| Encabezado | Valor | Requerido |
|---|---|---|
| Authorization | Bearer TU_CLAVE_API | Sí |
| Content-Type | application/json | Sí |
Cuerpo de la Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| value | string | Sí | La dirección de correo electrónico a verificar |
Ejemplo de Solicitud
curl --request POST \
--url https://api.getemailverifier.com/v1/email/check \
--header 'Authorization: Bearer TU_CLAVE_API' \
--header 'Content-Type: application/json' \
--data '{
"value": "usuario@ejemplo.com"
}'Campos de Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| time | string | Marca de tiempo en formato ISO 8601 |
| success | boolean | Si la solicitud fue exitosa |
| data.block | boolean | Acción recomendada: true si el email debe ser bloqueado |
| data.disposable | boolean | True si proviene de un servicio de email desechable |
| data.valid | boolean | True si el formato del email es válido |
| data.role_account | boolean | True si es cuenta de rol (admin, support, etc.) |
| data.public_domain | boolean | True si es proveedor público (Gmail, Yahoo, etc.) |
| data.alias | boolean | True si se detectó aliasing (puntos de Gmail, direccionamiento plus) |
| data.details.input | string | Entrada original proporcionada |
| data.details.normalized | string | null | Forma normalizada/canónica del email |
| data.details.handle | string | null | Handle/parte local normalizado (antes de @) |
| data.details.domain | string | null | Parte del dominio (después de @) |
| data.warning | string | null | Información adicional o advertencias |
| processing_duration | integer | null | Tiempo de procesamiento en milisegundos |
| error | object | null | Información de error si la solicitud falló |
Ejemplo de Respuesta
{
"time": "2025-12-09T10:01:07.550234Z",
"success": true,
"data": {
"block": false,
"disposable": false,
"valid": true,
"role_account": false,
"public_domain": true,
"alias": false,
"details": {
"input": "usuario@ejemplo.com",
"normalized": "usuario@ejemplo.com",
"handle": "usuario",
"domain": "ejemplo.com"
},
"warning": null
},
"processing_duration": 7,
"error": null
}Verificar Dominio
Verifica si un dominio proviene de un servicio de correo desechable. Devuelve el estado desechable e identificación de dominio público.
/v1/domain/checkCuerpo de la Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| value | string | Sí | El nombre de dominio a verificar |
Ejemplo de Solicitud
curl --request POST \
--url https://api.getemailverifier.com/v1/domain/check \
--header 'Authorization: Bearer TU_CLAVE_API' \
--header 'Content-Type: application/json' \
--data '{
"value": "ejemplo.com"
}'Ejemplo de Respuesta
La estructura de respuesta es idéntica al endpoint de verificación de email. Para verificaciones de dominio, los campos normalized y handle en details serán null.
{
"time": "2025-12-09T10:01:07.550234Z",
"success": true,
"data": {
"block": false,
"disposable": false,
"valid": true,
"role_account": false,
"public_domain": false,
"alias": false,
"details": {
"input": "ejemplo.com",
"normalized": null,
"handle": null,
"domain": "ejemplo.com"
},
"warning": null
},
"processing_duration": 5,
"error": null
}Respuestas de Error
La API utiliza códigos de estado HTTP estándar para indicar éxito o falla. Todas las respuestas de error incluyen un objeto de error con un código y una descripción.
400 Solicitud Incorrecta
Solicitud no válida - el valor debe ser proporcionado y válido.
{
"time": "2025-12-09T10:01:07.550234Z",
"success": false,
"data": null,
"processing_duration": null,
"error": {
"code": "BAD_REQUEST",
"description": "Solicitud no válida - el valor debe ser proporcionado y válido"
}
}401 No Autorizado
Autenticación de clave API faltante o no válida.
{
"time": "2025-12-09T10:01:07.550234Z",
"success": false,
"data": null,
"processing_duration": null,
"error": {
"code": "UNAUTHORIZED",
"description": "Autenticación de clave API faltante o no válida"
}
}429 Demasiadas Solicitudes
Límite de velocidad excedido. Por favor, inténtelo de nuevo más tarde.
{
"time": "2025-12-09T10:01:07.550234Z",
"success": false,
"data": null,
"processing_duration": null,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"description": "Límite de velocidad excedido. Por favor, inténtelo de nuevo más tarde."
}
}500 Error Interno del Servidor
Error interno del servidor durante el procesamiento.
{
"time": "2025-12-09T10:01:07.550234Z",
"success": false,
"data": null,
"processing_duration": null,
"error": {
"code": "INTERNAL_ERROR",
"description": "Error interno del servidor"
}
}Ejemplos de Código
Aquí hay ejemplos de cómo usar la API de Email Verifier en diferentes lenguajes de programación.
JavaScript / Node.js
const response = await fetch('https://api.getemailverifier.com/v1/email/check', {
method: 'POST',
headers: {
'Authorization': 'Bearer TU_CLAVE_API',
'Content-Type': 'application/json'
},
body: JSON.stringify({
value: 'usuario@ejemplo.com'
})
});
const data = await response.json();
console.log(data);Python
import requests
url = "https://api.getemailverifier.com/v1/email/check"
headers = {
"Authorization": "Bearer TU_CLAVE_API",
"Content-Type": "application/json"
}
data = {
"value": "usuario@ejemplo.com"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())PHP
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getemailverifier.com/v1/email/check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_CLAVE_API",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"value" => "usuario@ejemplo.com"
])
]);
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);Go
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
url := "https://api.getemailverifier.com/v1/email/check"
payload := map[string]string{
"value": "usuario@ejemplo.com",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer TU_CLAVE_API")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}