API-Dokumentation

E-Mail-Verifizierungs-API

Einfache, schnelle und präzise E-Mail-Verifizierung für Ihre Anwendungen

Übersicht

Email Verifier ist eine API, die Unternehmen und Entwicklern dabei hilft, Wegwerf-E-Mail-Adressen (temporär) und Domains in Echtzeit zu erkennen und zu verhindern. Indem sichergestellt wird, dass nur legitime Benutzer sich registrieren oder mit Ihrer Plattform interagieren können, schützt Email Verifier Ihr Unternehmen vor Betrug, verbessert die Datenintegrität und senkt die Betriebskosten.

Was kann Email Verifier?

  • E-Mails & Domains validieren – Überprüfen Sie sofort, ob eine E-Mail-Adresse oder Domain gültig, aktiv und vertrauenswürdig ist.
  • Wegwerf- & Spam-Quellen erkennen – Blockieren Sie temporäre, Wegwerf- oder bekannte Spam-E-Mail-Adressen, bevor sie in Ihr System gelangen.
  • Domain-Reputation prüfen – Identifizieren Sie öffentliche E-Mail-Anbieter, Relays und verdächtige Domains.
  • Echtzeit-Verifizierung – Erhalten Sie sofortige Ergebnisse während der Benutzerregistrierung oder Formularübermittlung.

Warum Email Verifier verwenden?

  • Plattform-Missbrauch verhindern – Stoppen Sie Testphasen-Ausnutzung, reduzieren Sie Spam und pflegen Sie authentische Benutzer-Communities.
  • Datenqualität verbessern – Stellen Sie sicher, dass Ihre Marketing-, Analyse- und Support-Bemühungen echte Benutzer erreichen, nicht gefälschte Konten.
  • Kosten reduzieren – Sparen Sie Ressourcen, indem Sie gefälschte Anmeldungen verhindern, die E-Mail-Zustellbarkeit verbessern und Betrug minimieren.
  • Einfache Integration – Einfache REST-API, klare Dokumentation und unkompliziertes Setup machen die Integration schnell und entwicklerfreundlich.
  • Skalierbar & Zuverlässig – Aufgebaut auf moderner Infrastruktur für hohe Leistung, Zuverlässigkeit und globale Reichweite.

Schnellstart

Bereit, Ihre Plattform zu schützen und Ihre Datenqualität zu verbessern? Folgen Sie diesen Schritten, um Ihren API-Schlüssel zu erhalten und Ihren ersten API-Aufruf zu tätigen:

Schritt 1: Konto erstellen

  1. Besuchen Sie die Email Verifier Console.
  2. Füllen Sie Ihre Daten aus und schließen Sie den Registrierungsprozess ab.

Nach der Kontoerstellung werden Sie automatisch zur Email Verifier Console weitergeleitet.

Schritt 2: Auf Ihre API-Schlüssel zugreifen

  1. Navigieren Sie in der Console im linken Menü zu Erste Schritte → API-Schlüssel.
  2. Kopieren Sie Ihren API-Schlüssel aus der angezeigten Liste oder generieren Sie bei Bedarf einen neuen.

⚠️ Wichtig: Halten Sie Ihren API-Schlüssel sicher! Er gewährt Zugriff auf Ihr Email Verifier-Konto und sollte nicht öffentlich geteilt werden.

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung über ein Bearer-Token. Fügen Sie Ihren API-Schlüssel im Authorization-Header hinzu:

Authorization: Bearer IHR_API_SCHLÜSSEL

Basis-URL

https://api.getemailverifier.com

API-Endpunkte

Email Verifier bietet zwei Hauptendpunkte zum Überprüfen von E-Mails und Domains.

E-Mail prüfen

Überprüft, ob eine E-Mail-Adresse von einem Wegwerf-E-Mail-Dienst stammt. Liefert umfassende Analysen einschließlich Wegwerf-Status, Erkennung von Rollenkonten, Identifizierung öffentlicher Domains und Alias-Erkennung.

POST /v1/email/check

Request-Header

HeaderWertErforderlich
AuthorizationBearer IHR_API_SCHLÜSSELJa
Content-Typeapplication/jsonJa

Request-Body

ParameterTypErforderlichBeschreibung
valuestringJaDie zu überprüfende E-Mail-Adresse

Beispiel-Anfrage

curl --request POST \
  --url https://api.getemailverifier.com/v1/email/check \
  --header 'Authorization: Bearer IHR_API_SCHLÜSSEL' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "benutzer@beispiel.de"
  }'

Antwortfelder

FeldTypBeschreibung
timestringZeitstempel im ISO 8601 Format
successbooleanOb die Anfrage erfolgreich war
data.blockbooleanEmpfohlene Aktion: true, wenn E-Mail blockiert werden sollte
data.disposablebooleanTrue, wenn von einem Wegwerf-E-Mail-Dienst
data.validbooleanTrue, wenn E-Mail-Format gültig ist
data.role_accountbooleanTrue, wenn Rollenkonto (admin, support, etc.)
data.public_domainbooleanTrue, wenn öffentlicher Anbieter (Gmail, Yahoo, etc.)
data.aliasbooleanTrue, wenn Aliasing erkannt (Gmail-Punkte, Plus-Adressierung)
data.details.inputstringUrsprüngliche Eingabe
data.details.normalizedstring | nullNormalisierte/kanonische Form der E-Mail
data.details.handlestring | nullNormalisierter Handle/lokaler Teil (vor @)
data.details.domainstring | nullDomain-Teil (nach @)
data.warningstring | nullZusätzliche Informationen oder Warnungen
processing_durationinteger | nullVerarbeitungszeit in Millisekunden
errorobject | nullFehlerinformationen, falls Anfrage fehlgeschlagen

Beispiel-Antwort

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": true,
  "data": {
    "block": false,
    "disposable": false,
    "valid": true,
    "role_account": false,
    "public_domain": true,
    "alias": false,
    "details": {
      "input": "benutzer@beispiel.de",
      "normalized": "benutzer@beispiel.de",
      "handle": "benutzer",
      "domain": "beispiel.de"
    },
    "warning": null
  },
  "processing_duration": 7,
  "error": null
}

Domain prüfen

Überprüft, ob eine Domain von einem Wegwerf-E-Mail-Dienst stammt. Liefert Wegwerf-Status und Identifizierung öffentlicher Domains.

POST /v1/domain/check

Request-Body

ParameterTypErforderlichBeschreibung
valuestringJaDer zu überprüfende Domainname

Beispiel-Anfrage

curl --request POST \
  --url https://api.getemailverifier.com/v1/domain/check \
  --header 'Authorization: Bearer IHR_API_SCHLÜSSEL' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "beispiel.de"
  }'

Beispiel-Antwort

Die Antwortstruktur ist identisch mit dem E-Mail-Prüf-Endpunkt. Für Domain-Prüfungen sind die Felder normalized und handle in details null.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": true,
  "data": {
    "block": false,
    "disposable": false,
    "valid": true,
    "role_account": false,
    "public_domain": false,
    "alias": false,
    "details": {
      "input": "beispiel.de",
      "normalized": null,
      "handle": null,
      "domain": "beispiel.de"
    },
    "warning": null
  },
  "processing_duration": 5,
  "error": null
}

Fehler-Antworten

Die API verwendet Standard-HTTP-Statuscodes, um Erfolg oder Fehler anzuzeigen. Alle Fehlerantworten enthalten ein Fehlerobjekt mit einem Code und einer Beschreibung.

400 Ungültige Anfrage

Ungültige Anfrage - Wert muss angegeben und gültig sein.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "BAD_REQUEST",
    "description": "Ungültige Anfrage - Wert muss angegeben und gültig sein"
  }
}

401 Nicht autorisiert

Fehlende oder ungültige API-Schlüssel-Authentifizierung.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "UNAUTHORIZED",
    "description": "Fehlender oder ungültiger API-Schlüssel"
  }
}

429 Zu viele Anfragen

Ratenlimit überschritten. Bitte versuchen Sie es später erneut.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "description": "Ratenlimit überschritten. Bitte versuchen Sie es später erneut."
  }
}

500 Interner Serverfehler

Interner Serverfehler während der Verarbeitung aufgetreten.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "INTERNAL_ERROR",
    "description": "Interner Serverfehler aufgetreten"
  }
}

Code-Beispiele

Hier sind Beispiele, wie Sie die Email Verifier API in verschiedenen Programmiersprachen verwenden können.

JavaScript / Node.js

const response = await fetch('https://api.getemailverifier.com/v1/email/check', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer IHR_API_SCHLÜSSEL',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    value: 'benutzer@beispiel.de'
  })
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.getemailverifier.com/v1/email/check"
headers = {
    "Authorization": "Bearer IHR_API_SCHLÜSSEL",
    "Content-Type": "application/json"
}
data = {
    "value": "benutzer@beispiel.de"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

PHP

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getemailverifier.com/v1/email/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer IHR_API_SCHLÜSSEL",
    "Content-Type: application/json"
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "value" => "benutzer@beispiel.de"
  ])
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.getemailverifier.com/v1/email/check"

    payload := map[string]string{
        "value": "benutzer@beispiel.de",
    }
    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer IHR_API_SCHLÜSSEL")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

Support

Brauchen Sie Hilfe? Wir sind für Sie da.