· 2 min read
Telegram-Nummernprüfer — Konten massenhaft über Plattform oder API prüfen | CheckNumber.AI
Schritt-für-Schritt-Anleitung zur Massenprüfung der Telegram-Registrierung per API oder CSV-Upload. Mit Codebeispielen. Ab ca. $2,50 / 10.000 Prüfungen.
Prüfen Sie, ob eine globale Rufnummer bei Telegram registriert ist.
Telegram zählt zu den größten Messaging-Plattformen — für Marketing, Compliance und Datenqualität ist die Verifikation der Registrierung wichtig.
Warum Telegram-Registrierung prüfen?
- Marketinglisten: Kontakte identifizieren, die Telegram nutzen
- Datenvalidierung: Prüfen, ob Kundennummern wirklich bei Telegram aktiv sind
- Compliance: Datenbankqualität für B2B und B2C
- Lead-Scoring: Priorität für aktiv nutzende Leads
Telegram Bulk Number Checker API
Offizielle Doku: Telegram Bulk CheckNumber API.
CheckNumber arbeitet in Batches: .txt/.csv hochladen (eine E.164 pro Zeile), Task-Status pollen, Ergebnisdatei laden. Alle Calls mit Header X-API-Key.
Task erstellen
POST https://api.checknumber.ai/v1/tasks
| Parameter | Beschreibung |
|---|---|
file | Eine Nummer pro Zeile, E.164 |
task_type | tg — Telegram-Registrierungsprüfung |
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="tg"'
Status abfragen
POST https://api.checknumber.ai/v1/gettasks
| Parameter | Beschreibung |
|---|---|
task_id | Beim Anlegen zurückgegeben |
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Bei status = exported Ergebnis über result_url laden.
Ergebnisfelder
| Feld | Beschreibung | Beispiel |
|---|---|---|
Number | E.164 | +41798284651 |
telegram | Registriert | yes, no |
Task-Payload
| Feld | Beschreibung |
|---|---|
created_at | Erstellzeit |
updated_at | Letzte Aktualisierung |
task_id | Task-ID |
status | pending, processing, exported |
total | Zeilen gesamt |
success | Erfolgreich |
failure | Fehlgeschlagen |
result_url | Download bei exported |
HTTP-Codes
| Status | Abrechnung | Bedeutung |
|---|---|---|
200 | kostenpflichtig | Task angelegt oder Status geliefert |
400 | frei | Ungültige Parameter/Datei |
500 | frei | Serverfehler — später wiederholen |
Integrations-Checkliste
- Nur E.164.
/v1/gettaskspollen bis Endstatus.- Aktuelle Limits/Felder in der offiziellen Doku.
- Preise: pricing.
FAQ
Wie schnell sind 1 Mio. Nummern?
Die Verarbeitungszeit hängt von der Plattform-Last und den Rate-Limits ab.
Werden Nachrichten gesendet?
Nein — nur Registrierungsstatus, keine Benachrichtigungen.
Mehrere Plattformen in einem Task?
Nein — task_type=tg nur Telegram; andere Plattformen eigene Tasks (parallel möglich).
Credits reichen nicht mehr während des Tasks?
Bearbeitung mit vorhandenem Guthaben; verarbeitete Zeilen werden berechnet, Rest ggf. als fehlgeschlagen markiert.