Guía práctica
Verificar una lista
Verifica hasta 10.000 direcciones de email a la vez pegándolas o subiendo un archivo CSV o XLSX, sigue el progreso, revisa los resultados y expórtalos en XLSX.
Una lista de direcciones comprueba muchas direcciones de una vez, por ejemplo antes de importar contactos de otro sistema o de enviar una campaña a una lista antigua. Esta guía explica cómo crear una lista, seguir su progreso, leer los resultados y exportarlos.
Antes de empezar
- Una lista puede contener hasta 10.000 direcciones. Divide los archivos más grandes en varias listas.
- Cada dirección única cuesta 5 créditos, que se cobran al crear la lista. Una lista de 10.000 direcciones necesita 50.000 créditos.
- Las listas siempre usan el modo
full, que incluye la comprobación del buzón. Consulta Modo rápido y modo completo. - Para la API, usa una clave de API con Full Access.
Crear una lista
-
Abre Lists. Ve a Email VerificationLists y selecciona Verify emails.
-
Ponle nombre a la lista. En Name, introduce algo que reconozcas más adelante, como
Newsletter import October. -
Añade las direcciones. En Input Method, elige una opción:
- Enter emails manually: pega las direcciones en Email Addresses, separadas por comas, puntos y comas o saltos de línea.
- Upload a file: elige un archivo
.csvo.xlsxde menos de 10 MB. En un CSV, pon una dirección por fila o sepáralas con comas. En Excel, ponlas en la primera columna, una por fila. El cuadro de diálogo muestra cuántas direcciones ha encontrado.
-
Selecciona Create. Emailit cobra los créditos y empieza la verificación.
Llama a Crear una lista con un nombre y un array de direcciones:
curl https://api.emailit.com/v2/email-verification-lists \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Newsletter import October",
"emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
}'La respuesta 201 describe la nueva lista:
{
"object": "email_verification_list",
"id": "evl_3Rt8Wq5Lm2Kx",
"name": "Newsletter import October",
"status": "processing",
"stats": {
"total_emails": 3,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 3
},
"created_at": "2026-10-01T11:02:37Z",
"updated_at": "2026-10-01T11:02:37Z",
"valid_emails_count": 3,
"unique_emails_count": 3,
"invalid_emails_count": 0,
"dispatched_jobs": 3
}| Estado | Cuándo |
|---|---|
201 |
La lista se ha creado y la verificación ha empezado. |
400 |
Falta name, emails está vacío, tiene más de 10.000 elementos o ninguno parece una dirección de email. |
402 |
El espacio de trabajo no tiene créditos suficientes para todas las direcciones únicas. |
Antes de cobrar, Emailit limpia los datos de entrada: pasa todas las direcciones a minúsculas, elimina los duplicados y descarta las entradas sin @. Solo se te cobran las direcciones únicas que quedan. Si la lista no se puede iniciar, se devuelven los créditos.
Seguir el progreso
El estado de la lista pasa por estas etapas:
| Estado | Significado |
|---|---|
pending |
Creada, a la espera de empezar. |
processing |
Se están verificando las direcciones. |
completed |
Todas las direcciones tienen un resultado. |
failed |
No se ha podido procesar la lista. |
canceled |
Se ha detenido la verificación. |
En Email VerificationLists, la columna Statistics muestra los recuentos Total, Pending, Successful y Failed de cada lista. La columna Expiring muestra cuántos días quedan hasta que se elimine la lista.
Con la API, llama a Obtener una lista y lee status y stats. Para no tener que consultarla periódicamente, suscribe un webhook a email_verification_list.updated, que se dispara cuando la lista termina. Cada dirección también dispara email_verification.updated cuando su resultado está listo.
Revisar los resultados
Selecciona una lista en el panel para abrirla. La página muestra:
- tarjetas con Created, Status, Total Emails, Pending, Successful y Failed,
- gráficos de Verification Status Progress, Verification Results Breakdown y Risk Levels,
- una tabla con todas las direcciones, con su estado, resultado, riesgo y puntuación.
Con la API, llama a Listar los resultados. Filtra por result o status y recorre las páginas con page y limit (50 por defecto):
curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
--data-urlencode "result=invalid" \
--data-urlencode "limit=100"Cada elemento tiene el id, email, status, result, score, risk y mx_records de la dirección. Resultados de la verificación explica cada valor y qué hacer con él.
Exportar los resultados
Cuando una lista está completed, puedes descargar todos sus resultados como archivo de Excel.
Abre la lista y selecciona Export Results. Emailit descarga un archivo .xlsx con el ID de la lista como nombre.
Llama a Exportar los resultados y guarda la respuesta:
curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-o results.xlsxExportar una lista que no está completada devuelve 400.
El archivo tiene una fila por dirección con su estado, resultado, puntuación y riesgo, cada comprobación individual (sintaxis válida, desechable, dirección de rol, buzón lleno, entregable, desactivada, email gratuito, aleatoria, catch-all, conexión SMTP, registros MX), las partes de la dirección, la antigüedad del dominio, la sugerencia did_you_mean y los registros MX. Los resultados tienen colores para que puedas revisarlos de un vistazo.
Usar los resultados
- Elimina las direcciones con el resultado
invalid,disabledodisposableantes de importar o enviar. - Revisa las direcciones
inbox_full,roleyunknown. Consérvalas si tienes un motivo, pero vigila sus rebotes. - Importa el resto en tus contactos o en una lista de contactos.
Consulta las acciones recomendadas para cada resultado.