Telegram Channel Search
Telegram Channel Search durchsucht jeden Post, den ein öffentlicher Kanal veröffentlicht hat, nach einem Wort oder einer Phrase und liefert die passenden Posts mit Text, Veröffentlichungsdatum, Aufrufen und Reaktionen. Solche Erwähnungen zu finden, egal wie weit zurück sie liegen, zeigt, ob ein einflussreicher Kanal je über ein Projekt berichtet hat, wie oft er auf ein Thema zurückkommt und wie viel Aufmerksamkeit jede Erwähnung erhielt.
Funktionen der Telegram Channel Search API
- Durchsucht die gesamte Historiequery läuft über jeden Post, den der Kanal veröffentlicht hat, sodass eine Erwähnung von vor Jahren ebenso gefunden wird wie eine von heute.
- Bis zu 100 passende Postsresults_limit legt fest, wie viele Treffer zurückkommen, von 1 bis 100 mit Standardwert 20.
- Aufrufe und Reaktionen pro TrefferJeder passende Post enthält metrics.views_count und metrics.likes_count und zeigt, wie viel Aufmerksamkeit die Erwähnung erhielt.
- Nur Treffer werden berechnetJeder passende Post kostet 0,5 Credits, und eine Suche ohne Treffer kostet nichts.
Parameter der Telegram Channel Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Ein öffentlicher Telegram-Kanal-Link, der durchsucht werden soll, etwa https://t.me/durov; Links mit t.me/s/, telegram.me und telegram.dog funktionieren ebenfalls. |
query | Erforderlich | Wort oder Phrase, nach der in den Posts des Kanals gesucht wird, etwa TON. |
results_limit | Optional | Anzahl der zurückzugebenden Treffer. Ganzzahl von 1 bis 100, Standardwert 20. |
So verwenden Sie die Telegram Channel Search API
Senden Sie einen Kanal-Link und einen Suchbegriff und lesen Sie die passenden Posts.
- Senden Sie {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} per POST an /v1/telegram/channel-search.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die passenden 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/channel-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'Anwendungsfälle der Telegram Channel Search API
- Berichterstattung über ein Projekt prüfen: Durchsuchen Sie einen Influencer- oder Nachrichtenkanal nach Ihrem Token-, Produkt- oder Markennamen, bevor Sie eine Partnerschaft vorschlagen.
- Berichte zu einem Launch sammeln: Fassen Sie jeden Post, den ein Kanal zu einem Produktlaunch oder Event veröffentlicht hat, für einen Rückblick in einer Liste zusammen.
- Prüfung vor einer Anzeigenbuchung: Durchsuchen Sie einen Kanal nach früheren Promotions für Wettbewerber oder ein Thema, um seine Historie zu verstehen, bevor Sie eine Platzierung kaufen.
- Themenrecherche über Kanäle hinweg: Führen Sie dieselbe Suche in mehreren Kanälen aus und vergleichen Sie, wie oft jeder das Thema erwähnt und wie viele Aufrufe diese Posts erzielten.
Profi-Tipps zur Telegram Channel Search API
- Suchen Sie getrennt nach einem Ticker und dem vollen Projektnamen, um beide Schreibweisen abzudecken, die ein Kanal verwenden kann.
- Fotos in Suchergebnissen verlinken auf den Post, der sie zeigt; senden Sie diese Post-url an Telegram Post Detail API, wenn Sie die Bilddateien benötigen.
- Jede Suche umfasst einen Kanal; um weitere Kanäle zu einem Thema zu entdecken, starten Sie bei einem bekannten Kanal mit Telegram Similar Channels API.
Verwandte APIs
Ergänzend zur Telegram Channel Search 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 Post Detail API — Bis zu 50 bestimmte Telegram-Posts per Link aus beliebigen öffentlichen Kanälen abrufen – mit vollem Text, Veröffentlichungszeit, Aufrufen, Reaktionen und Medien.
- 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.