Telegram Channel Search
Telegram Channel Search parcourt chaque publication qu’une chaîne publique a diffusée à la recherche d’un mot ou d’une expression, et renvoie les publications correspondantes avec leur texte, leur date de publication, leurs vues et leurs réactions. Retrouver ces mentions, aussi anciennes soient-elles, montre si une chaîne influente a déjà parlé d’un projet, à quelle fréquence elle revient sur un sujet et quelle attention chaque mention a reçue.
Fonctionnalités de la Telegram Channel Search API
- Recherche dans tout l’historiquequery porte sur toutes les publications de la chaîne, si bien qu’une mention vieille de plusieurs années se retrouve aussi facilement qu’une mention du jour.
- Jusqu’à 100 publications correspondantesresults_limit fixe le nombre de résultats renvoyés, de 1 à 100 avec 20 par défaut.
- Vues et réactions par résultatChaque publication correspondante comporte metrics.views_count et metrics.likes_count, qui montrent l’attention reçue par la mention.
- Seuls les résultats sont facturésChaque publication correspondante coûte 0,5 crédit, et une recherche sans résultat ne coûte rien.
Paramètres de la Telegram Channel Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | Un lien de chaîne Telegram publique à explorer, comme https://t.me/durov ; les liens t.me/s/, telegram.me et telegram.dog fonctionnent aussi. |
query | Obligatoire | Mot ou expression à rechercher dans les publications de la chaîne, comme TON. |
results_limit | Facultatif | Nombre de publications correspondantes à renvoyer. Entier de 1 à 100, 20 par défaut. |
Comment utiliser la Telegram Channel Search API
Envoyez un lien de chaîne et un terme de recherche, puis lisez les publications correspondantes.
- Envoyez {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} en POST à /v1/telegram/channel-search.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les publications correspondantes dans results.items et, tant que has_more vaut true, transmettez results.next_cursor pour charger la page suivante.
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}'Cas d’usage de la Telegram Channel Search API
- Vérifier la couverture d’un projet : Recherchez le nom de votre jeton, produit ou marque dans une chaîne d’influenceur ou d’actualité avant de proposer un partenariat.
- Rassembler la couverture d’un lancement : Réunissez dans une liste toutes les publications qu’une chaîne a consacrées à un lancement de produit ou à un événement, pour un bilan.
- Vérification avant d’acheter un emplacement : Cherchez dans une chaîne d’anciennes promotions d’un concurrent ou d’un sujet pour comprendre son historique avant d’y acheter un placement.
- Étude d’un sujet sur plusieurs chaînes : Lancez la même recherche sur plusieurs chaînes et comparez la fréquence des mentions et les vues obtenues par ces publications.
Conseils d’expert pour la Telegram Channel Search API
- Lancez des recherches séparées pour un ticker et pour le nom complet du projet afin de couvrir les deux façons dont une chaîne peut l’écrire.
- Les photos des résultats renvoient vers la publication qui les affiche ; envoyez l’url de cette publication à Telegram Post Detail API si vous avez besoin des fichiers image.
- Chaque recherche porte sur une chaîne ; pour découvrir d’autres chaînes autour d’un sujet, partez d’une chaîne connue avec Telegram Similar Channels API.
API associées
En complément de la Telegram Channel Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Telegram.
- Telegram Channel Info API — Interrogez jusqu’à 50 chaînes Telegram publiques par lien pour obtenir titre, description, avatar, badge de vérification et nombre d’abonnés en entier.
- Telegram Channel Scraper API — Collectez jusqu’à 1 000 publications d’une chaîne Telegram publique, des plus récentes aux plus anciennes, avec texte, date, vues, réactions, photos et vidéos.
- Telegram Post Detail API — Récupérez jusqu’à 50 publications Telegram précises par lien, depuis n’importe quelles chaînes publiques, avec texte intégral, date, vues, réactions et médias.
- Telegram Comments API — Collectez jusqu’à 100 commentaires sous une publication de chaîne Telegram depuis son groupe de discussion, avec auteur, texte, date, réactions et message visé.
- Telegram Similar Channels API — Trouvez les chaînes que Telegram recommande à côté d’une chaîne publique, une dizaine en général, avec titre, badge de vérification et nombre exact d’abonnés.