TG Validator
Live-DemoPOST /api/v1/bulk-tasksservice_type=tg_active_batch

Massenprodukt tg_active_batch

Telegram-Massenprüfung der Aktivität

Registrierungsstatus plus Benutzer-ID, Benutzername und aktive Tage – Tage seit der letzten Anzeige als „zuletzt online“ – für eine ganze Liste.

Eine Ergänzung für ganze große Listen – für wenige Nummern antwortet die Echtzeitprüfung in derselben Anfrage. Echtzeitprüfung →

API-Vertrag ansehenRegistrieren

API-Vertrag

Zwei Schritte: Datei übermitteln, dann Aufgabe abfragen

Vollständige API-Dokumentation lesen API-Schlüssel öffnen

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.

cURL-AnfragePOST /api/v1/bulk-tasks
curl -X POST "https://tgvalidator.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_active_batch \
  -F country=US \
  -F file=@numbers.txt
Antwort: Aufgabe erstellt200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_active_batch",
    "status": "processing",
    "country": "US",
    "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-AnfrageGET /api/v1/bulk-tasks/{id}
curl "https://tgvalidator.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Antwort: Aufgabe abgeschlossen200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_active_batch",
    "status": "success",
    "country": "US",
    "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.

  1. 01Datei hochladen

    Eine .txt- oder .csv-Datei mit einer Nummer pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.

  2. 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.

  3. 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.

  4. 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 · 17253100591 — Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).
  • activated · true — Ob die Nummer bei Telegram registriert ist: true oder false. Ist der Wert nicht true, bleiben alle anderen Spalten dieser Zeile leer.
  • uid · 1234567890 — Telegram-Benutzer-ID.
  • username · alex_kim — Benutzername; leer, wenn das Konto keinen hat.
  • activedays · 9 — Tage seit der letzten Anzeige des Kontos als „zuletzt online“, als ganze Zahl – je kleiner, desto aktueller. Verbirgt das Konto seinen genauen Zeitpunkt, gibt Telegram nur einen Bereich preis, und der Wert ist eine Annäherung: 0 (kürzlich), 7 (innerhalb einer Woche), 30 (innerhalb eines Monats) oder 1000 (vor langer Zeit).

Ideal für

Wann Sie dieses Produkt nutzen sollten

Aktive von ruhenden Nummern trennen

activatedactivedays

Unterscheiden Sie kürzlich aktive Kontakte von lange inaktiven, statt eine einzige Strategie auf die gesamte Liste anzuwenden.

Reaktivierungslisten priorisieren

activatedusername

Beginnen Sie mit registrierten Kontakten, die kürzlich aktiv waren und noch einen Benutzernamen haben.

Kampagnenbudget zuteilen

activatedactivedays

Investieren Sie zuerst in kürzlich aktive registrierte Nummern und bewerten Sie das ruhende Segment anschließend separat.

Listenqualität bewerten

activatedactivedaysuid

Kombinieren Sie Registrierung und die Tage seit „zuletzt online“, um zu beurteilen, ob eine Liste noch brauchbar ist.

Kurze Antwort

Was ist die Massen-Aktivitätsprüfung?

Die Telegram-Massenprüfung der Aktivität liefert zusätzlich zum Registrierungsstatus die Benutzer-ID, den Benutzernamen und wie viele Tage seit der letzten Anzeige jedes Kontos als „zuletzt online“ vergangen sind. Registriert heißt nicht, dass das Konto noch genutzt wird – dieses Produkt trennt lange ruhende Nummern vom Rest, damit Ihr Budget an Menschen geht, die die Nachricht tatsächlich sehen.

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üfungMassenprüfung
Wie viele Nummern1 Nummer pro Einzelprüfung; mehrere pro Mehrfachanfrage – genaue Obergrenzen stehen in der API-DokumentationEine ganze große Liste in einer Aufgabe – den aktuellen Größenbereich finden Sie auf der Preisseite
Ergebnisse erhaltenSofort: Einzel- und Mehrfach-Endpunkt antworten in derselben Antwort; das Dashboard liefert sie einzelnErgebnisdatei herunterladen, sobald die Aufgabe abgeschlossen ist
Land / RegionKeine Einschränkung – beliebig gemischt in einer AnfrageBeim Ü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
ErgebnisformJSON, Felder pro NummerErgebnisdatei (eine CSV-Datei mit der vollständigen Tabelle)
Typische NutzungFormularvalidierung, Abfragen durch Mitarbeitende, Prüfung vor dem VersandListenpflege, Filterung vor Kampagnen, Bereinigung gespeicherter Daten

Echtzeitprüfung · Preise ansehen

Produkt-FAQ

Über die Aktivitätsprü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.

Registrieren Preise ansehen