Anleitung
Liste verifizieren
Verifizieren Sie bis zu 10.000 E-Mail-Adressen auf einmal, indem Sie sie einfügen oder eine CSV- oder XLSX-Datei hochladen, verfolgen Sie den Fortschritt, prüfen Sie die Ergebnisse und exportieren Sie sie als XLSX.
Eine Verifizierungsliste prüft viele Adressen in einem Durchgang, etwa bevor Sie Kontakte aus einem anderen System importieren oder eine Kampagne an eine alte Liste senden. Diese Anleitung zeigt, wie Sie eine Liste erstellen, ihren Fortschritt verfolgen, die Ergebnisse lesen und exportieren.
Voraussetzungen
- Eine Liste kann bis zu 10.000 Adressen enthalten. Teilen Sie größere Dateien auf mehrere Listen auf.
- Jede eindeutige Adresse kostet 5 Credits, berechnet beim Erstellen der Liste. Eine Liste mit 10.000 Adressen benötigt 50.000 Credits.
- Listen verwenden immer den Modus
full, der die Postfachprüfung umfasst. Siehe Schneller und vollständiger Modus. - Verwenden Sie für die API einen API-Schlüssel mit Full Access.
Liste erstellen
-
Lists öffnen. Öffnen Sie Email VerificationLists und wählen Sie Verify emails.
-
Liste benennen. Geben Sie unter Name etwas ein, das Sie später wiedererkennen, etwa
Newsletter import October. -
Adressen hinzufügen. Wählen Sie unter Input Method eine Option:
- Enter emails manually: Fügen Sie Adressen in Email Addresses ein, getrennt durch Kommas, Semikolons oder Zeilenumbrüche.
- Upload a file: Wählen Sie eine
.csv- oder.xlsx-Datei unter 10 MB. Schreiben Sie in einer CSV-Datei eine Adresse pro Zeile oder trennen Sie die Adressen durch Kommas. Schreiben Sie sie in Excel in die erste Spalte, eine pro Zeile. Der Dialog zeigt, wie viele Adressen er gefunden hat.
-
Create wählen. Emailit berechnet die Credits und startet die Verifizierung.
Rufen Sie Liste erstellen mit einem Namen und einem Array von Adressen auf:
curl https://api.emailit.com/v2/email-verification-lists \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Newsletter import October",
"emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
}'Die Antwort 201 beschreibt die neue Liste:
{
"object": "email_verification_list",
"id": "evl_3Rt8Wq5Lm2Kx",
"name": "Newsletter import October",
"status": "processing",
"stats": {
"total_emails": 3,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 3
},
"created_at": "2026-10-01T11:02:37Z",
"updated_at": "2026-10-01T11:02:37Z",
"valid_emails_count": 3,
"unique_emails_count": 3,
"invalid_emails_count": 0,
"dispatched_jobs": 3
}| Status | Wann |
|---|---|
201 |
Die Liste wurde erstellt, und die Verifizierung hat begonnen. |
400 |
name fehlt, emails ist leer oder enthält mehr als 10.000 Einträge, oder keiner davon sieht wie eine E-Mail-Adresse aus. |
402 |
Der Workspace hat nicht genug Credits für jede eindeutige Adresse. |
Vor der Berechnung bereinigt Emailit die Eingabe: Jede Adresse wird in Kleinbuchstaben umgewandelt, Duplikate werden entfernt und Einträge ohne @ verworfen. Berechnet werden nur die verbleibenden eindeutigen Adressen. Kann die Liste nicht gestartet werden, werden die Credits erstattet.
Fortschritt verfolgen
Der Status der Liste durchläuft diese Stufen:
| Status | Bedeutung |
|---|---|
pending |
Erstellt, wartet auf den Start. |
processing |
Adressen werden verifiziert. |
completed |
Jede Adresse hat ein Ergebnis. |
failed |
Die Liste konnte nicht verarbeitet werden. |
canceled |
Die Verifizierung wurde gestoppt. |
Unter Email VerificationLists zeigt die Spalte Statistics für jede Liste die Zahlen Total, Pending, Successful und Failed. Die Spalte Expiring zeigt, wie viele Tage bleiben, bis die Liste gelöscht wird.
Per API rufen Sie Liste abrufen auf und lesen status und stats. Um nicht regelmäßig abfragen zu müssen, abonnieren Sie mit einem Webhook das Event email_verification_list.updated, das ausgelöst wird, wenn die Liste fertig ist. Jede Adresse löst außerdem email_verification.updated aus, sobald ihr Ergebnis vorliegt.
Ergebnisse prüfen
Wählen Sie in der Weboberfläche eine Liste, um sie zu öffnen. Die Seite zeigt:
- Karten mit Created, Status, Total Emails, Pending, Successful und Failed,
- Diagramme für Verification Status Progress, Verification Results Breakdown und Risk Levels,
- eine Tabelle aller Adressen mit Status, Ergebnis, Risiko und Score.
Per API rufen Sie Ergebnisse auflisten auf. Filtern Sie nach result oder status und blättern Sie mit page und limit (Standard 50):
curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
--data-urlencode "result=invalid" \
--data-urlencode "limit=100"Jedes Element enthält id, email, status, result, score, risk und mx_records der Adresse. Verifizierungsergebnisse erklärt jeden Wert und was Sie damit tun.
Ergebnisse exportieren
Sobald eine Liste completed ist, können Sie alle Ergebnisse als Excel-Datei herunterladen.
Öffnen Sie die Liste und wählen Sie Export Results. Emailit lädt eine .xlsx-Datei herunter, die nach der ID der Liste benannt ist.
Rufen Sie Ergebnisse exportieren auf und speichern Sie die Antwort:
curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-o results.xlsxDer Export einer nicht abgeschlossenen Liste gibt 400 zurück.
Die Datei enthält eine Zeile pro Adresse mit Status, Ergebnis, Score und Risiko, jeder Einzelprüfung (gültige Syntax, Wegwerf-Adresse, Rollenadresse, Postfach voll, zustellbar, deaktiviert, Freemail, zufällige Zeichenfolge, Catch-all, SMTP-Verbindung, MX-Einträge), den Adressbestandteilen, dem Domainalter, dem Vorschlag did_you_mean und den MX-Einträgen. Die Ergebnisse sind farblich markiert, damit Sie sie schnell überblicken.
Ergebnisse nutzen
- Entfernen Sie Adressen mit dem Ergebnis
invalid,disabledoderdisposable, bevor Sie importieren oder senden. - Prüfen Sie Adressen mit
inbox_full,roleundunknown. Behalten Sie sie, wenn Sie einen Grund dafür haben, aber beobachten Sie ihre Bounces. - Importieren Sie den Rest in Ihre Kontakte oder eine Kontaktliste.
Was bei jedem Ergebnis zu tun ist, steht unter Empfohlene Aktionen.