E-Mail-Verifizierungs-API
Bounces bringen Ihre Domain auf schwarze Listen. Prüfen Sie jede Adresse, bevor sie in eine Kampagne kommt — aus Ihrem CRM, Anmeldeformular oder einem Skript — mit einem HTTP-Aufruf.
Was ein Aufruf prüft
Jede Adresse durchläuft dieselbe Pipeline, die die App für ihre eigenen Kampagnen nutzt:
- Syntax- und Längenregeln (RFC 5321).
- Wegwerf- und temporäre Mail-Domains aus einer eingebauten Liste gängiger Anbieter.
- Rollenkonten (info@, sales@, support@), die auf kalte E-Mails selten antworten.
- MX-Einträge: Nimmt die Domain überhaupt E-Mails an?
- Postfach- und Accept-all-Prüfung per SMTP, wenn unser Server den Mailserver des Empfängers erreicht; sonst zeigt der Grund smtp_unreachable, dass das Postfach nicht geprüft wurde.
Drei Bereiche statt einer Punktzahl, die Sie interpretieren müssen
Die Antwort lautet gültig, riskant oder ungültig mit Grundcodes. An als ungültig geprüfte Adressen senden Kampagnen nie; riskante (Accept-all-Server, Wegwerf-Domains, unklare oder abgebrochene Prüfungen) sind Ihre Entscheidung. Ein gültiges Ergebnis mit dem Grund smtp_unreachable heißt: Die Domain nimmt E-Mails an, das Postfach selbst wurde nicht geprüft; catch_all ist nur dann true, wenn die Accept-all-Prüfung gelaufen ist.
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"}'
# beispielhafte Antworten (example.com ist für Dokumentation reserviert)
# Postfach nicht geprüft (keine SMTP-Verbindung zum Mailserver)
{ "status": "valid", "score": 75, "reasons": ["smtp_unreachable"], "mx": "mx.example.com", "catch_all": false }
# Postfach per SMTP bestätigt
{ "status": "valid", "score": 97, "reasons": ["ok"], "mx": "mx.example.com", "catch_all": false }Listen und Preise
Bulk-Endpunkt: bis zu 5 000 Adressen pro Auftrag, 5 parallele Aufträge, Ergebnisse als JSON (CSV-Export in der Web-App). 120 Anfragen pro Minute und Schlüssel. 1 Credit pro Adresse; der Business-Tarif (99 €/Monat) enthält 10.000 Credits und die API, zusätzliche Pakete kosten 5 € pro 1 000.
Ergebnisse werden 30 Tage zwischengespeichert, eine erneute Prüfung derselben Liste geht also schnell; jede Prüfung kostet aber 1 Credit.
Abrechnung, die Sie aus der App steuern
Ändern Sie den Tarif in den Einstellungen und wählen Sie, wann er startet — heute (nicht genutzte Tage werden gutgeschrieben und ein neuer Abrechnungsmonat beginnt) oder zur nächsten Verlängerung. Karte mit einem Klick aktualisieren, jederzeit kündigen: Ein gekündigtes Abonnement läuft bis zum Ende des bezahlten Zeitraums weiter. Kein Stripe-Dashboard, keine E-Mails an den Support.
FAQ
Gibt es eine OpenAPI-Spezifikation?
Ja — /api/v1/openapi.json (OpenAPI 3.1). Die Referenz mit Beispielen liegt unter /api/v1.
Welcher Tarif enthält die API?
Business. Solo und Team können Listen in der Web-App mit ihren monatlichen Credits prüfen.
Wo werden die Prüfungen durchgeführt?
Auf den Servern von Cold Leads, nie von Ihrer Domain aus. Adressen erhalten nur unsere Hosting-Anbieter und bei einer Postfachprüfung der Mailserver des Empfängers; Ergebnisse werden 30 Tage zwischengespeichert.
Kann ich eine Adresse nach Name und Firma finden?
Ja — POST /api/v1/find nimmt einen Namen und eine Domain entgegen, probiert gängige Adressmuster und liefert die wahrscheinlichste Adresse mit Konfidenzwert und den geprüften Kandidaten. Die Methode ist nur dann verified, wenn die Postfachprüfung die Adresse bestätigt hat, sonst pattern. 1 Credit.