Iniciar sesión Empezar

API de verificación de emails.

Verifica una dirección o una lista entera de hasta 100.000 mediante una API REST. Cada dirección vuelve con un estado, el motivo y la acción que tomar, y solo pagas por las respuestas definitivas: las desconocidas, los duplicados y las direcciones mal formadas son gratis. Las mismas comprobaciones funcionan como herramientas MCP, para que un asistente de IA verifique una lista por ti.

POST /ext/v2/email-verification/instant-checks 
curl -X POST https://api.unspam.email/ext/v2/email-verification/instant-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -d '{"email":"jane@acme.com"}'

# response (202): read it by id until completed
curl https://api.unspam.email/ext/v2/email-verification/instant-checks/8d3f1a2b \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "status": "completed",
  "charged": true,
  "result": {
    "status": "deliverable",
    "reason": "accepted",
    "action": "keep",
    "flags": ["free_provider"],
    "did_you_mean": null
  }
}
curl -X POST https://api.unspam.email/ext/v2/email-verification/list-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -F "file=@leads.csv"

# response (202): the list is analysed, then verified
{
  "status": "verifying",
  "rows_total": 12480,
  "duplicates": 311,
  "progress": { "processed": 4200, "total": 12046 }
}

# then page through every address, in the order sent
curl https://api.unspam.email/ext/v2/email-verification/list-checks/5c2e9f10/results \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

Cinco endpoints, un token.

URL base https://api.unspam.email/ext/v2, con el bearer token de tu cuenta. Es el mismo token que usan las API de prueba antispam, de Inbox Placement y de vista previa.

Verificar una dirección

POST /email-verification/instant-checksInicia la comprobación de una dirección y responde 202 con su id.

Leer el resultado

GET /email-verification/instant-checks/{id}Estado pending hasta que termina la comprobación y después el resultado completo.

Verificar una lista

POST /email-verification/list-checksDirecciones en JSON o un archivo CSV o TXT, hasta 100.000 filas. La verificación empieza cuando se ha analizado la lista.

Seguir la lista

GET /email-verification/list-checks/{id}Estado, recuentos, progreso mientras se ejecuta y un resumen por estado y motivo.

Recorrer los resultados

GET /email-verification/list-checks/{id}/resultsCada dirección en el orden en que la enviaste, con su resultado completo. Responde 410 cuando la lista ha caducado.

Qué comprueba la API en cada dirección.

Sintaxis, dominio y servidor de correo

Cada dirección se analiza, se resuelve su dominio y se leen sus registros MX, así que las erratas y los dominios que ya no reciben correo se detectan antes de preguntar nada a un buzón.

Buzón, catch-all y buzón lleno

Se pregunta al servidor de correo si el buzón existe, sin enviar ningún mensaje. Los dominios catch-all, los buzones llenos y los buzones desactivados vuelven cada uno con su propio motivo.

Desechables, de rol y proveedores gratuitos

Hay indicadores para los dominios desechables, las direcciones de rol como info@ y sales@ y los proveedores gratuitos, para que tu código decida cómo tratar cada caso.

Sugerencias ante erratas

Cuando una dirección parece una errata, did_you_mean trae la que probablemente se quería escribir, como gmail.com para gmial.com.

Una dirección, una lista entera o un asistente de IA.

Dos accesos por REST y uno por MCP, todos con el mismo token y el mismo motor de verificación.

01

Verifica una sola dirección

Envía una dirección y recibe un id al instante. Consúltalo hasta que su estado sea completed y luego actúa según el resultado: entregable, arriesgada, no entregable o desconocida, con un motivo, una acción y el detalle del dominio, el servidor de correo y el buzón que lo respaldan.

La comprobación es asíncrona, así que encaja donde una breve espera no importa: un contacto antes de entrar en tu CRM, un lead antes de una secuencia, una dirección antes de un envío puntual. No es una comprobación síncrona que retenga un formulario de registro hasta responder.

  • jane@acme.com accepted
  • sales@northwind.io catch_all
  • lead@oldco.invalid invalid_domain
  • mark@yahoo.com provider_unverifiable
02

Verifica una lista entera

Envía hasta 100.000 direcciones en JSON, o sube un archivo CSV o TXT de hasta 20 MB y deja que la API encuentre la columna de direcciones y la fila de encabezado. Los duplicados y las filas mal formadas se cuentan y se omiten, nunca se cobran, y una lista que tus créditos no cubren se rechaza antes de ejecutar una sola comprobación.

Consulta el progreso en la propia lista y luego recorre todos los resultados, página a página, en el orden en que los enviaste. Las listas y sus resultados se eliminan 30 días después de la subida.

  • Entregable 10,512
  • Arriesgada 842
  • No entregable 415
  • Desconocida, sin cargo 277
03

Deja que lo haga un asistente de IA

Las mismas comprobaciones son herramientas del servidor MCP de Unspam, así que Claude, Cursor o cualquier cliente MCP remoto puede verificar una dirección o una lista desde una conversación y devolver cada resultado con su motivo.

Cinco herramientas: verify_email, get_email_verification, create_email_list, get_email_list y get_email_list_results.

  • Verifica una dirección verify_email
  • Verifica una lista create_email_list
  • Lee los resultados get_email_list_results

Lo que te dice cada resultado.

Cuatro campos contienen la respuesta, así que tu código decide con un solo valor y aun así tiene el detalle cuando lo necesita.

  1. 01

    status

    Entregable, arriesgada, no entregable o desconocida: el único campo con el que decidir.

  2. 02

    reason

    Por qué recibió ese estado: accepted, catch_all, full_inbox, disposable, invalid_syntax, invalid_domain, rejected, disabled, timeout, smtp_unavailable o provider_unverifiable.

  3. 03

    action

    Conservar, revisar, eliminar o reintentar, para que no tengas que convertir cada motivo en una decisión por tu cuenta.

  4. 04

    charged

    Si la comprobación gastó un crédito. Las respuestas desconocidas, los duplicados y las direcciones mal formadas nunca lo gastan.

Preguntas sobre la API de verificación de emails.

Precios, velocidad, resultados desconocidos, listas y asistentes de IA.

¿Cuánto cuesta la API de verificación de emails?
El acceso a la API está incluido en el plan personalizado, desde un mínimo de $5 al mes. La verificación tiene precio por tramos, desde $6,40 por cada 1.000 direcciones hasta $1,20 por cada 1.000 a partir de 100.000, y solo las respuestas definitivas gastan un crédito. Las respuestas desconocidas, los duplicados y las direcciones mal formadas son gratis, y puedes recargar créditos sin cambiar de plan.
¿Hay una API de verificación de emails gratis?
Las primeras 10 comprobaciones individuales de cada día son gratis, tanto por la API como en la app, y una respuesta desconocida nunca se cobra. Para probarlo sin cuenta, el verificador de emails comprueba hasta 10 direcciones al día sin registro.
¿La API de verificación de emails funciona en tiempo real?
Es asíncrona. Una comprobación empieza al instante y responde con un id, y lees el resultado cuando su estado es completed. Eso encaja con importaciones, sincronizaciones de CRM, enrutamiento de leads y limpieza de listas. Hoy no se ofrece una comprobación síncrona que retenga un formulario de registro hasta responder.
¿Qué diferencia hay entre validar y verificar un email?
Validar suele significar comprobar que una dirección está bien formada y que su dominio puede recibir correo. Verificar va más allá y pregunta al servidor de correo si el buzón existe. La API hace ambas cosas en una sola llamada: primero sintaxis, dominio y MX, y después las comprobaciones de buzón, catch-all y buzón lleno.
¿Por qué algunas direcciones vuelven como desconocidas?
Yahoo y AOL aceptan cualquier dirección durante la comprobación del buzón, así que ningún verificador puede confirmar esos buzones: vuelven como desconocidas con el motivo provider_unverifiable. Un servidor de correo que agota el tiempo de espera o no responde también termina como desconocida, con el motivo timeout o smtp_unavailable y la acción retry. Las respuestas desconocidas nunca se cobran.
¿Cómo verifico una lista entera mediante la API?
Envía las direcciones como un array JSON, o sube un archivo CSV o TXT de hasta 100.000 filas y 20 MB. La API encuentra la columna de direcciones y la fila de encabezado, cuenta los duplicados y las filas mal formadas sin cobrarlos y empieza a verificar cuando se ha analizado la lista. Consulta la lista para ver el progreso y un resumen, y luego recorre los resultados página a página.
¿Puede un asistente de IA verificar direcciones de email con Unspam?
Sí. El servidor MCP de Unspam expone la verificación como cinco herramientas, así que Claude, Cursor o cualquier cliente MCP remoto puede verificar una dirección o una lista entera y devolver cada resultado con su motivo y su acción.
¿Se conservan los datos de las listas?
Las listas y sus resultados se eliminan 30 días después de la subida, y a partir de entonces el endpoint de resultados responde 410 Gone. Las direcciones se comprueban con el servidor de correo sin enviar ningún mensaje a nadie.

Verifica tu primera lista mediante la API.

El acceso a la API está incluido en el plan personalizado, desde un mínimo de $5 al mes. Paga solo por las respuestas definitivas, desde $6,40 por cada 1.000 direcciones.

Ver precios