cURL-Anfrage
POST /api/v1/bulk-taskscurl -X POST "https://tgvalidator.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=tg_username_batch \
-F file=@usernames.txt Live-Demo
POST /api/v1/bulk-tasksservice_type=tg_username_batchMassenprodukt tg_username_batch
Telegram-Massenprüfung von Benutzernamen
Laden Sie eine Liste mit Telegram-Benutzernamen hoch und bestätigen Sie, welche zu echten Konten gehören.
Eine Ergänzung für ganze große Listen – für wenige Nummern antwortet die Echtzeitprüfung in derselben Anfrage. Echtzeitprüfung →
API-Vertrag
Zwei Schritte: Datei übermitteln, dann Aufgabe abfragen
Beim Übermitteln wird sofort eine Aufgaben-ID zurückgegeben; fragen Sie die Aufgabe über diese ID ab, und sobald sie erfolgreich ist, enthält die Antwort den Download-Link für die Ergebnisdatei. Jede Anfrage wird mit ihrer eigenen Antwort gezeigt.
1. Datei übermitteln
Die Aufgaben-ID kommt sofort zurück, mit preparing auf true, während die Datei im Hintergrund vorbereitet wird: Ungültige Zeilen, Duplikate und – bei Nummernaufgaben – Nummern ohne Ländervorwahl oder aus einem anderen Land werden entfernt und nicht berechnet. Für die übermittelten Zeilen wird Guthaben reserviert und bei Abschluss abgerechnet; die Differenz wird erstattet.
Antwort: Aufgabe erstellt
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "tg_username_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"
}
}2. Aufgabe abfragen
Fragen Sie über die Aufgaben-ID ab. Nach Abschluss der Vorbereitung gilt submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, wobei total die geprüfte und berechnete Menge ist. Eine erfolgreiche Antwort enthält die Anzahl der Erfolge und Fehlschläge sowie den Download-Link für die Ergebnisdatei; eine bei der Vorbereitung abgelehnte Aufgabe erhält den Status failed mit reason_detail und wird vollständig erstattet.
cURL-Anfrage
GET /api/v1/bulk-tasks/{id}curl "https://tgvalidator.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Antwort: Aufgabe abgeschlossen
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "tg_username_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"
}
}So läuft es ab
Was mit einer Massenaufgabe passiert
Die Massenprüfung ist keine vergrößerte Echtzeitprüfung – einmal übermitteln, im Hintergrund ausführen, später abholen. Sie müssen die Seite nicht geöffnet lassen; Aufgabenstatus und Ergebnisse bleiben in Ihrem Dashboard.
01Datei hochladen
Eine .txt- oder .csv-Datei mit einer Nummer pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.
02Vorprüfung und Reservierung
Offensichtliche Probleme (eine leere Datei, das falsche Format, zu wenige Zeilen) werden beim Hochladen abgelehnt. Anschließend wird Guthaben reserviert und die Datei im Hintergrund vorbereitet: Ungültige Zeilen, Duplikate und Nummern ohne Ländervorwahl oder aus einem anderen Land werden entfernt, und die Ein-Land-Regel wird geprüft. Eine Datei, die dabei scheitert, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet; andernfalls werden nur die verbleibenden Zeilen geprüft, und die Aufgabe wird bei Abschluss abgerechnet.
03Im Hintergrund ausführen
Die Aufgabe läuft selbstständig – Sie können die Seite gern schließen. Ein Fehlschlag wird sofort gemeldet und vollständig erstattet.
04Ergebnis herunterladen
Holen Sie die Datei auf der Seite der Massenprüfung ab. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis geliefert haben; die Differenz wird erstattet.
Ergebnisfelder
Spalten der Ergebnisdatei
Der Download ist eine einzelne CSV-Datei mit dieser vollständigen Tabelle.
Spalten der Ergebnisdatei
identifier·alex_kim— Der übermittelte Benutzername ohne @ oder t.me/ (z. B. alex_kim).activated·true— Ob der Benutzername zu einem bestehenden Telegram-Konto gehört: true oder false.
Ideal für
Wann Sie dieses Produkt nutzen sollten
- Bereinigung von Benutzernamenlisten
- Bestätigung, dass ein Konto existiert
- Deduplizierung von Community-Listen
- Prüfung einer Liste vor der Community-Ansprache
Kurze Antwort
Was ist die Massen-Benutzernamenprüfung?
Die Telegram-Massenprüfung von Benutzernamen verarbeitet Benutzernamen statt Nummern und bestätigt, ob jeder davon zu einem bestehenden Telegram-Konto gehört. Keine Länderauswahl nötig; ein Benutzername pro Zeile, mit oder ohne das Präfix @ oder t.me/.
Klare Grenzen
Grenzen dieses Produkts
- Es handelt sich nicht um eine Identitätsprüfung. Ein Ergebnis beschreibt den Registrierungsstatus der Nummer auf der Plattform; es kann nicht bestätigen, wem die Nummer gehört.
- Es werden niemals Nachrichtenverlauf, Unterhaltungsinhalte oder private Kontoinhalte geliefert.
- Wählen Sie beim Übermitteln das Land, zu dem Ihre Nummern gehören. Die Liste sollte im Wesentlichen aus diesem einen Land stammen; Nachbarländer mit derselben Vorwahl gelten nicht als länderübergreifend. Eine Liste, die die Anforderungen nicht erfüllt, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet.
- Die Ergebnisse spiegeln den Zeitpunkt der Ausführung wider. Führen Sie die Aufgabe erneut aus, um einen aktuellen Stand zu erhalten – gespeicherte Ergebnisse werden nie automatisch aktualisiert.
- Download-Links laufen ab. Rufen Sie die Datei bald nach Abschluss der Aufgabe ab; ist ein Link abgelaufen, fragen Sie die Aufgabe erneut ab, um einen neuen zu erhalten.
Wann sich die Massenprüfung eignet
Wann sich die Massenprüfung lohnt – und wann die Echtzeitprüfung schneller ist
| Echtzeitprüfung | Massenprüfung | |
|---|---|---|
| Wie viele Nummern | 1 Nummer pro Einzelprüfung; mehrere pro Mehrfachanfrage – genaue Obergrenzen stehen in der API-Dokumentation | Eine ganze große Liste in einer Aufgabe – den aktuellen Größenbereich finden Sie auf der Preisseite |
| Ergebnisse erhalten | Sofort: Einzel- und Mehrfach-Endpunkt antworten in derselben Antwort; das Dashboard liefert sie einzeln | Ergebnisdatei herunterladen, sobald die Aufgabe abgeschlossen ist |
| Land / Region | Keine Einschränkung – beliebig gemischt in einer Anfrage | Beim Übermitteln ein Land/eine Region wählen; die Liste sollte im Wesentlichen aus diesem Land stammen, und zu viele Nummern aus anderen Ländern lassen die Aufgabe mit vollständiger Erstattung fehlschlagen |
| Ergebnisform | JSON, Felder pro Nummer | Ergebnisdatei (eine CSV-Datei mit der vollständigen Tabelle) |
| Typische Nutzung | Formularvalidierung, Abfragen durch Mitarbeitende, Prüfung vor dem Versand | Listenpflege, Filterung vor Kampagnen, Bereinigung gespeicherter Daten |
Produkt-FAQ
Über die Benutzernamenprüfung
Wann sollte ich die Massenprüfung statt einer Echtzeitprüfung nutzen?
Nutzen Sie die Massenprüfung für eine ganze große Liste. Für wenige Nummern antwortet die Echtzeitprüfung in derselben Anfrage, ohne dass eine Aufgabe geplant werden muss.
Was passiert mit ungültigen Nummern in der Datei?
Die Vorprüfung verwirft fehlerhafte Zeilen, sodass sie nie in die abrechenbare Anzahl eingehen. Von den verbleibenden Nummern werden auch diejenigen nicht berechnet, die der vorgelagerte Dienst nicht auflösen kann. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis liefern.
Wie lange dauert eine Aufgabe?
Das hängt von der Anzahl der Nummern und dem Produkt ab. Sie können die Seite nach dem Übermitteln schließen; die Aufgabe läuft im Hintergrund, und das Ergebnis wartet auf der Seite der Massenprüfung auf Sie.
Erhalte ich eine Erstattung, wenn sie fehlschlägt?
Ja. Eine fehlgeschlagene Aufgabe wird vollständig erstattet. Ist die Aufgabe erfolgreich, liefern aber einige Nummern kein Ergebnis, wird dieser Anteil automatisch erstattet. Die Differenz zwischen dem reservierten und dem tatsächlich berechneten Betrag wird immer zurückerstattet.
Erstellen Sie ein Konto, um eine Massenaufgabe zu übermitteln
Massen- und Echtzeitprüfungen greifen auf dasselbe Guthaben zu – es muss nichts zusätzlich aktiviert werden. Registrieren Sie sich und laden Sie Ihre erste Datei auf der Seite der Massenprüfung hoch.