🎬 Presentamos transcript.im: transcripciones gratis de vídeos de YouTube, TikTok e Instagram.Probar transcript.im

API de Validación de Email

Un endpoint para cada tipo de verificación. Una API de validación de email en tiempo real con comprobaciones SMTP, respuestas JSON estructuradas e integración nativa con MCP y Agent Skills.

Consola de la API de validación de email con solicitud POST, tarjeta Clave API e insignia 200 OK
API de validación de email

Verifica en tiempo real

Usa una sola llamada API para verificar direcciones durante el registro, enriquecimiento, flujos de trabajo de agentes IA o pipelines personalizados de procesamiento de listas.

JSON estructuradoRespuesta en tiempo realVerificación SMTP
Get Started for Free
API de validación de email en tiempo real devuelve una respuesta 200 OK tras una comprobación SMTP

Todos los modos de la API de validación, un endpoint

Cada tipo de verificación se alcanza a través de la misma REST API de validación de email.

API de validación de email gratis con tarjetas de modo Individual, Lote, Archivo e integración por SDK

Verificación de un solo correo

POST /verify — una llamada a la API de validación de email en tiempo real, con respuesta en menos de 3 s. Devuelve estado, entregabilidad, puntuación de calidad e indicadores de riesgo en un solo objeto JSON.

Verificación por lotes

POST /verify/bulk — valida hasta 50 direcciones por llamada a la API, de forma síncrona. Todos los resultados vuelven en una sola respuesta de la API, con el mismo esquema que la validación individual.

Procesamiento asíncrono de archivos

POST /verify/file — envía archivos CSV o Excel a la API para procesamiento en segundo plano. Los resultados se entregan vía callback de webhook cuando el trabajo de la API termina.

SDKs oficiales

Bibliotecas cliente con tipos seguros para la API de validación de email gratis en Python, Node.js, Go y PHP. Reintento automático en caso de error, manejo completo de errores y tipos de respuesta idénticos en todos los lenguajes.

Soporte de webhooks en la API de validación

Recibe los resultados de la API de forma asíncrona y consulta el historial de mensajes.

Webhooks de la API de validación entregan un Evento de callback junto a la insignia Reintentar

Entrega asíncrona

Crear webhooks

Registra endpoints HTTP para recibir resultados de la API en el momento en que un trabajo o lote termina. La API admite payloads personalizados, reintento automático en caso de error y configuración por trabajo o global.

  • Eventos de finalización de trabajo con resumen de resultados
  • Reintento automático en caso de fallo de entrega
  • Configuración por trabajo o a nivel de cuenta

Historial de mensajes

Consultar mensajes

Accede al registro completo de eventos webhook para recuperar resultados anteriores de la API, depurar fallos de entrega o reproducir notificaciones perdidas. Los eventos de la API se conservan 30 días.

  • Consulta eventos por ID de trabajo o rango de fechas
  • Reproduce entregas perdidas o fallidas
  • Retención de eventos durante 30 días

Contrato de respuesta

Qué devuelve la API de validación de email, campo a campo

La mayoría de los equipos adoptan una API de validación para sustituir una expresión regular. El salto solo merece la pena si la respuesta de la API aporta más información que el booleano que reemplaza.

status es el campo sobre el que tu código debe ramificar

La API devuelve uno de cuatro estados: deliverable, undeliverable, risky o unknown. Hay cuatro estados porque la realidad tiene cuatro, y cualquier API de validación que los comprima en true y false obliga a cada cliente a reinventar el matiz que falta.

Ramifica primero por status. El resto de la respuesta de la API de validación de email gratis explica el estado; no lo sustituye.

score y el nivel de riesgo sirven para ordenar, no para bloquear

Una puntuación de calidad de 0 a 100 y un nivel de riesgo te permiten ordenar una cola, priorizar el seguimiento comercial o ajustar un umbral por superficie. Son campos derivados de la API: trátalos como pistas de orden, no como el veredicto de la API.

Filtrar solo por puntuación es cómo los equipos rechazan por accidente a buenos clientes. Filtra por status; ordena con score.

Los reason codes hacen que la API sea depurable

Cada respuesta de la API que no es deliverable lleva un motivo legible por máquina. Sintaxis inválida, sin ruta de correo, buzón rechazado y aplazamiento del proveedor son problemas distintos con soluciones distintas, y nuestra API de validación de email gratis nombra cada uno en lugar de devolver un fallo genérico.

Registra el reason code de la API, no la prosa. Es estable entre versiones, y es lo que permite responder meses después un ticket de soporte sobre una dirección.

Los flags booleanos describen la dirección, no su entregabilidad

Desechable, cuenta de rol, catch-all y webmail personal gratuito llegan como flags independientes de la API. Una dirección puede ser perfectamente entregable y aun así llevar tres de ellos: exactamente el caso que un validador de sintaxis no puede expresar y una API sí.

Esta es la diferencia práctica entre una API de validación de email en tiempo real y una comprobación de formato: la de formato te dice que la cadena está bien formada, y la API te dice qué es realmente la dirección.

Migración

Pasar de un validador de sintaxis a una API de validación real

Los equipos suelen llegar aquí con una regex o una llamada a una librería ya en el código. La migración a la API es pequeña, pero hay que cambiar tres hábitos con ella.

Deja de tratar el formato como la respuesta

Una expresión regular demuestra que una cadena podría ser una dirección. Esta API de validación de email gratis demuestra que un servidor de correo la acepta ahora. Conserva la regex como pista barata en el cliente si quieres, pero deja de usarla para decidir si un registro es bueno.

En la práctica, esto significa quitar la rama que dice formato válido por tanto guardar, y sustituirla por una rama sobre el campo status de la API.

Dale a la API un timeout y un fallback

Una llamada de red puede ser lenta cuando el proveedor receptor es lento. Dale a la API un timeout con el que tu formulario pueda convivir, y decide de antemano qué ocurre cuando expira: normalmente aceptar la dirección, marcarla como no verificada y volver a comprobarla con una llamada posterior a la API.

Una API de validación de email en tiempo real nunca debería ser la razón de que falle un registro. Degrada a no verificado, no a rechazado.

Guarda el resultado como datos, no como un filtro

Escribe en el registro el status de la API, el reason code, los flags y una marca de tiempo checked-at. Un equipo que solo guarda un booleano limpio no puede explicar una decisión de supresión tres campañas después, ni distinguir evidencia reciente de la API de evidencia caducada.

Guardar la respuesta completa de la API también te permite cambiar la política sin volver a verificar: los hechos permanecen y solo se mueve la regla que los lee.

Trata unknown de forma deliberada, una sola vez

Unknown no es un error de la API ni un fallo. Significa que el proveedor receptor no se comprometió. Decide la política de reintento en un solo sitio — una cola, un retraso, un máximo de intentos de la API — en lugar de dispersar reintentos ad hoc por el código.

La mayoría de los resultados unknown se resuelven en una llamada posterior a la API, y por eso nuestra API de validación de email gratis los informa con honestidad en lugar de adivinar.

Superficie de integración

Cuatro formas de llamar a la API de validación de email

Un endpoint, cuatro formas de la API. Elige según el tamaño y la latencia del trabajo, no por preferencia.

  1. 1

    Una dirección, síncrono

    POST /verify toma una dirección y devuelve el JSON completo en uno a tres segundos. Este es el camino de la API de validación de email en tiempo real que usan los formularios de registro, el checkout y las ediciones de perfil.

    Como es una sola llamada a la API, sin ciclo de vida de trabajo, también es la superficie más fácil de probar antes de construir nada más grande.

  2. 2

    Hasta 50 direcciones en una llamada

    POST /verify/bulk verifica hasta 50 direcciones de forma síncrona y las devuelve con el mismo esquema. Úsalo cuando una página o un trabajo maneje de forma natural un puñado de registros a la vez.

    El límite del lote es un límite duro de la API, no uno suave. Los payloads más grandes se rechazan con un error claro de la API que apunta al endpoint de archivo, de modo que nada se degrada en silencio a una petición lenta.

  3. 3

    Archivos, de forma asíncrona

    POST /verify/file acepta CSV o Excel, procesa en segundo plano y llama a tu webhook cuando el trabajo de la API termina. Nada tiene que mantener una conexión abierta mientras corre un archivo grande.

    Para una carga con forma de lista en lugar de forma de API, Verificación masiva de email ejecuta el mismo motor sobre un archivo subido, con deduplicación y una exportación CSV.

  4. 4

    Desde agentes de IA y clientes MCP

    El MCP Server expone la misma API de validación de email a Claude Desktop y Cursor en lenguaje natural, y Agent Skills la instala en plataformas de agentes con un clic. Ambos devuelven el mismo JSON estructurado que la REST API.

    Eso mantiene honesto el comportamiento del agente: la herramienta no puede resumir unknown como correcto, porque la respuesta de la API de validación de email gratis es lo que el agente lee.

Alcance

Lo que la API de validación deja deliberadamente en tus manos

La API es estrecha a propósito. Cada punto de abajo es un requisito real — solo que pertenece a otro lugar de tu sistema, no a una API de validación.

Consentimiento y supresión

Nuestra API de validación de email gratis puede decirte que una dirección acepta correo. No puede decirte que la persona aceptó oírte, y no lee tu lista de supresión.

Mantén el consentimiento en tu propio sistema de registro y compruébalo antes, no después, de la llamada a la API.

Identidad y empleo

Una dirección de empresa entregable no demuestra que la persona nombrada la controle o siga trabajando allí. Los alias, las bandejas compartidas y el enriquecimiento caducado rompen esa suposición con regularidad.

Usa datos de primera parte para la identidad. Esta API de validación de email gratis devuelve evidencia sobre un buzón, no sobre una persona.

Colocación en la bandeja de entrada

La aceptación SMTP es un hecho del lado del destinatario. Que tu mensaje llegue a la bandeja depende de la reputación del remitente, la autenticación, el contenido y el historial de quejas, nada de lo cual la API puede observar.

Corrige la calidad de las direcciones con la API; corrige la colocación con trabajo del lado del remitente y monitorización que la API no puede hacer por ti.

Vigencia

Cada respuesta de la API describe el momento de la llamada. Los buzones se cierran, los alias se retiran y los dominios migran, así que un resultado guardado de la API caduca, se relea o no.

Vuelve a verificar con un calendario acorde a la velocidad a la que cambian tus datos, y deja que la marca de tiempo checked-at tome esa decisión automáticamente.

Superficies relacionadas

Dónde encaja la API de validación de email junto al resto de herramientas

El mismo motor aparece detrás de varias superficies de la API. Cuál quieres depende de quién pregunta y de cuántas direcciones hay.

El encuadre de verificación del mismo endpoint

La API de verificación de email documenta el mismo endpoint para equipos que buscan verificación en lugar de validación, con la evidencia SMTP explicada con más profundidad.

El esquema, los créditos y la precisión son idénticos — solo cambia el encuadre de la documentación.

Una herramienta de navegador para una dirección

Cuando alguien necesita mirar un solo resultado en lugar de automatizar nada, el Verificador de email ejecuta el mismo pipeline en el navegador y muestra cada flag que devolvería la API.

Es la forma más rápida de confirmar el comportamiento del motor antes de escribir código contra la API de validación de email gratis.

Validación superficial sin SMTP

Si el requisito es de verdad solo formato y enrutamiento de correo, el Validador de email se detiene en sintaxis y MX y nunca gasta una comprobación SMTP.

Úsalo para un prefiltro barato, y reserva la API de validación de email en tiempo real para los registros en los que un rebote sí cuesta algo.

Preguntas frecuentes

1. ¿Qué tan rápida es la API de validación de email?

Los resultados de la API en caché responden en menos de 200ms. La validación SMTP completa tarda de 1–3 segundos de promedio, y por eso sirve como API de validación de email en tiempo real dentro de un formulario. La API admite hasta 6,000 solicitudes individuales por minuto y 1,500 solicitudes por lotes por minuto.

2. ¿Cómo integro la API de validación de email?

La API de validación usa llamadas REST estándar con respuestas JSON. Hay SDK oficiales para Python, Node.js, Go y PHP. La mayoría de las integraciones de la API se completan en menos de 30 minutos. El MCP Server y Agent Skills no requieren código — instala una vez y la API de validación de email gratis funciona en cualquier cliente de IA compatible.

3. ¿Cuánto cuesta la API de validación de email?

El plan Starter cuesta $20 por 20,000 créditos a $0.001 por email — sin cuotas mensuales, solo pagas lo que usas. El precio por volumen baja hasta $0.00035 por email con 1M de créditos. El nivel gratis de la API de validación de email ofrece 20 créditos gratis cada día que inicias sesión, hasta 600 al mes, sin tarjeta de crédito.

4. ¿Qué incluye cada respuesta de la API de validación?

Cada respuesta de la API incluye el estado de validación (deliverable, undeliverable, risky o unknown), una puntuación de calidad de 0–100, un nivel de riesgo y códigos de motivo. También se incluyen el indicador de email desechable, el de cuenta de rol, la detección catch-all y sugerencias de corrección tipográfica.

5. ¿Es segura la API de validación?

Todas las solicitudes a la API usan HTTPS. La autenticación por API key es obligatoria en cada llamada, y la lista blanca de IP está disponible para más seguridad. BillionVerify cumple plenamente con GDPR y CCPA, con eliminación automática de datos tras el procesamiento.

6. ¿Cómo usan los agentes de IA y los LLM esta API de validación?

Los agentes de IA se conectan a través del MCP Server (lenguaje natural en Claude y Cursor), Agent Skills preconstruidos (instalación con un clic para Claude y Manus) o llamadas REST directas desde LangChain, CrewAI o cualquier SDK de Anthropic u OpenAI. Todas las vías llegan a la misma API de validación de email y devuelven el mismo JSON estructurado — sin transformar la respuesta.

7. ¿Cuál es la diferencia entre una API de validación de correo y una API de verificación de correo?

Una API de validación de email y una API de verificación de email suelen nombrar el mismo endpoint: uno que comprueba si una dirección es real y entregable. BillionVerify ejecuta comprobaciones a nivel SMTP, confirmando que el buzón existe en el servidor receptor, en lugar de limitarse a DNS o a validación de sintaxis. El único endpoint /verify devuelve estado, puntuación de calidad, indicador desechable, indicador de cuenta de rol y detección catch-all en una sola respuesta JSON.

API de Validación de Email

Obtén tu clave API

Un endpoint para cada tipo de validación. MCP Server y Agent Skills incluidos. El nivel gratis de la API de validación de email te da 20 créditos cada día que inicias sesión, hasta 600 al mes, sin tarjeta de crédito.

600 créditos gratis al mes · Integración nativa con MCP Server · Sin tarjeta de crédito requerida

99.9%
Precisión
Real-time
Velocidad de la API
$0.00014
Por email
600/mo
Gratis para siempre