Telegram Massenprüfer für Avatar, Alter & Geschlecht API: Profilanalyse

Prüfen Sie für die eingegebenen internationalen Telefonnummern Avatarinformationen der Telegram-Konten, einschließlich Kontoaktivitaet, Profilbild-URL, Geschlecht, Alter, Haarfarbe und Hautfarbe.

Codebeispiel zum Hochladen der Prüfdatei:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="tg_avatar"'

Codebeispiel zum Prüfen des Aufgabenstatus:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Antwort nach erfolgreichem Hochladen der Prüfdatei

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Antwort waehrend der Verarbeitung

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Antwort nach Abschluss der Aufgabe einschließlich Download-URL für die Ergebnisse.

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Anfrage-URL zum Hochladen der Datei

POST https://api.checknumber.ai/v1/tasks

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
file	file, Hochzuladende Datei; jede Zeile muss eine Telefonnummer im E.164-Format enthalten
task_type	string, Aufgabentyp; setzen Sie ihn auf “tg_avatar”

Anfrage-URL zum Prüfen des Aufgabenstatus

POST https://api.checknumber.ai/v1/gettasks

Anfrageparameter zum Prüfen des Aufgabenstatus

Parameter	Beschreibung
task_id	string, Aufgaben-ID aus der Aufgabenerstellung

Ergebnisfelder

Feld	Beschreibung	Beispiel
Number	Telefonnummer im E.164-Format	+41798284651
telegram	Ob die Nummer ein aktives Telegram-Konto hat	yes, no
avatar	URL des Telegram-Profilbilds	https://example.com/avatar.jpg
age	Geschätzte Altersspanne anhand des Profilbilds	25
gender	Aus dem Profilbild ermitteltes Geschlecht	male, female
category	Typklassifizierung des Profilbilds	Einzelportraet, Tier-Avatar, Objekt usw.
hair_color	Aus dem Profilbild ermittelte Haarfarbe	black, brown, blonde, etc.
skin_color	Aus dem Profilbild ermittelte Hautfarbe	white, black, etc.

Antwortformat

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung
updated_at	Zeitstempel der letzten Statusaktualisierung
task_id	Eindeutige Aufgabenkennung
user_id	Benutzer-ID
status	Aufgabenstatus: pending: In Warteschlange processing: Wird verarbeitet exported: Ergebnisse stehen zum Download bereit failed: Aufgabe fehlgeschlagen, der abgebuchte Betrag wird automatisch erstattet
total	Insgesamt verarbeitete Telefonnummern
success	Erfolgreich identifizierte Nummern
failure	Nummern mit fehlgeschlagener Verarbeitung
result_url	(Optional) Download-URL für Ergebnisse bei Status exported
actual_amount	(Optional) Tatsächlich abgerechneter Betrag, verfügbar nach Abrechnung der Aufgabe
estimated_amount	(Antwort bei Aufgabenerstellung) Geschätzter Betrag; die endgültige Abrechnung erfolgt nach Abschluss der Aufgabe

Statuscodes

Status	Beschreibung
200	free, Anfrage erfolgreich (z. B. Statusabfrage)
202	charge, Aufgabe erfolgreich erstellt; der geschätzte Betrag wird abgebucht
400	free, Ungültige Anfrage: Parameter oder Dateiformat fehlerhaft, Aufgabentyp nicht unterstützt oder weniger gültige Einträge als die Mindestmenge
401	free, Fehlender oder ungültiger API-Schlüssel
402	free, Unzureichendes Guthaben
404	free, Aufgabe nicht gefunden
413	free, Hochgeladene Datei zu groß
500	free, Interner Serverfehler; bitte später erneut versuchen