EmailCheckPro
Referenz

EmailCheckPro API-Referenz

Alle Endpunkte teilen sich einen API-Schlüssel und ein Guthaben.

EintragWert
Basis-URLhttps://emailcheckpro.com
Auth-HeaderX-API-Key: sk_your_api_key
Antwort-Envelope{ code, msg, data }

Preise werden hier nicht aufgeführt; jedes Produkt wird pro erfolgreicher Prüfung berechnet. Preise ansehen

Authentifizierung

Verwenden Sie einen in den Einstellungen erstellten API-Schlüssel und senden Sie ihn mit jeder Anfrage.

Auth-Header
X-API-Key: sk_your_api_key

Halten Sie Ihren API-Schlüssel geheimRufen Sie diesen Endpunkt immer von Ihrem Server aus auf. Jeder, der den Schlüssel besitzt, kann Ihr Guthaben verbrauchen.

Synchrone Prüfungen

POST/api/v1/checkPOST/api/v1/batch-check

Übermitteln Sie eine E-Mail-Adresse oder bis zu 100 in einer Anfrage und lesen Sie das Ergebnis in derselben Antwort. Kein Polling, keine Callbacks. Ein unbestimmtes Ergebnis liefert 422 mit Code 42200 und wird nicht berechnet. Eine Mehrfachanfrage behält die Eingabereihenfolge bei, rechnet jeden Identifikator einzeln ab und hat 300 Sekunden Zeit – gelingt das nicht, schlägt die gesamte Anfrage fehl und alle Abbuchungen werden erstattet.

Parameter

FeldTypBeschreibung
service_typestringProduktcode, eines der unten aufgeführten Produkte.
identifierstringEinzelprüfung: eine E-Mail-Adresse. Der Server normalisiert sie.
identifiersstring[]Mehrfachprüfung: 1 bis 100 E-Mail-Adressen. Die Antwort behält diese Reihenfolge bei.

Produkte in dieser Gruppe

Prüfung der E-Mail-Zustellbarkeit

emailE-Mail

Bestätigen Sie, ob eine E-Mail-Adresse noch Nachrichten empfangen kann – funktioniert mit jeder Domain, von Gmail bis zur eigenen Firmendomain.

Einzelprüfung

POST/api/v1/check
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifier": "name@gmail.com" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "identifier": "name@gmail.com",
    "registered": true
  }
}
Antwortfelder
FeldTypBeschreibung
registeredbooleanOb die Adresse zustellbar ist – ob sie Nachrichten empfangen kann.

Mehrfachprüfung

POST/api/v1/batch-check
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}
Antwortfelder
FeldTypBeschreibung
existsbooleanOb diese E-Mail-Adresse ein Ergebnis geliefert hat. false bedeutet, dass das Format ungültig war, das Ergebnis unbestimmt war oder die Prüfung fehlgeschlagen ist; bei false ist keines der folgenden Felder vorhanden.
registeredbooleanOb die E-Mail-Adresse zustellbar ist, also E-Mails empfangen kann. Nur vorhanden, wenn exists true ist, mit derselben Bedeutung wie bei der Einzelprüfung.

Profilbildprüfung für E-Mails

email_avatarE-Mail

Zustellbarkeitsstatus plus die Profilbild-URL hinter der Adresse, für Gmail, Yandex und Mail.ru.

Einzelprüfung

POST/api/v1/check
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifier": "name@gmail.com" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "identifier": "name@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a-/example"
  }
}
Antwortfelder
FeldTypBeschreibung
registeredbooleanOb die Adresse bei diesem Anbieter zustellbar ist – ob sie Nachrichten empfangen kann.
avatarbooleanOb ein Profilbild festgelegt ist.
avatar_urlstringURL des Profilbilds, falls vorhanden; kann leer sein, auch wenn avatar true ist.

Mehrfachprüfung

POST/api/v1/batch-check
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://lh3.googleusercontent.com/a-/example"
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": ""
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}
Antwortfelder
FeldTypBeschreibung
existsbooleanOb diese E-Mail-Adresse ein Ergebnis geliefert hat. false bedeutet, dass das Format ungültig war, das Ergebnis unbestimmt war oder die Prüfung fehlgeschlagen ist; bei false ist keines der folgenden Felder vorhanden.
registeredbooleanOb die E-Mail-Adresse zustellbar ist, also E-Mails empfangen kann. Nur vorhanden, wenn exists true ist, mit derselben Bedeutung wie bei der Einzelprüfung.
avatarbooleanOb ein Profilbild festgelegt ist.
avatar_urlstringURL des Profilbilds, falls vorhanden; kann leer sein, auch wenn avatar true ist.

Asynchrone Prüfungen

POST/api/v1/bulk-tasksGET/api/v1/bulk-tasks/{id}

Laden Sie eine Datei hoch und erhalten Sie sofort eine Aufgaben-ID; fragen Sie diese ID dann ab, bis sie erfolgreich ist. Die erfolgreiche Antwort enthält result_url, den Download-Link für das Ergebnis. Es gibt nur zwei Aktionen: übermitteln und abfragen. Fragen Sie höchstens einmal alle 30 Sekunden ab.

Parameter

FeldTypBeschreibung
service_typestringProduktcode für die Massenprüfung, eines der unten aufgeführten Produkte.
countrystringFür E-Mail-Aufgaben nicht erforderlich – lassen Sie es weg. Wenn Sie es senden, wird es ignoriert.
filefileEine .txt- oder .csv-Datei mit einer Kennung pro Zeile, bis zu max_file_bytes (standardmäßig 20MB).
Idempotency-KeyheaderOptional, bis zu 128 Zeichen. Wird derselbe Schlüssel erneut gesendet, wird die ursprüngliche Aufgabe zurückgegeben, statt eine zweite zu erstellen.

Produkte in dieser Gruppe

Massenprüfung der E-Mail-Zustellbarkeit

email_batchE-Mail1.000–500.000 pro Aufgabe

Laden Sie eine ganze Datei mit Adressen hoch, erfahren Sie, welche davon Nachrichten empfangen können, und laden Sie das Ergebnis nach Abschluss herunter.

Aufgabe übermitteln

POST/api/v1/bulk-tasks
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_batch \
  -F file=@emails.txt
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "processing",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}
Anfrage
curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "success",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Ergebnisspalten
FeldBeispiel:Beschreibung
identifieralex.kim@example.comDie übermittelte E-Mail-Adresse in Kleinbuchstaben.
activatedtrueOb die Adresse Nachrichten empfangen kann: true (erreichbar) oder false (nicht erreichbar).

Massenprüfung von E-Mail-Profilbildern

email_avatar_batchE-Mail1.000–500.000 pro Aufgabe

Laden Sie eine ganze Datei mit Gmail-, Yandex- oder Mail.ru-Adressen hoch: Erfahren Sie, welche zustellbar sind, und erhalten Sie jeweils das Profilbild.

Aufgabe übermitteln

POST/api/v1/bulk-tasks
Anfrage
curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "processing",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}
Anfrage
curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "success",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Ergebnisspalten
FeldBeispiel:Beschreibung
identifieralex.kim@gmail.comDie übermittelte Adresse in Kleinbuchstaben.
activatedtrueOb die Adresse bei diesem Anbieter zustellbar ist – ob sie Nachrichten empfangen kann: true oder false. Ist der Wert nicht true, bleiben alle anderen Spalten dieser Zeile leer.
avatartrueOb ein Profilbild festgelegt ist: true oder false. avatar_url kann dennoch leer sein, wenn das Bild nicht verfügbar ist.
avatar_urlhttps://lh3.googleusercontent.com/a/exampleDie URL des Profilbilds; leer, wenn keine URL verfügbar ist.

Guthaben

GET/api/v1/balance

Liest das aktuelle Kontoguthaben in USD-Mikroeinheiten aus. Nur lesend: Es wird kein Prüfdatensatz erstellt und nichts berechnet.

Guthaben

GET/api/v1/balance
Anfrage
curl "https://emailcheckpro.com/api/v1/balance" \
  -H "X-API-Key: sk_your_api_key"
Antwort
{
  "code": 0,
  "msg": "ok",
  "data": {
    "balance_micros": 12500000
  }
}

Parallelität, Zeitlimits und Wiederholungsverhalten

Prüfungen der E-Mail-Zustellbarkeit sind synchron. Entscheiden Sie anhand des zurückgegebenen Codes, ob Sie das Ergebnis übernehmen oder es erneut versuchen.

FeldBeschreibung
5 gleichzeitige Anfragen pro BenutzerEinzel- und Mehrfachprüfungen teilen sich dieses Limit, und eine Mehrfachanfrage zählt als eine Anfrage, unabhängig davon, wie viele E-Mails sie enthält. Zusätzlich läuft pro Konto jeweils nur eine Mehrfachprüfung; eine zweite wird abgelehnt, bis die erste abgeschlossen ist. Wird eines der Limits erreicht, wird sofort Code 42901 ohne Berechnung zurückgegeben, zusammen mit einem Retry-After-Header – senden Sie erneut, sobald eine laufende Anfrage abgeschlossen ist.
60 s Einzelprüfung, 300 s MehrfachprüfungBei Überschreitung des Zeitlimits wird Code 50400 ohne Berechnung zurückgegeben. Eine Mehrfachprüfung mit Zeitüberschreitung schlägt als Ganzes fehl – keine Teilergebnisse, und der volle Betrag wird erstattet.
Eine Mehrfachprüfung umfasst bis zu 100 E-MailsDie Ergebnisse behalten Reihenfolge und Länge der Übermittlung bei. Pro Konto läuft jeweils eine Mehrfachprüfung; senden Sie den nächsten Stapel, sobald der vorherige zurückgekommen ist.

Fehlercodes

CodeBeschreibung
40000Nicht unterstützter Diensttyp oder widersprüchliche Anfragefelder
40001Ungültiger JSON-Body
40002Ungültige E-Mail-Adresse
40100Fehlender oder ungültiger API-Schlüssel
40200Unzureichendes Guthaben
42200Die E-Mail-Adresse konnte derzeit nicht ermittelt werden. Es werden keine Daten zurückgegeben, und die Anfrage wird nicht berechnet
42900Ein Nutzungskontingent ist aufgebraucht, oder es gibt zu viele nicht abgeschlossene Bestellungen
42901Alle fünf Plätze für laufende Anfragen sind belegt, oder auf diesem Konto läuft bereits eine Mehrfachprüfung; senden Sie erneut, sobald eine laufende Anfrage abgeschlossen ist. Die abgelehnte Anfrage wird nicht berechnet und enthält einen Retry-After-Header
50303Der Dienst ist derzeit ausgelastet; keine Berechnung. Warten Sie die im Retry-After angegebenen Sekunden ab und senden Sie dieselbe Anfrage erneut
50400Die Prüfung wurde nicht innerhalb ihres Zeitlimits abgeschlossen und wird nicht berechnet; wiederholen Sie sie. Eine Zeitüberschreitung beim Stapel lässt den gesamten Stapel fehlschlagen und erstattet den vollen Betrag
50300Wartung des Prüfdienstes