API V2
La versión 2 de la API Captain Verify ya está disponible e incluye nuevas funciones. Si está buscando una forma confiable de verificar la validez de sus correos electrónicos, puede integrar la API de verificación de correo electrónico de Captain Verify en sus propias aplicaciones.
Clave API
Se requiere una cuenta para generar la clave para la API, esto es lo que le dará acceso al servicio.
Límites de API
La API está limitada a un máximo de 2 conexiones simultáneas y 50 comprobaciones por minuto. Al integrar la API, asegúrese de que su aplicación no exceda este límite.
La solicitud
Para realizar una solicitud a la API, simplemente llame al protocolo GET en esta URL:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Reemplace john.doe@gmail.com con su correo electrónico para verificar.
La respuesta
Se devolverá una tabla json con estas variables:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok4all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
| Variables | valor posible |
|---|---|
| credits | Créditos disponibles en su cuenta. |
| result | valid, invalid, risky, unknown El estado del correo electrónico. si se han agotado todos sus créditos, siempre se devolverá el estado desconocido, para no bloquear su aplicación. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Comprender el resultado de una auditoría. |
| free | true, false Si el proveedor de correo electrónico es gratuito, por ejemplo, Gmail.com. |
| role | true, false Si el usuario de correo electrónico tiene un rol, por ejemplo: support@example.com. |
| disposable | true, false El correo electrónico es válido, pero desechable después de un corto tiempo ya no será posible contactar al usuario. |
| ok4all | true, false Ok para todos: el servidor de correo remoto acepta todos los correos electrónicos (catch-all). |
| protected | true, false El correo electrónico está protegido por una solución antispam patentada |
| mailboxfull | true, false La dirección de correo electrónico está llena. Ya no puede recibir correo |
| did_you_mean | default : null Si, por ejemplo, el correo electrónico es john.doe@gmil.com, la API le enviará una propuesta como john.doe@gmail.com. |
| El correo electrónico que desea verificar. | |
| email_normalized | El correo electrónico se ha normalizado, eliminando etiquetas para gmail... support+test@gmail.com será support@gmail.com. |
| success | true, false Si la autenticación falla, sus créditos están agotados. |
| message | default : null Cuando el éxito sea falso, se enviará un mensaje de error. |
¿Por qué integrar una API de verificación de correos electrónicos?
Una base de contactos se degrada rápido. Direcciones escritas con un error tipográfico, correos desechables creados para pasar un formulario, buzones abandonados y luego cerrados: cada dirección inválida que entra en su sistema termina en hard bounce. Y los bounces salen caros. Inflan sus facturas de envío, distorsionan sus estadísticas de campaña y, sobre todo, degradan su reputación del remitente ante los proveedores de correo electrónico.
La limpieza manual siempre llega demasiado tarde. Una vez registrada la dirección en su CRM, ya ha contaminado sus segmentos, sus puntuaciones de leads y sus exportaciones. La verificación programática invierte la lógica: la dirección se controla en el momento preciso de la recolección, antes de ser almacenada.
Ese es exactamente el papel de una API de verificación de correos electrónicos. Usted envía una dirección, recibe un veredicto que su código puede explotar y decide qué hacer con ella: aceptarla, rechazarla o pedir una corrección al usuario. Todo sin intervención humana.
Casos de uso de la API
Validación en tiempo real durante el registro
Conecte la API a sus formularios de registro, de descarga o de solicitud de presupuesto. Los errores tipográficos (gmail convertido en gmial), los correos desechables y las direcciones inexistentes se detectan antes del registro. El usuario puede corregir inmediatamente lo que escribió, y solo entran direcciones válidas en su base.
Limpieza masiva antes de una campaña
Una lista que duerme unos meses acumula direcciones muertas. Antes de un envío importante, pásela por la API para descartar las direcciones inválidas o de riesgo. Resultado: una tasa de rebote controlada, estadísticas de campaña fiables y un presupuesto de envío concentrado en destinatarios que existen realmente.
Un CRM más fiable
Conecte la verificación a sus puntos de entrada de datos: importaciones, integraciones, capturas del equipo comercial. Cada contacto queda calificado desde su creación, con un estado claro sobre la validez de su correo electrónico. Sus equipos trabajan con fichas limpias y su scoring de leads se apoya en datos reales.
Protección de la reputación del remitente
Los proveedores de correo electrónico vigilan sus hard bounces y sus envíos a spam traps. Demasiados incidentes, y sus correos legítimos terminan en spam. Al filtrar las direcciones peligrosas antes de cada envío, la API protege su reputación del remitente y, por lo tanto, la entregabilidad de todas sus comunicaciones.
Preguntas frecuentes sobre la API
¿Qué verifica exactamente la API?
Se encadenan varios controles: sintaxis de la dirección, existencia del dominio y de sus registros MX, y luego una prueba SMTP para comprobar que el buzón acepta mensajes. La API también detecta los correos desechables y las direcciones de rol (contact@, info@). La respuesta se devuelve en formato JSON.
¿La API funciona en tiempo real?
Sí. Cada solicitud desencadena una verificación inmediata y devuelve el resultado al instante, lo que permite integrarla directamente en un formulario o en un proceso de registro. Para grandes volúmenes, la verificación de archivos completos sigue disponible desde su cuenta.
¿Cuánto cuesta?
La facturación funciona por créditos: una verificación consume un crédito, sin suscripción obligatoria. Los créditos comprados sirven tanto para la API como para la verificación de archivos. El detalle de los volúmenes y de los precios decrecientes está disponible en la página de nuestras tarifas.