TelegramTelegram-KanäleKanal-ScraperAPI-Leitfaden

Telegram Channel API: Kanalinfos, Beiträge, Kommentare und Suche

Sechs neue SocQ-Endpunkte für öffentliche Telegram-Kanäle: Kanalinfos, Beitrags-Feed, einzelne Beiträge, Diskussionskommentare, ähnliche Kanäle und Suche im Kanal, mit Anfragen und Preisen pro Ergebnis.

SocQAktualisiert am 19. November 20267 Min. Lesezeit

Am 2026-11-17 hat SocQ eine Telegram-Plattform mit sechs Endpunkten für öffentliche Telegram-Kanäle hinzugefügt. Zusammen decken sie den gesamten Rechercheablauf ab: einen Kanal prüfen, seinen Feed lesen, bestimmte Beiträge abrufen, die Diskussion unter einem Beitrag lesen, verwandte Kanäle finden und den Verlauf eines Kanals nach einem Begriff durchsuchen.

Dieser Leitfaden zeigt, was jeder Endpunkt zurückgibt, welche Anfrage er erwartet, was er kostet und wann er sich eignet. Jeder Endpunkt arbeitet mit öffentlichen t.me-Links und läuft als asynchrone SocQ-Aufgabe.

Kurze Antwort: Senden Sie einen öffentlichen Kanal- oder Beitragslink an einen der sechs Endpunkte POST /v1/telegram/... mit Authorization: Bearer $SOCQ_API_KEY. Speichern Sie die zurückgegebene task_id, fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie die Datensätze in data.results.items. Jeder Endpunkt wird pro Ergebnis abgerechnet: 0,3 oder 0,5 Credits pro Zeile, also $0,0015 oder $0,0025 bei $0,005 pro Credit.

Die sechs neuen Telegram-Endpunkte

EndpunktRückgabeEingabePreis
Channel InfoTitel, Beschreibung, Avatar, Verifizierungsabzeichen, AbonnentenzahlBis zu 50 Kanallinks0,5 Credits ($0,0025) pro Kanal
Channel ScraperBeiträge, neueste zuerst, mit Text, Zeit, Aufrufen, Reaktionssummen, Fotos und VideosEin Kanallink0,3 Credits ($0,0015) pro Beitrag
Post DetailBestimmte Beiträge mit vollständigem Text, Zeit, Aufrufen, Reaktionen und MedienBis zu 50 Beitragslinks0,5 Credits ($0,0025) pro Beitrag
CommentsBis zu 100 Kommentare aus der verknüpften Diskussionsgruppe, mit Autor, Text, Zeit, Reaktionen und AntwortzielEin Beitragslink0,3 Credits ($0,0015) pro Kommentar
Similar ChannelsKanäle, die Telegram neben einem Kanal empfiehlt, mit Nutzername, Titel, Abzeichen und AbonnentenEin Kanallink0,5 Credits ($0,0025) pro Kanal
Channel SearchBeiträge aus dem gesamten Verlauf eines Kanals, die zu einem Wort oder einer Phrase passenEin Kanallink + Suchbegriff0,5 Credits ($0,0025) pro Treffer

Alle sechs berechnen nur die zurückgegebenen Zeilen, ohne Grundgebühr pro Anfrage.

Telegram Channel Info: Kanäle in großer Zahl prüfen

Die Telegram Channel Info API ruft öffentliche Kanäle über einen t.me/name- oder t.me/s/name-Link ab und liefert eine Zeile pro Kanal: Name, Beschreibung, Avatar, Verifizierungsabzeichen und Abonnentenzahl (metrics.followers_count). Nutzen Sie sie, um einen Kanal vor einem Sponsoring zu prüfen, eine Beobachtungsliste mit News- oder Krypto-Kanälen zu aktualisieren oder anderswo gesammelte Kanallinks anzureichern. Die Rohdatei des Ergebnisses enthält außerdem die Anzahl der Fotos, Videos und Links, die jeder Kanal geteilt hat.

curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://t.me/durov", "https://t.me/tginfo"]
  }'

Senden Sie bis zu 50 Links pro Anfrage. Links zu nicht öffentlichen Kanälen werden übersprungen; die Aufgabe schlägt nur dann mit Rückerstattung fehl, wenn keiner davon gelesen werden kann. Siehe die Channel-Info-Dokumentation.

Telegram Channel Scraper: Einen Kanal-Feed lesen

Die Telegram Channel Scraper API liest einen öffentlichen Kanal vom neuesten Beitrag an rückwärts. Jeder Beitrag enthält Text, Veröffentlichungszeit, Aufrufzahl, die Summe seiner Emoji- und Star-Reaktionen sowie angehängte Fotos und Videos. Rufen Sie die letzten Tage für einen täglichen Digest ab oder erhöhen Sie das Limit, um den Verlauf eines Kanals nachzuladen.

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
  }'

results_limit ist standardmäßig 20 und akzeptiert 1 bis 1.000. Ein Kanal, der nicht gelesen werden kann, schlägt mit Rückerstattung fehl. Siehe die Channel-Scraper-Dokumentation.

Telegram Post Detail: Bekannte Beiträge aktualisieren

Wenn Sie bereits wissen, welche Beiträge wichtig sind, nimmt die Telegram Post Detail API deren Links entgegen und liefert jeden vollständig: Text, Veröffentlichungszeit, Aufrufe, Reaktionssumme, Fotos und Videos. Beiträge aus verschiedenen Kanälen lassen sich in einer Anfrage mischen, was sich zum Aktualisieren der Zahlen beobachteter Ankündigungen oder Kampagnenbeiträge eignet. Die Rohdatei des Ergebnisses behält die Reaktionszahlen pro Emoji und die Weiterleitungsquelle.

curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://t.me/durov/510"]
  }'

Senden Sie bis zu 50 Links im Format t.me/channel/post_id. Gelöschte Beiträge und Beiträge in privaten Kanälen werden übersprungen. Siehe die Post-Detail-Dokumentation.

Telegram Comments: Die Diskussion unter einem Beitrag lesen

Kanäle, die eine Diskussionsgruppe verknüpfen, lassen Leser unter jedem Beitrag kommentieren. Die Telegram Comments API liest diesen Thread für einen Beitrag und liefert jeden Kommentar mit Autorenname, Text, Zeit, Reaktionssumme und dem Kommentar, auf den er antwortet (parent_id). Nutzen Sie sie, um zu sehen, wie eine Community auf eine Ankündigung reagiert hat, oder um Kommentare in einen Support- oder Recherche-Workflow einzuspeisen.

curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://t.me/tginfo/4455",
    "results_limit": 100
  }'

results_limit ist standardmäßig 100, was zugleich das Maximum ist. Sie zahlen nur für die zurückgegebenen Kommentare. Siehe die Comments-Dokumentation.

Telegram Similar Channels: Eine Nische kartieren

Telegram zeigt auf jedem öffentlichen Kanal eine Reihe verwandter Kanäle. Die Telegram Similar Channels API liefert diese Liste für einen Kanal, meist etwa zehn Einträge, in der Reihenfolge, in der Telegram sie anzeigt, jeweils mit Nutzername, Titel, Verifizierungsabzeichen und Abonnentenzahl. Starten Sie bei einem Wettbewerber oder einem Kanal, auf dem Sie bereits werben, um eine Medienliste zu erweitern.

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

Siehe die Similar-Channels-Dokumentation.

Telegram Channel Search: Den Verlauf eines Kanals durchsuchen

Die Telegram Channel Search API durchsucht den gesamten Verlauf eines öffentlichen Kanals nach einem Wort oder einer Phrase und liefert die passenden Beiträge mit Text, Datum, Aufrufen und Reaktionen. Prüfen Sie, ob ein einflussreicher Kanal ein Projekt je erwähnt hat, oder sammeln Sie jeden Beitrag, den ein Kanal zu einem Launch veröffentlicht hat.

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

results_limit ist standardmäßig 20 und akzeptiert 1 bis 100. Eine Suche ohne Treffer kostet nichts. Fotos in Suchergebnissen verlinken auf den Beitrag, in dem sie erscheinen. Siehe die Channel-Search-Dokumentation.

Authentifizierung und asynchroner Aufgabenablauf

Jede Anfrage enthält Ihren API-Schlüssel und einen JSON-Content-Type:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jeder Übermittlungsaufruf startet eine Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Die Antwort auf die Übermittlung enthält data.task_id und data.status. Fragen Sie die Aufgabe mit demselben Schlüssel ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Solange die Aufgabe queued, running oder failed ist, enthält die Antwort nur Aufgabenmetadaten; bei failed lesen Sie error_message. Bei succeeded enthält dieselbe Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn has_more den Wert true hat, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. fields akzeptiert bis zu 50 kommagetrennte Felder oder Punktpfade, wenn Sie eine kleinere Projektion möchten.

Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie daher mit derselben task_id fort, statt erneut zu übermitteln und für ein Duplikat zu zahlen. Um Polling zu vermeiden, fügen Sie dem Übermittlungskörper callback_url hinzu; SocQ sendet einen POST mit einer Aufgabenzusammenfassung, wenn die Aufgabe abgeschlossen ist, und Sie lesen die Datensätze dann über den Aufgaben-Endpunkt.

Was ein typischer Auftrag kostet

  • 50 Kanäle mit Channel Info prüfen: 50 × 0,5 = 25 Credits, $0,125.
  • 1.000 Beiträge eines Kanals nachladen: 1.000 × 0,3 = 300 Credits, $1,50.
  • 100 Kommentare unter einer Ankündigung lesen: 30 Credits, $0,15.
  • Einen Kanal durchsuchen und 20 Treffer erhalten: 10 Credits, $0,05.

FAQ

Funktionieren diese Endpunkte mit privaten Kanälen oder Gruppen?

Nein. Sie lesen öffentliche Kanäle über ihre t.me-Links. Channel Info und Post Detail überspringen Links, die sie nicht lesen können, und Comments liest die Diskussionsgruppe, die ein öffentlicher Kanal mit seinen Beiträgen verknüpft.

Wie weit zurück reicht der Channel Scraper?

Er liest die neuesten Beiträge zuerst, und results_limit akzeptiert bis zu 1.000 Beiträge pro Anfrage. Um ältere Beiträge zu einem bestimmten Thema zu finden, nutzen Sie Channel Search, das den gesamten Verlauf des Kanals durchsucht.

Was umfasst die Reaktionszahl?

Bei Kanalbeiträgen enthält metrics.likes_count die Summe der Emoji- und Star-Reaktionen. Die Rohdatei des Ergebnisses von Post Detail behält die Zahlen pro Emoji.

Zahle ich für Kanäle oder Beiträge, die nicht gefunden werden?

Nein. Abgerechnet wird pro zurückgegebener Zeile, ohne Grundgebühr. Eine Channel Search ohne Treffer kostet nichts, und eine Aufgabe, bei der keiner der Links gelesen werden kann, schlägt mit Rückerstattung fehl.

Wie finde ich neue Kanäle zum Beobachten?

Starten Sie bei einem Kanal, den Sie kennen, rufen Sie Similar Channels auf und übergeben Sie die zurückgegebenen Links an Channel Info, um die Abonnentenzahlen zu vergleichen. Alle Endpunkte finden Sie auf der Telegram-Plattformseite, aktuelle Tarife auf der Preisseite.

TELEGRAM API

Workflow mit einer öffentlichen Telegram-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

Telegram-APIs ansehen