telegram/
channel-search

Recherchez un mot ou une expression dans tout l’historique d’une chaîne Telegram publique et obtenez jusqu’à 100 publications correspondantes avec texte, date de publication, vues et réactions.

Telegram Channel Search API

Tout l’historique de la chaîne
Jusqu’à 100 résultats
Vues et réactions
Gratuit sans résultat
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlObligatoireUn lien de chaîne Telegram publique à explorer, comme https://t.me/durov ; les liens t.me/s/, telegram.me et telegram.dog fonctionnent aussi.
queryObligatoireMot ou expression à rechercher dans les publications de la chaîne, comme TON.
results_limitFacultatifNombre 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.

  1. Envoyez {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} en POST à /v1/telegram/channel-search.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données Telegram avec les données publiques d’autres plateformes sociales prises en charge.

Telegram Channel Search API — FAQ

Telegram Channel Search API est une interface programmatique qui recherche un mot ou une expression dans tout l’historique des publications d’une chaîne Telegram publique. Elle renvoie jusqu’à 100 publications correspondantes avec leur texte, leur date de publication, leurs vues et leurs réactions.

Elle porte sur la chaîne indiquée dans url, sur l’ensemble de son historique. Pour trouver de nouvelles chaînes autour d’un sujet, partez d’une chaîne connue avec Telegram Similar Channels API.

Jusqu’à 100 publications correspondantes, selon results_limit, avec 20 par défaut.

Les photos des résultats renvoient vers la publication qui les affiche. Transmettez ce lien de publication à Telegram Post Detail API pour obtenir le fichier image lui-même.

Chaque publication correspondante renvoyée coûte 0,5 crédit, soit 10 crédits pour les 20 résultats par défaut. Une recherche sans résultat ne coûte rien.