Zurück zu den APIs
Öffentliche Telegram-Kanaldaten

Telegram Public Data API

Lesen Sie öffentliche Telegram-Kanäle über ihre t.me-Links: Kanalprofile mit Abonnentenzahl, Posts mit Aufrufen und Reaktionen, einzelne Posts, Kommentare aus Diskussionsgruppen, ähnliche Kanäle und eine Suche über die gesamte Historie.

Verfügbare Telegram-APIs

Channel Info, Channel Scraper, Similar Channels und Channel Search starten mit einem Kanal-Link, Post Detail und Comments mit einem Post-Link, und jedes Ergebnis enthält Links, die Sie direkt an den nächsten Endpunkt übergeben können.

Welche Telegram-Daten können Sie abrufen?

Jeder Endpunkt liefert stabile SocQ-Datensätze aus dem, was ein öffentlicher Kanal jedem Besucher zeigt.

Kanalprofile

Benutzername, Titel, Beschreibung, Avatar, Verifizierungsabzeichen und Abonnentenzahl als ganze Zahl, für bis zu 50 Kanäle pro Anfrage.

Posts und Medien

Text, Veröffentlichungszeit, Aufrufe, Reaktionssummen einschließlich bezahlter Star-Reaktionen sowie Foto- und Videolinks, entweder bis zu 1000 Posts ab dem neuesten oder bis zu 50 Posts per Link.

Kommentare aus Diskussionsgruppen

Autorname, Text, Zeit und Reaktionen für bis zu 100 Kommentare pro Post, mit parent_id und post_id zum Rekonstruieren von Antwort-Threads.

Ähnliche Kanäle

Die Kanäle, die Telegram neben einem Kanal empfiehlt, meist rund zehn, in Telegrams Reihenfolge und mit exakter Abonnentenzahl.

Suche innerhalb eines Kanals

Bis zu 100 Posts, die irgendwo in der Historie eines Kanals ein Wort oder eine Phrase enthalten, jeweils mit Aufrufen und Reaktionen.

SocQ und die Telegram API

Die eigene API von Telegram dient der Entwicklung von Telegram-Apps und Bots. SocQ liefert öffentliche Kanaldaten als normalisierte Datensätze, die Sie speichern, vergleichen und kombinieren können.

FunktionSocQTelegram API
ZugangSocQ-API-SchlüsselTelegram-App-ID mit angemeldetem Konto oder ein Bot-Token
EingabeÖffentliche t.me-Links zu Kanälen und PostsTelegram-Objektkennungen, die in einer Client-Sitzung aufgelöst werden
AusgabeNormalisierte JSON-Datensätze mit ganzzahligen WertenNative Telegram-Objekte
AblaufAsynchrone Tasks mit gespeicherten, seitenweise lesbaren ErgebnissenLive-Aufrufe aus Ihrem eigenen Client

So funktioniert die Telegram API

Alle sechs Endpunkte nutzen denselben asynchronen Ablauf aus Senden, Abfragen und Lesen.

  1. 1. Mit einem Link starten

    Senden Sie einen Kanal-Link an Channel Info, Channel Scraper, Similar Channels oder Channel Search, einen Post-Link an Post Detail oder Comments.

  2. 2. Den Task abfragen

    Fragen Sie mit der zurückgegebenen task_id /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt.

  3. 3. Ergebnisse verketten

    Geben Sie Post-urls aus Channel Scraper oder Channel Search an Comments oder Post Detail weiter und Kanal-urls aus Similar Channels an Channel Info.

Mit einer API-Anfrage starten

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel. Channel Scraper liefert standardmäßig 20 Posts und akzeptiert bis zu 1000.

curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

# Danach die Kommentare unter einem Post lesen:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# GET /v1/tasks/{task_id} abfragen

Typische Anwendungsfälle der Telegram API

Prüfung vor Sponsorings

Prüfen Sie Abonnentenzahl und Verifizierung mit Channel Info und die jüngsten Aufrufe mit Channel Scraper, bevor Sie für eine Platzierung bezahlen.

Kanal-Digests und Alerts

Sammeln Sie regelmäßig die neuesten Posts von Nachrichten-, Markt- oder Projektkanälen und leiten Sie neue Texte und Links in Zusammenfassungen oder Alerts.

Community-Feedback

Holen Sie die Kommentare unter Ankündigungen und gruppieren Sie sie nach Themen, um Reaktionen und wiederkehrende Fragen zu erkennen.

Nischen kartieren

Bewegen Sie sich mit Similar Channels von Startkanälen nach außen und bauen Sie eine Liste verwandter Kanäle mit ihrer Reichweite auf.

Erwähnungen recherchieren

Durchsuchen Sie einflussreiche Kanäle nach einer Marke, einem Token oder einem Produkt und messen Sie die Aufmerksamkeit jeder Erwähnung.

Umfang der Daten

Die Ergebnisse geben wieder, was öffentliche Telegram-Kanäle zum Erfassungszeitpunkt jedem Besucher zeigen.

  • Alle Endpunkte lesen öffentliche Kanäle, adressiert über den Benutzernamen eines Kanals oder eine Postnummer innerhalb eines Kanals.
  • Kommentare stammen aus der Diskussionsgruppe, die ein Kanal mit seinen Posts verknüpft, bis zu 100 pro Post in einem Task.
  • Similar Channels liefert die Empfehlungen, die Telegram für einen Kanal anzeigt, meist rund zehn.
  • Channel Search durchsucht pro Anfrage einen Kanal über seine gesamte Historie und liefert bis zu 100 Treffer.
  • Zahlen sind Momentaufnahmen zum Zeitpunkt collected_at, und Foto- und Videolinks sind temporär, laden Sie benötigte Dateien also zeitnah herunter.

Häufige Fragen zur Telegram API

Was ist die Telegram API?

Die Telegram API ist eine Gruppe von SocQ-Endpunkten, die öffentliche Telegram-Kanäle über ihre Links lesen und Kanalprofile, Posts, Kommentare aus Diskussionsgruppen, ähnliche Kanäle und Suchergebnisse innerhalb eines Kanals als normalisierte JSON-Datensätze liefern.

Welche Telegram-APIs sind verfügbar?

Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API und Telegram Channel Search API.

Brauche ich ein Telegram-Konto oder ein Bot-Token?

Nein. Anfragen nutzen Ihren SocQ-API-Schlüssel und einen öffentlichen Kanal- oder Post-Link.

Welche Link-Formate werden akzeptiert?

Kanal-Links wie t.me/durov oder t.me/s/durov, ihre Varianten mit telegram.me und telegram.dog sowie Post-Links wie t.me/durov/510 für Post Detail und Comments.

Wie werden Abonnenten- und Aufrufzahlen geliefert?

Als ganze Zahlen. Telegrams Kurzformen wie 9.95M oder 661K werden in Ganzzahlen umgewandelt, und Similar Channels liefert exakte Abonnentenzahlen.

Wie werden die Endpunkte berechnet?

Channel Info, Post Detail, Similar Channels und Channel Search kosten 0,5 Credits pro zurückgegebenem Ergebnis, Channel Scraper und Comments 0,3 Credits pro Post oder Kommentar. Nicht lesbare Links werden übersprungen oder erstattet, und Posts ohne Kommentare sowie Suchen ohne Treffer kosten nichts.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.