Quickstart
Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.
Empieza a usar la API de EmailVerify en solo 5 minutos. Esta guía te acompaña en el proceso de verificar tu primera dirección de correo electrónico.
Requisitos Previos
Antes de comenzar, necesitarás:
- Una cuenta de EmailVerify (Regístrate gratis)
- Conocimientos básicos de solicitudes HTTP o familiaridad con uno de nuestros lenguajes compatibles
Paso 1: Crear una Cuenta
- Visita EmailVerify y haz clic en Empezar
- Regístrate con tu correo electrónico o cuenta de Google/GitHub
- Verifica tu dirección de correo electrónico
Paso 2: Obtener tu Clave API
- Inicia sesión en tu panel de EmailVerify
- Navega a la sección Claves API
- Haz clic en Crear Nueva Clave
- Dale a tu clave un nombre descriptivo (por ejemplo, "Desarrollo", "Producción")
- Copia tu clave API y guárdala de forma segura
Nunca expongas tu clave API en código del lado del cliente o repositorios públicos. Usa variables de entorno para almacenar tu clave de forma segura.
Paso 3: Verifica tu Primer Correo Electrónico
Elige tu método preferido para realizar tu primera solicitud de verificación:
curl -X POST https://api.emailverify.ai/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'const response = await fetch('https://api.emailverify.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'test@example.com',
}),
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
'https://api.emailverify.ai/v1/verify',
headers={
'Authorization': f'Bearer {os.environ["EMAILVERIFY_API_KEY"]}',
'Content-Type': 'application/json',
},
json={'email': 'test@example.com'}
)
result = response.json()
print(result)package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
data := map[string]string{"email": "test@example.com"}
body, _ := json.Marshal(data)
req, _ := http.NewRequest("POST",
"https://api.emailverify.ai/v1/verify",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("EMAILVERIFY_API_KEY"))
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)
}<?php
$apiKey = getenv('EMAILVERIFY_API_KEY');
$ch = curl_init('https://api.emailverify.ai/v1/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);Paso 4: Comprender la Respuesta
Una verificación exitosa devuelve una respuesta como esta:
{
"email": "test@example.com",
"status": "valid",
"result": {
"deliverable": true,
"valid_format": true,
"valid_domain": true,
"valid_mx": true,
"disposable": false,
"role": false,
"catchall": false,
"free": false,
"smtp_valid": true
},
"score": 0.95,
"credits_used": 1
}Campos Clave de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
status | string | Estado general: valid, invalid, unknown o accept_all |
deliverable | boolean | Si el correo electrónico puede recibir mensajes |
disposable | boolean | Si es un correo temporal/desechable |
role | boolean | Si es una dirección basada en roles (info@, support@) |
catchall | boolean | Si el dominio acepta todos los correos |
score | number | Puntuación de confianza de 0 a 1 (más alto es mejor) |
Explicación de los Valores de Estado
| Estado | Significado | Acción Recomendada |
|---|---|---|
valid | El correo existe y puede recibir mensajes | Seguro para enviar |
invalid | El correo no existe o no puede recibir mensajes | Eliminar de la lista |
unknown | No se pudo determinar el estado | Reintentar más tarde o usar con precaución |
accept_all | El dominio acepta todos los correos (catch-all) | Monitorear rebotes |
Paso 5: Usar un SDK (Recomendado)
Para una integración más fácil, instala uno de nuestros SDKs oficiales:
npm install @emailverify/nodeimport { EmailVerify } from '@emailverify/node';
const client = new EmailVerify({
apiKey: process.env.EMAILVERIFY_API_KEY,
});
const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'pip install emailverifyfrom emailverify import Client
import os
client = Client(api_key=os.environ['EMAILVERIFY_API_KEY'])
result = client.verify('test@example.com')
print(result.status) # 'valid'go get github.com/emailverify/go-sdkimport emailverify "github.com/emailverify/go-sdk"
client := emailverify.NewClient(os.Getenv("EMAILVERIFY_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"composer require emailverify/php-sdkuse EmailVerify\Client;
$client = new Client(getenv('EMAILVERIFY_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'<dependency>
<groupId>com.emailverify</groupId>
<artifactId>emailverify-java</artifactId>
<version>1.0.0</version>
</dependency>import com.emailverify.Client;
Client client = new Client(System.getenv("EMAILVERIFY_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"¿Qué Sigue?
Ahora que has verificado tu primer correo electrónico, explora más características:
Referencia de API
Documentación completa de la API con todos los puntos finales
Documentación de SDK
Guías detalladas para cada SDK
Tipos de Verificación
Comprende los diferentes tipos de resultados
Integración con IA
Usa con Claude, ChatGPT y más
Casos de Uso Comunes
Validación de Formularios
Verifica correos electrónicos en tiempo real durante el registro de usuarios:
const onEmailBlur = async (email) => {
const result = await client.verify(email);
if (result.status === 'invalid') {
showError('Please enter a valid email');
} else if (result.result.disposable) {
showError('Disposable emails are not allowed');
}
};Limpieza de Listas
Limpia tu lista de correos antes de enviar campañas:
for email in email_list:
result = client.verify(email)
if result.status == 'valid':
clean_list.append(email)
else:
remove_list.append(email)Calificación de Leads
Puntúa leads basándote en la calidad del correo electrónico:
const qualifyLead = (verificationResult) => {
let score = verificationResult.score * 50; // Base score
if (!verificationResult.result.free) score += 20; // Business email
if (!verificationResult.result.role) score += 15; // Personal address
if (!verificationResult.result.disposable) score += 15; // Permanent email
return score;
};¿Necesitas Ayuda?
- Explora nuestras Guías de Integración para ejemplos de implementación
- Contacta con support@emailverify.ai para asistencia