API V2
Ab sofort ist die Version 2.0 der Captain Verify API mit neuen Funktionen verfügbar. Integrieren Sie die API von Captain Verify in Ihre Anwendungen und überprüfen Sie schnell und zuverlässig die Gültigkeit Ihrer E-Mail-Adressen. Wir empfehlen eine nachgelagerte Verwendung der API, da die Verifizierung bis zu 1 Minute in Anspruch nehmen kann.
API-Schlüssel
Zum Generieren des API-Schlüssels ist ein Benutzerkonto erforderlich.
API – Nutzungslimits
Die API ist auf maximal 2 gleichzeitige Verbindungen und 50 Verifizierungen pro Minute beschränkt. Bitte stellen Sie bei der Integration der API sicher, dass Ihre Anwendung die Anforderungen erfüllt.
Anfrage
Rufen Sie einfach das GET-Protokoll unter der folgenden URL auf, um Anfragen an die API zu senden:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Ersetzen Sie john.doe@gmail.com durch Ihre E-Mail-Adresse, um diese zu verifizieren.
Antwort
Sie erhalten eine json-Tabelle mit den folgenden Variablen:
{
"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
}
| Variablen | Möglicher Wert |
|---|---|
| credits | Auf Ihrem Konto verfügbare Credits. |
| result | valid, invalid, risky, unknown Status der E-Mail-Adresse. Wenn Ihre Credits aufgebraucht sind, wird der Status "unbekannt" angezeigt. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Das bedeuten die Ergebnisse der Verifizierung. |
| free | true, false Für kostenlose E-Mail-Anbieter, z. B. Gmail.com. |
| role | true, false Für E-Mail-Benutzer mit zugewiesener Funktion, z. B. support@example.com. |
| disposable | true, false Diese Wegwerf-E-Mail-Adresse ist zwar gültig, erlaubt aber nach kurzer Zeit keinen Kontakt mehr zum Benutzer. |
| ok4all | true, false Alles OK: Der Mailserver nimmt alle E-Mails an (catch-all). |
| protected | true, false Diese E-Mail-Adresse ist durch einen proprietären Spamfilter geschützt. |
| mailboxfull | true, false Der Posteingang dieser E-Mail-Adresse ist voll und kann keine Nachrichten mehr empfangen. |
| did_you_mean | default : null Wenn diese E-Mail-Adresse beispielsweise john.doe@gmil.com lautet, sendet Ihnen die API einen Vorschlag, z. B. john.doe@gmail.com. |
| Zu verifizierende E-Mail-Adresse. | |
| email_normalized | Die E-Mail-Adresse wurde standardisiert, Tags für Google Mail wurden entfernt ... support+test@gmail.com wird zu support@gmail.com. |
| success | true, false Authentifizierung fehlgeschlagen, Ihre Credits sind aufgebraucht. |
| message | default : null Bei falschen Treffern wird eine Fehlermeldung gesendet. |
Warum eine API zur E-Mail-Verifizierung integrieren?
Eine Kontaktdatenbank verschlechtert sich schnell. Adressen mit Tippfehlern, Wegwerf-E-Mail-Adressen, die nur zum Ausfüllen eines Formulars erstellt wurden, aufgegebene und später geschlossene Postfächer: Jede ungültige Adresse, die in Ihr System gelangt, endet als Hard Bounce. Und Bounces sind teuer. Sie blähen Ihre Versandrechnungen auf, verfälschen Ihre Kampagnenstatistiken und schaden vor allem Ihrer Absender-Reputation bei den E-Mail-Providern.
Die manuelle Bereinigung kommt immer zu spät. Sobald die Adresse in Ihrem CRM gespeichert ist, hat sie bereits Ihre Segmente, Ihre Lead-Scores und Ihre Exporte verunreinigt. Die programmatische Verifizierung kehrt die Logik um: Die Adresse wird genau im Moment der Erfassung geprüft, bevor sie gespeichert wird.
Genau das ist die Aufgabe einer API zur E-Mail-Verifizierung. Sie senden eine Adresse, Sie erhalten ein Ergebnis, das Ihr Code direkt verarbeiten kann, und Sie entscheiden, was damit geschieht: annehmen, ablehnen oder den Nutzer um eine Korrektur bitten. Das alles ohne menschliches Eingreifen.
Anwendungsfälle der API
Validierung in Echtzeit bei der Registrierung
Binden Sie die API in Ihre Formulare für Registrierung, Download oder Angebotsanfragen ein. Tippfehler (aus gmail wird gmial), Wegwerf-E-Mail-Adressen und nicht existierende Adressen werden vor der Speicherung erkannt. Der Nutzer kann seine Eingabe sofort korrigieren, und nur gültige Adressen gelangen in Ihre Datenbank.
Massenbereinigung vor einer Kampagne
Eine Liste, die einige Monate ungenutzt bleibt, sammelt tote Adressen an. Lassen Sie sie vor einem wichtigen Versand durch die API laufen, um ungültige oder riskante Adressen auszusortieren. Das Ergebnis: eine kontrollierte Bounce-Rate, zuverlässige Kampagnenstatistiken und ein Versandbudget, das sich auf Empfänger konzentriert, die tatsächlich existieren.
Zuverlässige Daten im CRM
Verbinden Sie die Verifizierung mit Ihren Dateneingangspunkten: Importe, Integrationen, Eingaben durch den Vertrieb. Jeder Kontakt wird bereits bei seiner Erstellung qualifiziert, mit einem klaren Status zur Gültigkeit seiner E-Mail-Adresse. Ihre Teams arbeiten mit sauberen Datensätzen, und Ihr Lead-Scoring basiert auf realen Daten.
Schutz der Absender-Reputation
Die E-Mail-Provider überwachen Ihre Hard Bounces und Ihre Sendungen an Spam-Traps. Zu viele Vorfälle, und Ihre legitimen E-Mails landen im Spam-Ordner. Indem die API gefährliche Adressen vor jedem Versand herausfiltert, schützt sie Ihre Absender-Reputation und damit die Zustellbarkeit Ihrer gesamten Kommunikation.
Häufige Fragen zur API
Was prüft die API genau?
Mehrere Prüfungen laufen nacheinander ab: Syntax der Adresse, Existenz der Domain und ihrer MX-Einträge, anschließend ein SMTP-Test, um zu prüfen, ob das Postfach Nachrichten annimmt. Die API erkennt auch Wegwerf-E-Mail-Adressen und Rollen-Adressen (contact@, info@). Die Antwort wird im JSON-Format zurückgegeben.
Funktioniert die API in Echtzeit?
Ja. Jede Anfrage löst eine sofortige Verifizierung aus und liefert das Ergebnis unmittelbar zurück, sodass sie sich direkt in ein Formular oder einen Registrierungsprozess integrieren lässt. Für große Volumen steht die Verifizierung kompletter Dateien weiterhin über Ihr Konto zur Verfügung.
Was kostet das?
Die Abrechnung erfolgt über Credits: Eine Verifizierung verbraucht einen Credit, ohne verpflichtendes Abonnement. Die gekauften Credits gelten sowohl für die API als auch für die Dateiverifizierung. Die Details zu Volumen und Staffelpreisen finden Sie auf der Seite mit unseren Preisen.