Telegram Post Detail
Telegram Post Detail ist der vollständige Datensatz eines einzelnen Kanal-Posts mit Text, Veröffentlichungszeit, Aufrufzahl, Reaktionssumme und angehängten Fotos oder Videos. Wer diese Werte für bereits bekannte Posts ausliest, kann Kampagnenzahlen aktualisieren, festhalten, was eine Ankündigung gesagt hat, und Links in den eigenen Daten mit Reichweitenwerten versehen.
Funktionen der Telegram Post Detail API
- Posts aus vielen Kanälen auf einmalurls nimmt bis zu 50 Post-Links der Form t.me/channel/post_id an, und diese dürfen in derselben Anfrage aus verschiedenen Kanälen stammen.
- Aktuelle Aufrufe und Reaktionenmetrics.views_count und metrics.likes_count liefern Aufrufzahl und Reaktionssumme des Posts zum Erfassungszeitpunkt als ganze Zahlen.
- Voller Text und Medientext enthält den gesamten Post, und media listet jedes Foto oder Video mit Typ und Datei-URL.
- Fehlende Posts ohne Kosten übersprungenGelöschte Posts und Posts in privaten Kanälen werden ausgelassen und kosten nichts; der Task schlägt nur dann mit Erstattung fehl, wenn sich keiner der Links lesen lässt.
Parameter der Telegram Post Detail API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Bis zu 50 Telegram-Post-Links der Form https://t.me/channel/post_id, etwa https://t.me/durov/510. Links aus verschiedenen öffentlichen Kanälen lassen sich mischen. |
So verwenden Sie die Telegram Post Detail API
Senden Sie die gewünschten Post-Links und lesen Sie für jeden gefundenen Post einen vollständigen Datensatz.
- Senden Sie {"urls": ["https://t.me/durov/510"]} per POST an /v1/telegram/post-detail.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Posts aus results.items und übergeben Sie results.next_cursor, um die nächste Seite zu laden, solange has_more true ist.
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"]}'Anwendungsfälle der Telegram Post Detail API
- Kampagnenzahlen auffrischen: Bewahren Sie die Links gesponserter oder ankündigender Posts auf und erfassen Sie sie regelmäßig neu, um Aufrufe und Reaktionen im Zeitverlauf zu verfolgen.
- Festhalten, was ein Post gesagt hat: Speichern Sie den genauen Text und die Veröffentlichungszeit eines Posts, der in einem Bericht, einem Streitfall oder einer Meldung zitiert wird, zusammen mit collected_at.
- Geteilte Post-Links anreichern: Machen Sie aus Post-Links, die Sie in Chats, Artikeln oder Tabellen gesammelt haben, vollständige Datensätze mit Quellkanal, Reichweite und Medien.
Profi-Tipps zur Telegram Post Detail API
- Bündeln Sie Links aus vielen Kanälen in einer Anfrage mit bis zu 50 Einträgen, statt sie einzeln zu senden.
- author.username nennt den Kanal, zu dem jeder Post gehört, und erleichtert das Gruppieren eines gemischten Batches nach Kanal.
- Um die neuesten Posts eines Kanals ohne bekannte Links zu sammeln, nutzen Sie Telegram Channel Scraper API; Post Detail eignet sich für Posts, auf die Sie bereits verweisen können.
Verwandte APIs
Ergänzend zur Telegram Post Detail API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Telegram-Daten benötigen.
- Telegram Channel Info API — Bis zu 50 öffentliche Telegram-Kanäle per Link abfragen – mit Titel, Beschreibung, Avatar, Verifizierungsabzeichen und Abonnentenzahl als ganzer Zahl.
- Telegram Channel Scraper API — Bis zu 1000 Posts eines öffentlichen Telegram-Kanals ab dem neuesten erfassen – mit Text, Veröffentlichungszeit, Aufrufen, Reaktionssumme, Fotos und Videos.
- Telegram Comments API — Bis zu 100 Kommentare unter einem Telegram-Kanal-Post aus dessen Diskussionsgruppe erfassen – mit Autorname, Text, Zeit, Reaktionen und beantwortetem Kommentar.
- Telegram Similar Channels API — Die Kanäle finden, die Telegram neben einem öffentlichen Kanal empfiehlt, meist rund zehn – jeweils mit Titel, Verifizierungsabzeichen und exakter Abonnentenzahl.
- Telegram Channel Search API — Die gesamte Post-Historie eines öffentlichen Telegram-Kanals nach einem Wort oder einer Phrase durchsuchen und bis zu 100 Treffer mit Text, Datum, Aufrufen und Reaktionen erhalten.