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

API de verificación de email

API de verificación de email en tiempo real por HTTP con comprobaciones SMTP completas del buzón — la API precisa para entregabilidad, no validación solo de formato.

Consola de la API de verificación de email con solicitud POST autenticada 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 verificación de email en tiempo real devuelve una respuesta 200 OK tras una sonda SMTP

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

Cada tipo de verificación es accesible a través de la misma API REST de verificación de email.

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

Verificación de un solo email

POST /verify — una llamada a la API de verificación de email en tiempo real, con respuesta en menos de 3 s. Devuelve estado, entregabilidad, quality score y flags de riesgo en un solo objeto JSON.

Verificación por lotes

POST /verify/bulk — verifica hasta 50 direcciones por llamada a la API, de forma síncrona. Todos los resultados vuelven en una sola respuesta, con el mismo esquema que usa la API en tiempo real para una dirección.

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 por callback webhook cuando el trabajo termina.

SDKs oficiales

Bibliotecas cliente tipadas para la API de verificación en Python, Node.js, Go y PHP. Reintento automático ante fallos, manejo completo de errores y tipos de respuesta idénticos en todos los lenguajes.

Soporte de webhooks en la API de verificación

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

Webhooks de la API de verificación entregan un Evento de callback firmado junto a la insignia Firma

Entrega asíncrona

Crear webhooks

Registra endpoints HTTP para recibir resultados de la API en cuanto un trabajo o lote termina. Soporta payloads personalizados, reintento automático ante fallos y configuración por trabajo o global.

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

Historial de mensajes

Consultar mensajes

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

  • Consulta eventos por job ID o rango de fechas
  • Reenvía entregas fallidas o perdidas
  • Retención de eventos de 30 días

Dentro del endpoint

Qué demuestra la API de verificación de email en cada llamada

Una API de verificación de email solo es útil por la evidencia detrás de su campo de respuesta. Esta devuelve hechos a nivel de buzón, no una opinión de sintaxis disfrazada de veredicto.

Sintaxis y enrutamiento son las capas baratas, no la respuesta

Cada llamada a la API de verificación de email normaliza la dirección, comprueba la estructura y resuelve los registros MX del dominio. Esas dos capas son rápidas y no cuestan nada contra el destinatario, así que corren primero y descartan basura obvia antes de la etapa SMTP.

Una API solo de sintaxis se detiene aquí y llama válido al resultado. Esa es la brecha entre un endpoint de validación y una API de verificación de email gratis que continúa hasta el buzón.

SMTP es donde la API de verificación se gana el nombre

La API abre una conversación SMTP real con el servidor receptor y prueba la ruta del destinatario. No se envía un cuerpo de mensaje, no se hace clic en un enlace de confirmación y nada llega a la bandeja de la persona. Nuestra API de verificación de email gratis lee la respuesta del servidor lo bastante como para separar un destinatario aceptado de un rechazo permanente.

Esto es lo que la convierte en una API de verificación de email en tiempo real, y no en una consulta DNS con copy de marketing. La evidencia viene del sistema que realmente aceptará o rechazará tu correo.

Los flags de riesgo viajan con el estado, en la misma respuesta

Un solo objeto JSON de la API lleva el estado de entregabilidad, un quality score, un nivel de riesgo, códigos de motivo y los flags desechable, cuenta de rol, catch-all y webmail gratuito. Tu aplicación no necesita una segunda llamada para saber por qué un resultado se ve así.

Poner los flags junto al estado es deliberado. Una dirección de rol que acepta y un buzón personal que acepta son ambos deliverable, y solo tu producto sabe cuál pertenece a este flujo.

Las respuestas inconclusas siguen inconclusas

El greylisting, los aplazamientos del proveedor y los rate limits son normales a escala de API. La API de verificación de email gratis devuelve unknown en esos casos, en lugar de promoverlos a deliverable o degradarlos a inválido.

La lógica de reintento pertenece a tu código, no oculta dentro del endpoint. Una API que adivina en silencio elimina la única señal que necesitas para decidir si reintentar o enviar el registro a revisión.

Campos de respuesta

Asocia cada estado de la API de verificación a una decisión de la aplicación

La respuesta de la API está diseñada para evaluarse en un switch. Cada estado mapea a una acción, y los códigos de motivo explican los casos límite.

deliverable — continuar

La ruta del destinatario aceptó el sondeo cuando se ejecutó la llamada. Acepta el registro, escribe el contacto o encola el mensaje, sujeto a las reglas de consentimiento que aplique tu producto.

La API de verificación de email gratis devuelve el mismo campo de estado en el nivel gratis que en el volumen de pago, así que el comportamiento que pruebas con créditos gratis es el que publicas.

undeliverable — rechazar o pedir de nuevo

Un fallo permanente de la API significa que la dirección hará hard bounce. En un formulario de registro, vuelve a mostrar el campo con el código de motivo. En un trabajo en segundo plano, suprime el registro en lugar de borrar el valor original.

Nunca autocorrijas el dominio. Una API de verificación puede decirte que una dirección falla; no puede decirte qué dirección quería esa persona.

risky — aplica tu propia política

Risky significa que el buzón puede aceptar correo y a la vez llevar un flag que a tu producto le importe. Lee los códigos de motivo: un proveedor desechable en un registro de pago es un problema muy distinto de una dirección de rol en un formulario de soporte.

Codifica la política una vez, en el punto donde llamas a nuestra API de verificación de email gratis, para que cada superficie del producto trate el mismo flag de la misma manera.

unknown — reintenta, no descartes

El proveedor receptor dio a la API una respuesta que no demuestra nada. Encola la dirección para una llamada posterior en lugar de bloquear al usuario o escribir un falso negativo en tu base de datos.

La API de verificación de email en tiempo real usada en un flujo de registro debería degradarse con gracia aquí: deja pasar al usuario, verifica de nuevo de forma asíncrona y actúa sobre el segundo resultado.

Patrones de integración

Dónde llamar a la API de verificación de email en un sistema real

La mayoría de integraciones usan los mismos tres puntos de contacto. Acertar la ubicación de la llamada importa más que el SDK que elijas.

  1. 1

    En el momento de captura

    Llama a la API cuando se envía una dirección — registro, checkout, formulario de leads o actualización de perfil. Verificar mientras la persona sigue en la página es el único momento en que quien cometió el typo puede corregirlo, el argumento más fuerte para una llamada inline.

    Mantén la llamada no bloqueante más allá de un timeout corto. Una respuesta de la API de verificación de email gratis suele llegar en uno a tres segundos, pero tu formulario no debería fallar porque un proveedor receptor iba lento.

  2. 2

    Dentro del pipeline que ya mueve tus datos

    Los jobs de sync de CRM, workers de enrichment y pasos ETL son hogares naturales para esta API de verificación de email gratis. Añade la llamada donde ya fluyen los registros y guarda estado, flags y un timestamp checked-at como campos.

    Para archivos en lugar de registros sueltos, la API POST /verify/file acepta CSV o Excel y llama a tu webhook cuando el trabajo termina, así que el trabajo por lotes no necesita una conexión de larga duración.

  3. 3

    Dentro de agentes de IA y tools

    El MCP Server expone nuestra API de verificación de email gratis a Claude Desktop y Cursor en lenguaje natural, y Agent Skills la instala en plataformas de agentes con un clic. Ambas vías devuelven el mismo JSON estructurado que la API REST.

    Eso importa para la fiabilidad del agente: un modelo no tiene que parsear prosa, y la tool no puede afirmar que una dirección está bien cuando la API subyacente dijo unknown.

  4. 4

    Alrededor del envío mismo

    La frescura gana al volumen. Verifica destinatarios de alto valor cerca del envío en lugar de confiar en un estado escrito hace meses, y vuelve a verificar registros inactivos antes de que entren en una campaña.

    Para una lista completa, Verificación masiva de email ejecuta el mismo motor sobre un archivo para que no reconstruyas la lógica de lotes encima del endpoint en tiempo real.

Límites honestos

Cuatro cosas que la API de verificación de email no afirma

La respuesta de la API es fiable porque su alcance es estrecho. Cada uno de estos pertenece a otra herramienta o a otro equipo, no a una API de verificación.

No prueba identidad ni consentimiento

Un buzón que acepta no dice nada sobre quién lo controla, dónde trabaja o si aceptó ser contactado. Alias compartidos, direcciones reenviadas y enrichment obsoleto producen resultados deliverable de la API atados a la persona equivocada.

Usa datos first-party para la identidad y guarda el consentimiento en tu propio sistema de registro. Ninguna API de verificación puede aportar ni lo uno ni lo otro.

No garantiza la colocación en la bandeja

La aceptación SMTP describe la ruta del destinatario en el momento de la llamada. Que tu campaña llegue a la bandeja depende de reputación del remitente, autenticación, contenido e historial de quejas — factores del lado del remitente que la API nunca observa.

La verificación elimina fallos a nivel de dirección. La entregabilidad del mensaje en sí es un programa aparte, con métricas aparte.

Los dominios catch-all siguen inciertos

Un dominio catch-all acepta cada local-part, así que ninguna API de verificación de email gratis puede demostrar que una dirección adivinada exista allí. La API devuelve el flag precisamente para que tu código no tenga que inferirlo.

Envía los resultados catch-all a revisión en lugar de meterlos en deliverable, sobre todo en listas B2B construidas a partir de patrones de nombre.

Un resultado es una observación con marca de tiempo

Cada día se cierran buzones, se retiran alias y se migran dominios. La API informa lo que era cierto durante la llamada, y ese hecho envejece desde el segundo en que responde.

Guarda la hora checked-at junto al estado para que los sistemas aguas abajo decidan cuándo la evidencia es demasiado vieja para actuar.

Superficies relacionadas

Cómo se relaciona la API de verificación con el resto de la plataforma

El mismo motor se expone a través de varias superficies de API. Elegir la correcta suele depender de quién pregunta, no de la precisión.

Una dirección, a mano

Cuando una persona necesita inspeccionar un resultado en lugar de automatizar miles, el Verificador de email ejecuta el mismo pipeline SMTP en el navegador y muestra cada flag que devolvería la API.

Es la forma más rápida de comprobar una dirección antes de escribir código contra la API de verificación de email.

Un archivo entero de una vez

Cuando el trabajo es una lista y no un flujo, Limpieza de listas de email aplica las mismas reglas a cada fila y conserva los motivos en la exportación.

Archivos y llamadas a la API comparten un motor, así que una fila limpiada en lote y una dirección comprobada por la API de verificación no pueden contradecirse.

El encuadre que prioriza la validación

La API de validación de email describe el mismo endpoint para equipos que buscan validación en lugar de verificación, con los detalles de integración escritos desde ese ángulo.

El endpoint, el schema y la evidencia SMTP son idénticos; solo cambia el encuadre de la documentación.

Preguntas frecuentes

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

Los resultados en caché vuelven en menos de 200 ms. La verificación SMTP completa termina en 1–3 segundos de media, lo que permite usarla como API de verificación de email en tiempo real dentro de un formulario. Soporta hasta 6,000 solicitudes individuales por minuto y 1,500 de lote por minuto.

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

La API de verificación usa llamadas REST estándar con respuestas JSON. Hay SDKs oficiales para Python, Node.js, Go y PHP. La mayoría de integraciones se completan en menos de 30 minutos. El MCP Server y Agent Skills no requieren código: instálalos una vez y la API de verificación de email en tiempo real funciona en cualquier cliente de IA soportado.

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

El plan Starter es $20 por 20,000 créditos a $0.001 por email — sin cuotas mensuales, solo pagas por lo que usas. El precio por volumen baja hasta $0.00035 por email a 1M de créditos. El nivel gratis de la API de verificació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 verificación?

Cada respuesta incluye el estado de verificación (deliverable, undeliverable, risky o unknown), un quality score de 0–100, un nivel de riesgo y códigos de motivo. También se incluyen flag de email desechable, flag de cuenta de rol, detección catch-all y sugerencias de corrección de tipografías.

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

Todas las solicitudes a la API usan HTTPS. Se requiere autenticación por API key en cada llamada, y hay whitelist de IP para seguridad adicional. BillionVerify cumple plenamente GDPR y CCPA, con eliminación automática de datos tras el procesamiento.

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

Los agentes de IA se conectan por el MCP Server (lenguaje natural en Claude y Cursor), Agent Skills preconstruidos (instalación de 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 verificació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 email y una de verificación de email?

Una API de validación de email y una API de verificación de email suelen referirse al mismo endpoint: comprueba si una dirección es real y entregable. BillionVerify usa verificación a nivel SMTP, confirmando que el buzón existe en el servidor receptor, en lugar de solo validación DNS o de sintaxis. El único endpoint /verify devuelve estado, quality score, flag desechable, flag de cuenta de rol y detección catch-all en una sola respuesta JSON.

API de verificación de email

Obtén tu API key

Un endpoint para cada tipo de verificación. MCP Server y Agent Skills incluidos. El nivel gratis de la API de verificació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 de servidor MCP · Sin tarjeta de crédito

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