· 3 min read
Tiefen-API für WhatsApp-Massen-Nummernprüfung
Überprüfen Sie globale Telefonnummern auf WhatsApp-Konten und rufen Sie detaillierte demografische Informationen ab, einschließlich Geschlecht, Alter, Haarfarbe und Profilbildanalyse.
Überprüfen Sie die Demografie und Profilattribute globaler Telefonnummern auf WhatsApp, einschließlich Geschlecht, Alter und Profilbildanalyse.
API-URL
POST https://api.checknumber.ai/v1/tasks
Hauptmerkmale
Die Tiefen-API (Deep API) für die WhatsApp-Massen-Nummernprüfung bietet leistungsstarke Analysefunktionen:
Demografische Analyse
Die API liefert detaillierte demografische Informationen aus Profilbildern, einschließlich:
- Geschlechtserkennung
- Altersschätzung
- Haarfarbenanalyse
- Erkennung der Hautfarbe / ethnischen Zugehörigkeit
Profilattribute
Umfassende Profilinformationen, einschließlich:
- Überprüfung des WhatsApp-Kontostatus
- Abrufen der Profilbild-URL
- Klassifizierung des Profilbildtyps
- Kontoverifizierungsstatus
Massenverarbeitung
Verarbeiten Sie mehrere Nummern gleichzeitig durch Datei-Upload, was eine effiziente Analyse in großem Maßstab ermöglicht.
Nutzungsschritte
Datei-Upload
Laden Sie eine Textdatei hoch, die Telefonnummern im E.164-Format enthält:
Beispielanfrage
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_avatar"'
Anfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
file | file | Datei mit zu überprüfenden Nummern, eine Nummer pro Zeile |
task_type | string | ws_avatar — Attribute aus dem Profilbild |
Statusprüfung
Überwachen Sie den Verarbeitungsstatus Ihrer Aufgabe:
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Antwortbeispiele
Antwort zur Aufgabenerstellung
{
"created_at": "2024-10-19T18:24:56.450567423Z",
"updated_at": "2024-10-19T18:24:56.450567423Z",
"task_id": "cs9viu7i61pkfs4oavvg",
"status": "pending",
"total": 0,
"success": 0,
"failure": 0
}
Antwort zum Verarbeitungsstatus
{
"created_at": "2024-10-19T18:24:56.450567423Z",
"updated_at": "2024-10-19T18:33:22.86152082Z",
"task_id": "cs9viu7i61pkfs4oavvg",
"status": "processing",
"total": 20000,
"success": 6724,
"failure": 0
}
Antwort zur abgeschlossenen Aufgabe
{
"created_at": "2024-10-19T18:24:56.450567423Z",
"updated_at": "2024-10-19T18:53:43.141760071Z",
"task_id": "cs9viu7i61pkfs4oavvg",
"status": "exported",
"total": 20000,
"success": 20000,
"failure": 0,
"result_url": "https://example-link-to-results.xlsx"
}
Ergebnisfelder der WhatsApp-Nummernprüfung
| Feld | Beschreibung | Beispiel |
|---|---|---|
Number | Telefonnummer im E.164-Format | +491701234567 |
age | Geschätzter Altersbereich basierend auf dem Profilbild | 25 |
avatar | URL des WhatsApp-Profilbilds | https://checknumber.ai/avatar.jpg |
category | Typklassifizierung des Profilbilds | Einzelporträt, Haustier-Avatar, Objekt usw. |
gender | Anhand des Profilbilds erkanntes Geschlecht | male, female |
hair_color | Anhand des Profilbilds erkannte Haarfarbe | black, brown, blonde usw. |
whatsapp | Ob die Nummer ein aktives WhatsApp-Konto hat | yes, no |
API-Antwortformat
| Feld | Beschreibung |
|---|---|
created_at | Zeitstempel der Aufgabenerstellung |
updated_at | Zeitstempel der letzten Statusaktualisierung der Aufgabe |
task_id | Eindeutige Aufgabenkennung |
status | Aufgabenstatus: pending/processing/completed/exported |
total | Gesamtzahl der verarbeiteten Telefonnummern |
success | Anzahl der erfolgreich identifizierten Nummern |
failure | Anzahl der fehlgeschlagenen Verarbeitungen |
result_url | (Optional) Download-URL für Ergebnisse, wenn der Status “exported” ist |
Statuscodes
| Status | Beschreibung |
|---|---|
200 | charge, Erfolgreiche Anfrage, Aufgabe erstellt oder Status abgerufen |
400 | free, Fehlerhafte Anfrage, ungültige Parameter oder Dateiformat |
500 | free, Interner Serverfehler, versuchen Sie es später erneut |
Hinweise zur Integration
- Jede Zeile in der Eingabedatei sollte eine Telefonnummer im E.164-Format enthalten.
- Überwachen Sie den Aufgabenstatus mithilfe der bereitgestellten
task_id. - Laden Sie die Ergebnisse von der
result_urlherunter, wenn der Status “exported” ist. - Behandeln Sie verschiedene Statuscodes in Ihrer Anwendung entsprechend.
Häufig gestellte Fragen (FAQ)
1. Wie hoch ist die Verarbeitungskapazität der API?
Die API kann große Mengen von Nummern effizient verarbeiten und bietet Echtzeit-Statusaktualisierungen zum Verarbeitungsfortschritt.
2. In welchem Format sollte die Eingabedatei vorliegen?
Die Eingabedatei sollte eine Textdatei sein, die eine Telefonnummer pro Zeile im E.164-Format (z. B. +491701234567) enthält.
3. Wie genau ist die demografische Analyse?
Die demografische Analyse basiert auf einer fortschrittlichen KI-Verarbeitung von Profilbildern und liefert Schätzungen für Alter, Geschlecht und andere Attribute, sofern diese verfügbar sind.
4. Was bedeuten die API-Statuscodes?
Die API verwendet standardmäßige HTTP-Statuscodes, um Erfolg oder Misserfolg anzuzeigen:
200: Erfolgreiche Anfrage (wird berechnet)400: Ungültige Parameter oder ungültiges Dateiformat (kostenlos)500: Interner Serverfehler (kostenlos)
5. Was kostet die Tiefen-API (Deep API)?
Der Preis beträgt 6 USD pro 10.000 Nummern. Diese API-Antwortinformationen umfassen:
- Überprüfung des WhatsApp-Kontostatus
- Geschlechtserkennung
- Altersschätzung
- Profilbild-Typanalyse
- Ethnien-Erkennung
- Haarfarbenanalyse
Für weitere Informationen zu Preisen und zur Verarbeitung größerer Volumen kontaktieren Sie uns bitte.