cURL-Anfrage
POST /api/v1/bulk-taskscurl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=ws_profile_batch \
-F country=US \
-F file=@numbers.txt
Massenprodukt ws_profile_batch
WhatsApp-Profilbildanalyse · Massenprüfung
Laden Sie eine ganze Datei mit Nummern hoch: WhatsApp-Profilbild-URL und was das Profilbild zeigt – Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.
Eine Ergänzung für ganze große Listen – für wenige Kennungen 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, Duplikate und – bei Nummernaufgaben – Nummern ohne Ländervorwahl oder aus einem anderen Land 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": "ws_profile_batch",
"status": "processing",
"country": "US",
"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 + no_code_cnt + other_country_cnt + duplicate_cnt, wobei total die geprüfte und berechnete Menge ist. 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://avatarlookup.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": "ws_profile_batch",
"status": "success",
"country": "US",
"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 Nummer pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.
02Vorprüfung und Reservierung
Offensichtliche Probleme (eine leere Datei, ein falsches 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 Länderregel wird geprüft. Eine Datei, die dabei scheitert, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet; andernfalls werden nur die verbleibenden Zeilen geprüft, und die Aufgabe wird bei 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 Einträge, die tatsächlich ein Ergebnis geliefert haben; die Differenz wird erstattet.
Ergebnisfelder
Spalten der Ergebnisdatei
Der Download ist eine einzelne CSV-Datei mit der vollständigen Ergebnistabelle.
Spalten der Ergebnisdatei
identifier·17253100591— Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).activated·true— Ob die Nummer bei WhatsApp registriert ist: true oder false. Ist der Wert nicht true, bleiben alle anderen Spalten dieser Zeile leer.avatar_url·https://pps.waavatar.xyz/v/example.jpg— URL des Profilbilds; leer, wenn das Konto kein Profilbild hat.category·individual portrait— Was das Profilbild zeigt: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object usw.; unknown, wenn es nicht erkannt werden kann, leer, wenn kein Profilbild vorhanden ist.age·31— Aus dem Profilbild geschätztes Alter; leer, wenn es nicht geschätzt werden kann.gender·male— Aus dem Profilbild geschätztes Geschlecht: male oder female; unknown, wenn es nicht erkannt werden kann, leer, wenn kein Profilbild vorhanden ist.skin_color·east_asian— Aus dem Profilbild geschätzter Hautton, z. B. white, asian, east_asian; unknown, wenn er nicht erkannt werden kann, leer, wenn kein Profilbild vorhanden ist.hair_color·black— Aus dem Profilbild geschätzte Haarfarbe, z. B. black, brown; unknown, wenn sie nicht erkannt werden kann, leer, wenn kein Profilbild vorhanden ist.
Ideal für
Wann Sie dieses Produkt nutzen sollten
Listensegmentierung
activatedavatar_urlcategoryTeilen Sie große WhatsApp-Listen vor einer Kampagne oder einem CRM-Import in nutzbare, unvollständige und prüfbedürftige Gruppen auf.
Beispiel: Kontakte mit Profilbild und Porträtkategorie in eine Warteschlange für ausführlichere Profile leiten.
Profilbilder im CRM nachtragen
avatar_urlgenderErgänzen Sie bestehende Kundendatensätze um zurückgegebene Profilbild-Links und Profilsignale, ohne jede Nummer einzeln zu öffnen.
Beispiel: fehlende Kontaktfotos ergänzen, bevor ein Vertriebs- oder Support-Team seinen Arbeitsbereich aktualisiert.
Zielgruppenvorbereitung
categoryageskin_colorMachen Sie aus Profilbild-Ergebnissen eine konsistente erste Profilebene für die Zielgruppenprüfung und die nachgelagerte Segmentierung.
Beispiel: eine Prüfliste für Porträts, Gruppenfotos und Nicht-Porträts erstellen.
Datenbankpflege
activatedavatar_urlhair_colorFinden Sie Datensätze ohne Konto, ohne nutzbares Profilbild oder mit unvollständigen Attributen, damit Ihre Kontaktdaten leichter zu pflegen sind.
Beispiel: Zeilen ohne Ergebnis zur Bereinigung schicken und gültige Profilbild-URLs in der Hauptliste behalten.
Kurze Antwort
Was ist WhatsApp-Profilbildanalyse als Massenprüfung?
Die WhatsApp-Profilbild-Massenabfrage liefert für jede registrierte Nummer die Profilbild-URL und die aus dem Profilbild erkannten Attribute: Kategorie, Alter, Geschlecht, Hautton und Haarfarbe – dieselben Felder wie das WhatsApp-Profilbildprofil in Echtzeit. Die Aufgabe läuft im Hintergrund; wählen Sie beim Hochladen das Land, zu dem die Nummern gehören.
Klare Grenzen
Grenzen dieses Produkts
- Die Ergebnisse spiegeln den Zeitpunkt der Ausführung wider. Profilbilder ändern sich – führen Sie die Aufgabe für einen aktuellen Stand erneut aus; gespeicherte Ergebnisse werden nie automatisch aktualisiert.
- Es ist keine Prüfung der Erreichbarkeit oder Aktivität und keine Identitätsprüfung.
- An die Kennungen in der Datei wird nichts gesendet.
- Welche Spalten zurückkommen, hängt von der Plattform ab. Sie sind vor dem Hochladen auf dieser Seite aufgeführt.
- 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 Kennungen | 1 Kennung 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 |
| Land | Keine Auswahl nötig – Echtzeitabfragen werden einzeln gesendet, nicht nach Land gruppiert | Ein Land pro Aufgabe, beim Hochladen ausgewählt und mit der Datei übermittelt |
| Ergebnisform | JSON, Felder pro Eintrag | 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 WhatsApp-Profilbildanalyse
Wann sollte ich die Massenprüfung statt einer Echtzeitprüfung nutzen?
Nutzen Sie die Massenprüfung für eine ganze große Liste. Für wenige Kennungen antwortet die Echtzeitprüfung in derselben Anfrage, ohne dass eine Aufgabe geplant werden muss.
Was passiert mit ungültigen Kennungen in der Datei?
Die Vorprüfung verwirft fehlerhafte Zeilen, sodass sie nie in die abrechenbare Anzahl eingehen. Von den verbleibenden Nummern werden auch diejenigen nicht berechnet, die der vorgelagerte Dienst nicht auflösen kann. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis liefern.
Wie lange dauert eine Aufgabe?
Das hängt von der Anzahl der Einträge und vom Produkt ab. Sie können die Seite nach dem Absenden 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 Einträge nichts, wird dieser Anteil automatisch erstattet. Die Differenz zwischen dem reservierten und dem tatsächlich berechneten Betrag wird immer zurückerstattet.
Verwandte Produkte
Weitere Massenprodukte
Telegram-Nummernprofil · MassenprüfungLaden Sie Nummern hoch: Telegram-Benutzer-ID, Benutzername, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkanntes Alter, Geschlecht und Hautton.Telegram-Benutzernamenprofil · MassenprüfungLaden Sie Telegram-Benutzernamen hoch: Benutzer-ID, aktive Tage und Profilbild-URL für jedes Konto.
Viber-Nummernprofil · MassenprüfungLaden Sie Nummern hoch: Viber-Mitglieds-ID, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.
MAX-Nummernprofil · MassenprüfungLaden Sie Nummern hoch: MAX-Benutzer-ID, Profilbild-URL und Geschlecht.
LINE-Profilbildanalyse · MassenprüfungLaden Sie Nummern hoch: LINE-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.
Zalo-Nummernprofil · MassenprüfungLaden Sie Nummern hoch: Zalo-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.
E-Mail-Profilbildprüfung · MassenprüfungLaden Sie Gmail-, Yandex- oder Mail.ru-Adressen hoch: ob jede zustellbar ist, und ihr Profilbild.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.