service_type ws_profile
Prüfen Sie, ob eine Nummer ein WhatsApp-Profilbild hat, erhalten Sie die Bild-URL und lesen Sie die Porträtattribute dieses Profilbilds.
POST /api/v1/checkWhatsApp-ProfilbildanalyseKeine Anmeldung erforderlich.
API-Vertrag
Senden Sie eine Nummer und wählen Sie dieses Produkt mit service_type. Die Authentifizierung erfolgt über Ihren API-Schlüssel.
Kopieren Sie den folgenden curl-Befehl und ersetzen Sie nur den Beispiel-API-Schlüssel durch Ihren eigenen.
POST /api/v1/checkcurl -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" }'200 OK{
"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"
}
}So nutzen Sie es
Eine Nummer im E.164-Format (ein Pluszeichen, die Ländervorwahl, dann die Nummer) für WhatsApp oder eine vollständige E-Mail-Adresse für das E-Mail-Produkt.
registered gibt an, ob das Konto existiert (bei einer E-Mail-Adresse: ob sie erreichbar ist), avatar, ob ein Profilbild festgelegt ist, und avatar_url enthält das Bild. Alle drei kommen bei jeder erfolgreichen Abfrage zurück.
avatar_url verweist auf das CDN der Plattform und kann nach deren Zeitplan ablaufen. Behandeln Sie die URL als Verweis: Laden Sie das Bild herunter oder cachen Sie es, wenn Sie es behalten möchten.
Was geprüft wird
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.Ideal für
Ergänzen Sie Kundenlisten, Support-Unterhaltungen oder Adressbücher um Profilbildstatus und Bild-URL. Prüfen Sie, ob ein Profilbild existiert, bevor Sie es laden oder ein Standardbild anzeigen.
Schreiben Sie die zurückgegebene Profilbild-URL in bestehende Kontaktdatensätze, damit Vertrieb, Support und Betrieb dasselbe, vollständigere Kundenprofil sehen.
Übernehmen Sie Registrierungsstatus, Profilbildstatus und Bildattribute in manuelle Prüfwarteschlangen als zusätzliches Signal für die Vollständigkeit eines Datensatzes.
Bilden Sie Gruppen aus Registrierung, vorhandenem Profilbild und Profilergebnissen, um Listen zu ordnen und spätere Datenarbeit zu planen.
Kurze Antwort
WhatsApp-Profilbildanalyse liefert ob die Nummer ein WhatsApp-Profilbild hat, und in diesem Fall die Bild-URL. Verwenden Sie service_type ws_profile (der Parameter, der ein Produkt auswählt) mit einer Nummer im E.164-Format, zum Beispiel +17253100591, und lesen Sie die Porträtattribute auf der obersten Ebene derselben API-Antwort.
Klare Grenzen
Produkt-FAQ
Es prüft eine Kennung und liefert ob die Nummer ein WhatsApp-Profilbild hat, und in diesem Fall die Bild-URL in derselben synchronen Antwort.
Guthaben wird nur für abgeschlossene Prüfungen berechnet. Bei fehlgeschlagenen oder unbestimmten Prüfungen wird die Abbuchung nicht einbehalten.
Senden Sie die Kennung, die das Produkt akzeptiert: eine Nummer im E.164-Format für WhatsApp oder eine vollständige E-Mail-Adresse für das E-Mail-Produkt. Ein falsches Format wird vor jeder Berechnung abgelehnt.
Nein. Es gibt nur an, ob in diesem Moment ein Profilbild festgelegt ist. Es sagt nichts darüber aus, ob das Konto genutzt wird oder online ist, und ist keine Erlaubnis, jemanden zu kontaktieren. Einwilligung und geltende Vorschriften bleiben Ihre Verantwortung.
Verwandte Produkte
Bild-ProfilanalyseLaden Sie ein beliebiges Bild hoch und erhalten Sie seine Porträtattribute: geschätztes Alter, Geschlecht, Bildtyp, Haarfarbe und Hautton.
E-Mail-ProfilbildanalysePrüfen Sie, ob ein E-Mail-Konto ein Profilbild hat, und lesen Sie dessen Porträtattribute. Deckt Gmail, Yandex und Mail.ru ab.Erstellen Sie ein Konto, um alle Produkte über das SaaS-Dashboard oder die API zu nutzen: Echtzeitprüfungen und asynchrone Massenprüfungen greifen auf dasselbe Guthaben zu.