cURL-Anfrage
POST /api/v1/bulk-taskscurl -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.txtMassenprodukt email_avatar_batch
Massenprüfung von E-Mail-Profilbildern
Laden Sie eine ganze Datei mit Gmail-, Yandex- oder Mail.ru-Adressen hoch: Erfahren Sie, welche zustellbar sind, und erhalten Sie jeweils das Profilbild.
Eine Ergänzung für komplette große Listen – für eine Handvoll E-Mails antwortet die Echtzeitprüfung in derselben Anfrage. Echtzeitprüfung →
API-Vertrag
Zwei Schritte: Datei übermitteln, dann Aufgabe abfragen
Beim Übermitteln wird sofort eine Aufgaben-ID zurückgegeben; fragen Sie die Aufgabe über diese ID ab, und sobald sie erfolgreich ist, enthält die Antwort den Download-Link für die Ergebnisdatei. Jede Anfrage wird mit ihrer eigenen Antwort gezeigt.
1. Datei übermitteln
Die Aufgaben-ID kommt sofort zurück, mit preparing auf true, während die Datei im Hintergrund vorbereitet wird: Ungültige Zeilen und Duplikate werden entfernt und nicht berechnet. Für die übermittelten Zeilen wird Guthaben reserviert und bei Abschluss abgerechnet; die Differenz wird erstattet.
Antwort: Aufgabe erstellt
200 OK{
"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"
}
}2. Aufgabe abfragen
Fragen Sie über die Aufgaben-ID ab. Nach Abschluss der Vorbereitung gilt submitted_lines = total + invalid_cnt + duplicate_cnt, wobei total die geprüfte und berechnete Menge ist; no_code_cnt und other_country_cnt sind bei E-Mail-Aufgaben immer 0. Eine erfolgreiche Antwort enthält die Anzahl der Erfolge und Fehlschläge sowie den Download-Link für die Ergebnisdatei; eine bei der Vorbereitung abgelehnte Aufgabe erhält den Status failed mit reason_detail und wird vollständig erstattet.
cURL-Anfrage
GET /api/v1/bulk-tasks/{id}curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Antwort: Aufgabe abgeschlossen
200 OK{
"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"
}
}So läuft es ab
Was mit einer Massenaufgabe passiert
Die Massenprüfung ist keine vergrößerte Echtzeitprüfung – einmal übermitteln, im Hintergrund ausführen, später abholen. Sie müssen die Seite nicht geöffnet lassen; Aufgabenstatus und Ergebnisse bleiben in Ihrem Dashboard.
01Datei hochladen
Eine .txt- oder .csv-Datei mit einer E-Mail-Adresse pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.
02Vorprüfung und Reservierung
Offensichtliche Probleme (eine leere Datei, das falsche Format, zu wenige Zeilen) werden beim Hochladen abgelehnt. Anschließend wird Guthaben reserviert und die Datei im Hintergrund vorbereitet: Doppelte und ungültige Zeilen werden entfernt, und die Anbieterabdeckung wird geprüft. Eine Datei, die dabei durchfällt, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet; andernfalls werden nur die verbleibenden Zeilen geprüft, und die Aufgabe wird nach Abschluss abgerechnet.
03Im Hintergrund ausführen
Die Aufgabe läuft selbstständig – Sie können die Seite gern schließen. Ein Fehlschlag wird sofort gemeldet und vollständig erstattet.
04Ergebnis herunterladen
Holen Sie die Datei auf der Seite für Massenprüfungen ab. Sie zahlen nur für E-Mails, die tatsächlich ein Ergebnis geliefert haben; die Differenz wird erstattet.
Ergebnisfelder
Spalten der Ergebnisdatei
Der Download ist eine einzelne CSV-Datei mit dieser vollständigen Tabelle.
Spalten der Ergebnisdatei
identifier·alex.kim@gmail.com— Die übermittelte Adresse in Kleinbuchstaben.activated·true— Ob 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.avatar·true— Ob ein Profilbild festgelegt ist: true oder false. avatar_url kann dennoch leer sein, wenn das Bild nicht verfügbar ist.avatar_url·https://lh3.googleusercontent.com/a/example— Die URL des Profilbilds; leer, wenn keine URL verfügbar ist.
Ideal für
Wann Sie dieses Produkt nutzen sollten
Kontaktanreicherung
activatedavatar_urlNachdem bestätigt ist, dass eine Adresse Nachrichten empfangen kann, ergänzen Sie den Kontaktdatensatz um den öffentlichen Profilbild-Link, damit der Kontakt leichter wiederzuerkennen ist.
Beispiel: Gmail-Kontakte anreichern, die bereits in einem Vertriebs-CRM gespeichert sind.
Datenbankpflege
identifieractivatedavatarMarkieren Sie nicht zustellbare Adressen und Einträge ohne Profilbild, damit sie später bereinigt, zusammengeführt oder überprüft werden können.
Beispiel: fehlgeschlagene Adressen entfernen und anschließend gültige Kontakte mit unvollständigen Profilen überprüfen.
Regelmäßige Nachprüfungen
activatedavataravatar_urlPrüfen Sie eine gespeicherte Liste regelmäßig erneut, um zu sehen, ob sich die Zustellbarkeit oder ein öffentliches Profilbild geändert hat.
Beispiel: Profilbilddaten wichtiger Kontakte jedes Quartal aktualisieren.
Kurze Antwort
Was ist die Massen-Profilbildprüfung?
Die Massen-Profilbildprüfung ist die Dateiversion der Echtzeit-Profilbildprüfung (email_avatar) und deckt die Domains von Gmail, Yandex und Mail.ru ab. Mischen Sie sie beliebig in einer Datei; jede Adresse wird für Sie weitergeleitet. Für jede Adresse wird zurückgegeben, ob sie zustellbar ist, ob ein Profilbild festgelegt ist, und die Profilbild-URL. Eine Datei mit Adressen außerhalb dieser Liste schlägt bei der Vorbereitung fehl und wird vollständig erstattet.
Klare Grenzen
Grenzen dieses Produkts
- Dies ist keine Identitätsprüfung. Ein Ergebnis sagt aus, ob die Adresse Nachrichten empfangen kann; es kann nicht bestätigen, wem sie gehört.
- Es werden niemals Nachrichtenverlauf, Unterhaltungsinhalte oder private Kontoinhalte geliefert.
- Die Profilbildprüfung deckt die Domains von Gmail, Yandex und Mail.ru ab. Sie können alle drei beliebig in einer Datei mischen; Adressen außerhalb dieser Liste lassen die Aufgabe mit Angabe der Anzahl fehlschlagen, bei vollständiger Erstattung. Die Zustellbarkeitsprüfung akzeptiert jede Domain.
- Die Ergebnisse spiegeln den Zeitpunkt der Ausführung wider. Führen Sie die Aufgabe erneut aus, um einen aktuellen Stand zu erhalten – gespeicherte Ergebnisse werden nie automatisch aktualisiert.
- Download-Links laufen ab. Rufen Sie die Datei bald nach Abschluss der Aufgabe ab; ist ein Link abgelaufen, fragen Sie die Aufgabe erneut ab, um einen neuen zu erhalten.
Wann sich die Massenprüfung eignet
Wann sich die Massenprüfung lohnt – und wann die Echtzeitprüfung schneller ist
| Echtzeitprüfung | Massenprüfung | |
|---|---|---|
| Wie viele E-Mails | 1 E-Mail pro Einzelprüfung; mehrere pro Mehrfachanfrage – die genauen Obergrenzen stehen in der API-Dokumentation | Eine ganze große Liste in einer Aufgabe – den aktuellen Größenbereich finden Sie auf der Preisseite |
| Ergebnisse erhalten | Sofort: Einzel- und Mehrfach-Endpunkt antworten in derselben Antwort; das Dashboard liefert sie einzeln | Ergebnisdatei herunterladen, sobald die Aufgabe abgeschlossen ist |
| Anbieterabdeckung | Keine Einschränkung – beliebig gemischt in einer Anfrage | Die Prüfung vollständiger Adressen akzeptiert jede Domain in einer Datei; die Profilbildprüfung akzeptiert Gmail, Yandex und Mail.ru gemischt in einer Datei, aber nichts außerhalb dieser drei |
| Ergebnisform | JSON, Felder pro E-Mail | Ergebnisdatei (eine CSV-Datei mit der vollständigen Tabelle) |
| Typische Nutzung | Formularvalidierung, Abfragen durch Mitarbeitende, Prüfung vor dem Versand | Listenpflege, Filterung vor Kampagnen, Bereinigung gespeicherter Daten |
Produkt-FAQ
Über die Profilbildprüfung
Wann sollte ich die Massenprüfung statt einer Echtzeitprüfung nutzen?
Nutzen Sie die Massenprüfung für eine komplette große Liste. Für eine Handvoll E-Mails antwortet die Echtzeitprüfung in derselben Anfrage, ohne dass eine Aufgabe geplant werden muss.
Was passiert mit ungültigen E-Mails in der Datei?
Die Vorprüfung verwirft fehlerhafte Zeilen, sodass sie nie in die abrechenbare Anzahl eingehen. Von den verbleibenden E-Mails werden auch diejenigen nicht berechnet, die der vorgelagerte Dienst nicht auflösen kann. Sie zahlen nur für E-Mails, die tatsächlich ein Ergebnis liefern.
Wie lange dauert eine Aufgabe?
Das hängt von der Anzahl der E-Mails und vom Produkt ab. Sie können die Seite nach dem Übermitteln schließen; die Aufgabe läuft im Hintergrund, und das Ergebnis wartet auf der Seite für Massenprüfungen auf Sie.
Erhalte ich eine Erstattung, wenn sie fehlschlägt?
Ja. Eine fehlgeschlagene Aufgabe wird vollständig erstattet. Ist die Aufgabe erfolgreich, liefern aber einige E-Mails kein Ergebnis, wird dieser Anteil automatisch erstattet. Die Differenz zwischen dem reservierten und dem tatsächlich berechneten Betrag erhalten Sie immer zurück.
Verwandte Produkte
Weitere Massenprodukte
Erstellen Sie ein Konto, um eine Massenaufgabe zu übermitteln
Massen- und Echtzeitprüfungen greifen auf dasselbe Guthaben zu – es muss nichts zusätzlich aktiviert werden. Registrieren Sie sich und laden Sie Ihre erste Datei auf der Seite der Massenprüfung hoch.