Referenz

AvatarLookup API-Referenz

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

Eintrag	Wert
Basis-URL	https://avatarlookup.com
Auth-Header	X-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-checkPOST/api/v1/image/profile

Senden Sie eine Kennung 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 dem Code 42200 und wird nicht berechnet. Eine Mehrfachanfrage behält die Eingabereihenfolge bei, rechnet jede Kennung einzeln ab und hat 300 Sekunden Zeit – wird sie nicht rechtzeitig fertig, schlägt die gesamte Anfrage fehl und alle Beträge werden erstattet. Die Bildprofilanalyse nutzt einen eigenen Endpunkt, /api/v1/image/profile, und nimmt ein Bild statt einer Kennung entgegen.

Parameter

Feld	Typ	Beschreibung
`service_type`	string	Produktcode, eines der unten aufgeführten Produkte.
`identifier`	string	Einzelprüfung: eine Kennung. Der Server normalisiert sie.
`identifiers`	string[]	Mehrfachprüfung: 1 bis 100 Kennungen. Die Antwort behält diese Reihenfolge bei.
`file`	file	Bildprofilanalyse: ein Porträtbild (Multipart-Upload). Es gibt keinen `identifier`.

Produkte in dieser Gruppe

Bild-Profilanalyseimage_profileLaden Sie ein beliebiges Bild hoch und erhalten Sie seine Porträtattribute: geschätztes Alter, Geschlecht, Bildtyp, Haarfarbe und Hautton.Produktseite
WhatsApp-Profilbildanalysews_profilePrüfen Sie, ob eine Nummer ein WhatsApp-Profilbild hat, erhalten Sie die Bild-URL und lesen Sie die Porträtattribute dieses Profilbilds.Produktseite
E-Mail-Profilbildanalyseemail_profilePrüfen Sie, ob ein E-Mail-Konto ein Profilbild hat, und lesen Sie dessen Porträtattribute. Deckt Gmail, Yandex und Mail.ru ab.Produktseite

Bild-Profilanalyse

image_profileBild

Laden Sie ein beliebiges Bild hoch und erhalten Sie seine Porträtattribute: geschätztes Alter, Geschlecht, Bildtyp, Haarfarbe und Hautton.

Einzelprüfung

POST/api/v1/image/profile

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/image/profile" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=image_profile \
  -F file=@portrait.jpg

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "image_profile",
    "identifier": "img:7013df96c540904a4b7ba295e9162ab2",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`identifier`	string	Aus dem Inhalt abgeleiteter Fingerabdruck des übermittelten Bildes. Dasselbe Bild ergibt immer denselben Wert.
`category`	string	Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.
`age`	integer	Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).
`gender`	string	male, female oder unknown.
`skin_color`	string	Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
`hair_color`	string	Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.

WhatsApp-Profilbildanalyse

ws_profileTelefon

Prüfen Sie, ob eine Nummer ein WhatsApp-Profilbild hat, erhalten Sie die Bild-URL und lesen Sie die Porträtattribute dieses Profilbilds.

Einzelprüfung

POST/api/v1/check

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_profile", "identifier": "+17253100591" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_profile",
    "identifier": "+17253100591",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://pps.whatsapp.net/v/example.jpg",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`registered`	boolean	Ob die Nummer bei WhatsApp registriert ist.
`avatar`	boolean	Ob ein Profilbild festgelegt ist.
`avatar_url`	string	URL des Profilbilds; leerer String, wenn kein Foto festgelegt ist.
`category`	string	Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.
`age`	integer	Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).
`gender`	string	male, female oder unknown.
`skin_color`	string	Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
`hair_color`	string	Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.

Mehrfachprüfung

POST/api/v1/batch-check

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_profile", "identifiers": ["+17253100591", "+14155550000", "12345"] }'

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_profile",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://pps.whatsapp.net/v/example.jpg",
        "category": "individual portrait",
        "age": 39,
        "gender": "male",
        "skin_color": "white",
        "hair_color": "brown"
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": "",
        "category": "unknown",
        "gender": "unknown",
        "skin_color": "unknown",
        "hair_color": "unknown"
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`exists`	boolean	Ob diese Kennung 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.
`registered`	boolean	Ob das Konto auf dieser Plattform existiert (bei einer E-Mail-Adresse: ob sie erreichbar ist). Nur vorhanden, wenn exists true ist, mit derselben Bedeutung wie bei der Einzelabfrage.
`avatar`	boolean	Ob ein Profilbild festgelegt ist.
`avatar_url`	string	URL des Profilbilds; leerer String, wenn kein Foto festgelegt ist.
`category`	string	Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.
`age`	integer	Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).
`gender`	string	male, female oder unknown.
`skin_color`	string	Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
`hair_color`	string	Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.

E-Mail-Profilbildanalyse

email_profileE-Mail

Prüfen Sie, ob ein E-Mail-Konto ein Profilbild hat, und lesen Sie dessen Porträtattribute. Deckt Gmail, Yandex und Mail.ru ab.

Einzelprüfung

POST/api/v1/check

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_profile", "identifier": "alex.kim@gmail.com" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_profile",
    "identifier": "alex.kim@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a/example",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`registered`	boolean	Ob die E-Mail-Adresse erreichbar ist (E-Mails empfangen kann).
`avatar`	boolean	Ob ein Profilbild festgelegt ist.
`avatar_url`	string	URL des Profilbilds; leerer String, wenn kein Profilbild festgelegt ist.
`category`	string	Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.
`age`	integer	Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).
`gender`	string	male, female oder unknown.
`skin_color`	string	Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
`hair_color`	string	Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.

Mehrfachprüfung

POST/api/v1/batch-check

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_profile", "identifiers": ["alex.kim@gmail.com", "no.such.user@gmail.com", "not-an-email"] }'

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_profile",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "alex.kim@gmail.com",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://lh3.googleusercontent.com/a/example",
        "category": "individual portrait",
        "age": 39,
        "gender": "male",
        "skin_color": "white",
        "hair_color": "brown"
      },
      {
        "identifier": "no.such.user@gmail.com",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": "",
        "category": "unknown",
        "gender": "unknown",
        "skin_color": "unknown",
        "hair_color": "unknown"
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`exists`	boolean	Ob diese Kennung 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.
`registered`	boolean	Ob das Konto auf dieser Plattform existiert (bei einer E-Mail-Adresse: ob sie erreichbar ist). Nur vorhanden, wenn exists true ist, mit derselben Bedeutung wie bei der Einzelabfrage.
`avatar`	boolean	Ob ein Profilbild festgelegt ist.
`avatar_url`	string	URL des Profilbilds; leerer String, wenn kein Profilbild festgelegt ist.
`category`	string	Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.
`age`	integer	Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).
`gender`	string	male, female oder unknown.
`skin_color`	string	Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
`hair_color`	string	Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.

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

Feld	Typ	Beschreibung
`service_type`	string	Produktcode für die Massenprüfung, eines der unten aufgeführten Produkte.
`country`	string	ISO-3166-1-Code wie `US`. Erforderlich für Nummernaufgaben: Jede Nummer muss ihre Ländervorwahl enthalten und zu diesem Land gehören (Nummern, die das nicht tun, werden ausgelassen und nicht berechnet); außerdem bestimmt er das Routing. Bei multipart muss er vor `file` stehen.
`file`	file	Eine `.txt`- oder `.csv`-Datei mit einer Kennung pro Zeile, bis zu `max_file_bytes` (standardmäßig 20MB).
`Idempotency-Key`	header	Optional, 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

WhatsApp-Profilbildanalyse · Massenprüfungws_profile_batchLaden Sie eine ganze Datei mit Nummern hoch: WhatsApp-Profilbild-URL und was das Profilbild zeigt – Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.Produktseite
Telegram-Nummernprofil · Massenprüfungtg_profile_batchLaden Sie Nummern hoch: Telegram-Benutzer-ID, Benutzername, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkanntes Alter, Geschlecht und Hautton.Produktseite
Telegram-Benutzernamenprofil · Massenprüfungtg_username_profile_batchLaden Sie Telegram-Benutzernamen hoch: Benutzer-ID, aktive Tage und Profilbild-URL für jedes Konto.Produktseite
Viber-Nummernprofil · Massenprüfungviber_profile_batchLaden Sie Nummern hoch: Viber-Mitglieds-ID, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.Produktseite
MAX-Nummernprofil · Massenprüfungmax_profile_batchLaden Sie Nummern hoch: MAX-Benutzer-ID, Profilbild-URL und Geschlecht.Produktseite
LINE-Profilbildanalyse · Massenprüfungline_profile_batchLaden Sie Nummern hoch: LINE-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.Produktseite
Zalo-Nummernprofil · Massenprüfungzalo_profile_batchLaden Sie Nummern hoch: Zalo-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.Produktseite
E-Mail-Profilbildprüfung · Massenprüfungemail_avatar_batchLaden Sie Gmail-, Yandex- oder Mail.ru-Adressen hoch: ob jede zustellbar ist, und ihr Profilbild.Produktseite

WhatsApp-Profilbildanalyse · Massenprüfung

ws_profile_batchTelefon1.000–500.000 pro Aufgabe

Laden Sie eine ganze Datei mit Nummern hoch: WhatsApp-Profilbild-URL und was das Profilbild zeigt – Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -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

Antwort

{
  "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"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}

Anfrage

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "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"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`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.

Telegram-Nummernprofil · Massenprüfung

tg_profile_batchTelefon1.000–500.000 pro Aufgabe

Laden Sie Nummern hoch: Telegram-Benutzer-ID, Benutzername, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkanntes Alter, Geschlecht und Hautton.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_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"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}

Anfrage

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_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"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`identifier`	17253100591	Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
`activated`	true	Ob die Nummer bei Telegram registriert ist: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	1234567890	Telegram-Benutzer-ID.
`username`	alex_kim	Benutzername; leer, wenn das Konto keinen hat.
`activedays`	9	Tage seit das Konto zuletzt gesehen wurde, als ganze Zahl – ein kleinerer Wert ist aktueller. Wenn das Konto seinen genauen Zuletzt-online-Zeitpunkt verbirgt, gibt Telegram nur einen Bereich preis, und der Wert ist eine Näherung: 0 (kürzlich), 7 (innerhalb einer Woche), 30 (innerhalb eines Monats) oder 1000 (vor langer Zeit).
`avatar_url`	https://telegram.waavatar.xyz/v/example.jpg	URL des Profilbilds; leer, wenn das Konto kein Profilbild hat.
`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`	white	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.

Telegram-Benutzernamenprofil · Massenprüfung

tg_username_profile_batchBenutzername1.000–500.000 pro Aufgabe

Laden Sie Telegram-Benutzernamen hoch: Benutzer-ID, aktive Tage und Profilbild-URL für jedes Konto.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_username_profile_batch \
  -F file=@usernames.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_username_profile_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://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_username_profile_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

Feld	Beispiel:	Beschreibung
`identifier`	alex_kim	Der übermittelte Benutzername, ohne @ oder t.me/ (z. B. alex_kim).
`activated`	true	Ob der Benutzername zu einem existierenden Telegram-Konto gehört: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	1234567890	Telegram-Benutzer-ID; kann auch bei einem existierenden Konto leer sein.
`activedays`	9	Tage seit das Konto zuletzt gesehen wurde, als ganze Zahl – ein kleinerer Wert ist aktueller. Wenn das Konto seinen genauen Zuletzt-online-Zeitpunkt verbirgt, gibt Telegram nur einen Bereich preis, und der Wert ist eine Näherung: 0 (kürzlich), 7 (innerhalb einer Woche), 30 (innerhalb eines Monats) oder 1000 (vor langer Zeit). Kann leer sein, wenn das Konto keine Zuletzt-online-Informationen preisgibt.
`avatar_url`	https://cdn5.telesco.pe/file/example.jpg	URL des Profilbilds; leer, wenn das Konto kein Profilbild hat.

Viber-Nummernprofil · Massenprüfung

viber_profile_batchTelefon1.000–500.000 pro Aufgabe

Laden Sie Nummern hoch: Viber-Mitglieds-ID, aktive Tage und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=viber_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "viber_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"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}

Anfrage

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "viber_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"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`identifier`	17253100591	Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
`activated`	true	Ob die Nummer bei Viber registriert ist: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	A5qCVDb3jPU=	Viber-Mitglieds-ID.
`activedays`	3	Tage seit der letzten Online-Aktivität des Kontos – ein kleinerer Wert ist aktueller.
`avatar_url`	https://viber.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`	white	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.

MAX-Nummernprofil · Massenprüfung

max_profile_batchTelefon1.000–500.000 pro Aufgabe

Laden Sie Nummern hoch: MAX-Benutzer-ID, Profilbild-URL und Geschlecht.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=max_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "max_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"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}

Anfrage

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "max_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"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`identifier`	17253100591	Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
`activated`	true	Ob die Nummer bei MAX registriert ist: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	343064807	MAX-Benutzer-ID.
`avatar_url`	https://i.oneme.ru/i?r=example	URL des Profilbilds; leer, wenn das Konto kein Profilbild hat.
`gender`	male	Geschlecht des Kontos: male oder female; leer, wenn unbekannt.

LINE-Profilbildanalyse · Massenprüfung

line_profile_batchTelefon2.000–500.000 pro Aufgabe

Laden Sie Nummern hoch: LINE-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht, Hautton und Haarfarbe.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=line_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "line_profile_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 2027,
    "total": 2027,
    "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://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "line_profile_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 2027,
    "total": 2000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 24,
    "preparing": false,
    "success_cnt": 1980,
    "failure_cnt": 20,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`identifier`	17253100591	Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
`activated`	true	Ob die Nummer bei LINE registriert ist: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	u5158553776c28d9164035c4fd0a07cd4	LINE-Benutzer-ID.
`avatar_url`	https://profile.line-scdn.net/example	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.

Zalo-Nummernprofil · Massenprüfung

zalo_profile_batchTelefon1.000–500.000 pro Aufgabe

Laden Sie Nummern hoch: Zalo-Benutzer-ID und Profilbild-URL sowie aus dem Profilbild erkannte Kategorie, Alter, Geschlecht und Hautton.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=zalo_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "zalo_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"
  }
}

Aufgabe abfragen

GET/api/v1/bulk-tasks/{id}

Anfrage

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Antwort

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "zalo_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"
  }
}

Ergebnisspalten

Feld	Beispiel:	Beschreibung
`identifier`	17253100591	Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
`activated`	true	Ob die Nummer bei Zalo registriert ist: true oder false. Wenn der Wert nicht true ist, bleiben alle anderen Spalten dieser Zeile leer.
`uid`	452114152	Zalo-Benutzer-ID.
`avatar_url`	https://s160-ava-talk.zadn.vn/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`	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.

E-Mail-Profilbildprüfung · Massenprüfung

email_avatar_batchE-Mail1.000–500.000 pro Aufgabe

Laden Sie Gmail-, Yandex- oder Mail.ru-Adressen hoch: ob jede zustellbar ist, und ihr Profilbild.

Aufgabe übermitteln

POST/api/v1/bulk-tasks

Anfrage

curl -X POST "https://avatarlookup.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://avatarlookup.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

Feld	Beispiel:	Beschreibung
`identifier`	alex.kim@gmail.com	Die übermittelte Adresse in Kleinbuchstaben.
`activated`	true	Ob die Adresse beim Anbieter zustellbar ist – ob sie E-Mails empfangen kann: true oder false. Wenn der Wert nicht true ist, 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.

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://avatarlookup.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

Profilbildabfragen sind synchron. Entscheiden Sie anhand des zurückgegebenen Codes, ob Sie das Ergebnis übernehmen oder es später erneut versuchen.

Feld	Beschreibung
`5 gleichzeitige Anfragen pro Benutzer`	Einzel- und Mehrfachprüfungen teilen sich dieses Limit, und eine Mehrfachanfrage zählt als eine Anfrage, unabhängig davon, wie viele Kennungen sie enthält. Zusätzlich läuft pro Konto jeweils nur eine Mehrfachprüfung; eine zweite wird abgelehnt, bis die erste abgeschlossen ist. Das Erreichen eines der Limits liefert sofort den Code 42901 ohne Berechnung, zusammen mit einem Retry-After-Header – senden Sie erneut, sobald eine laufende Anfrage abgeschlossen ist.
`60 s Einzelprüfung, 300 s Mehrfachprüfung`	Bei Überschreitung des Zeitlimits wird der 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 Kennungen`	Die 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

Code	Beschreibung
`40000`	Nicht unterstützter Diensttyp oder widersprüchliche Anfragefelder
`40001`	Ungültiger JSON-Body
`40002`	Ungültige Kennung
`40100`	Fehlender oder ungültiger API-Schlüssel
`40200`	Unzureichendes Guthaben
`42200`	Die Kennung konnte derzeit nicht bestimmt werden. Es werden keine Daten zurückgegeben und die Anfrage wird nicht berechnet
`42900`	Ein Nutzungskontingent ist aufgebraucht, oder es gibt zu viele nicht abgeschlossene Bestellungen
`42901`	Alle fünf Plätze für gleichzeitige 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
`50303`	Der Dienst ist derzeit ausgelastet; keine Berechnung. Warten Sie die Retry-After-Sekunden ab und senden Sie dieselbe Anfrage erneut
`50400`	Die 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
`50300`	Wartung des Prüfdienstes