API de verificación de correos
Los rebotes meten su dominio en listas negras. Compruebe cada dirección antes de que entre en una campaña — desde su CRM, su formulario de registro o un script — con una sola llamada HTTP.
Qué comprueba una llamada
Cada dirección pasa por la misma cadena que la app usa para sus propias campañas:
- Reglas de sintaxis y longitud (RFC 5321).
- Dominios desechables y de correo temporal según una lista integrada de proveedores habituales.
- Cuentas de rol (info@, sales@, support@) que rara vez responden al correo frío.
- Registros MX: ¿acepta correo el dominio?
- Comprobación del buzón y de accept-all por SMTP cuando nuestro servidor puede conectar con el servidor de correo del destinatario; si no, el motivo smtp_unreachable indica que el buzón no se comprobó.
Tres grupos, no una puntuación que tenga que interpretar
La respuesta es válida, arriesgada o no válida, con códigos de motivo. Las campañas nunca envían a direcciones verificadas como no válidas; las arriesgadas (servidores accept-all, dominios desechables, comprobaciones dudosas o interrumpidas) las decide usted. Un resultado válido con el motivo smtp_unreachable significa que el dominio acepta correo pero el buzón no se comprobó; catch_all solo es true cuando la comprobación de accept-all se ejecutó.
curl -X POST https://coldleads.app/api/v1/verify \
-H "x-api-key: sk_…" -H "Content-Type: application/json" \
-d '{"email":"jane.doe@example.com"}'
# respuestas ilustrativas (example.com está reservado para documentación)
# buzón sin comprobar (sin conexión SMTP con el servidor de correo)
{ "status": "valid", "score": 75, "reasons": ["smtp_unreachable"], "mx": "mx.example.com", "catch_all": false }
# buzón confirmado por SMTP
{ "status": "valid", "score": 97, "reasons": ["ok"], "mx": "mx.example.com", "catch_all": false }Listas y precios
Endpoint masivo: hasta 5 000 direcciones por tarea, 5 tareas en paralelo, resultados en JSON (la exportación a CSV está en la aplicación web). 120 peticiones por minuto por clave. 1 crédito por dirección; el plan Business (99 € / $99 al mes) incluye 10.000 créditos y la API; los paquetes extra cuestan 5 € / $5 por 1 000.
Los resultados se guardan en caché 30 días, así que volver a comprobar la misma lista es rápido; cada comprobación cuesta igualmente 1 crédito.
Facturación que controla desde la app
Cambie el plan en Ajustes y elija cuándo empieza — hoy (los días no usados se abonan y empieza un nuevo mes de facturación) o en la próxima renovación. Actualice la tarjeta con un clic, cancele cuando quiera: una suscripción cancelada sigue funcionando hasta el final del periodo pagado. Sin panel de Stripe, sin correos a soporte.
Preguntas frecuentes
¿Hay una especificación OpenAPI?
Sí — /api/v1/openapi.json (OpenAPI 3.1). La referencia con ejemplos está en /api/v1.
¿Qué plan incluye la API?
Business. Solo y Team pueden verificar listas en la aplicación web con sus créditos mensuales.
¿Dónde se realizan las comprobaciones?
En los servidores de Cold Leads, nunca desde su dominio. Las direcciones solo llegan a nuestros proveedores de alojamiento y, durante la comprobación del buzón, al servidor de correo del destinatario; los resultados se guardan en caché 30 días.
¿Puedo encontrar una dirección por nombre y empresa?
Sí — POST /api/v1/find recibe un nombre y un dominio, prueba patrones de dirección habituales y devuelve la dirección más probable con una puntuación de confianza y los candidatos comprobados. El método es verified solo si la comprobación del buzón confirmó la dirección; si no, pattern. 1 crédito.