Massen-E-Mail-Checker API: Gmail, Outlook, Yahoo & mehr

Prüfen Sie, welche E-Mail-Adressen in Ihrer hochgeladenen Liste bei Gmail, Outlook, Yahoo, Mail.ru oder iCloud registriert sind. Verwendet task_type email_check und denselben Batch-Abfrageablauf wie andere Checker.

Erkennungsdatei hochladen — Beispiel:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./emails.txt"' \
--form 'task_type="email_check"'

Aufgabenstatus prüfen — Beispiel:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Antwort nach erfolgreichem Upload

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2000,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Antwort während der Verarbeitung

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2000,
    "success": 800,
    "failure": 0
}

Antwort bei Abschluss (exported)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2000,
    "success": 2000,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Anfrage-URL zum Hochladen der Datei

POST https://api.checknumber.ai/v1/tasks

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
file	file, eine E-Mail-Adresse pro Zeile
task_type	string, auf email_check setzen

Anfrage-URL zur Aufgabenstatusprüfung

POST https://api.checknumber.ai/v1/gettasks

Anfrageparameter zur Aufgabenstatusprüfung

Parameter	Beschreibung
task_id	string, bei der Aufgabenerstellung zurückgegebene Task-ID

Ergebnisfelder

Das Ergebnis-ZIP enthält separate Dateien pro E-Mail-Anbieter. Jede Zeile enthält:

Feld	Beschreibung
Email	E-Mail-Adresse
Active	Ob die E-Mail-Adresse bei der Plattform registriert ist (true / false)
Provider	Erkannter E-Mail-Anbieter: gmail, outlook, yahoo, mailru, icloud oder unsupported

Unterstützte Anbieter

Anbieter	task_type-Unteraufgabe
Gmail	email_gmail
Outlook	email_outlook
Yahoo	email_yahoo
Mail.ru	email_mailru
iCloud	email_icloud

Mindestbatchgröße: 2.000 E-Mail-Adressen pro Aufgabe.

Antwortformat

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung
updated_at	Zeitstempel der letzten Statusaktualisierung
task_id	Eindeutige Task-Kennung
user_id	Benutzer-ID
status	pending · processing · exported · failed (wird automatisch erstattet)
total	Gesamtzahl der übermittelten E-Mail-Adressen
success	Erfolgreich geprüfte E-Mail-Adressen
failure	Zeilen, die nicht verarbeitet werden konnten
result_url	Download-URL, wenn status gleich exported ist
actual_amount	(Optional) Tatsächlich abgerechneter Betrag, verfügbar nach Abrechnung der Aufgabe
estimated_amount	(Antwort bei Aufgabenerstellung) Geschätzter Betrag; die endgültige Abrechnung erfolgt nach Abschluss der Aufgabe

Statuscodes

Status	Beschreibung
200	free, Anfrage erfolgreich (z. B. Statusabfrage)
202	charge, Aufgabe erfolgreich erstellt; der geschätzte Betrag wird abgebucht
400	free, Ungültige Anfrage: Parameter oder Dateiformat fehlerhaft, Aufgabentyp nicht unterstützt oder weniger gültige Einträge als die Mindestmenge
401	free, Fehlender oder ungültiger API-Schlüssel
402	free, Unzureichendes Guthaben
404	free, Aufgabe nicht gefunden
413	free, Hochgeladene Datei zu groß
500	free, Interner Serverfehler; bitte später erneut versuchen