Retour aux API
Données publiques des chaînes Telegram

Telegram Public Data API

Lisez les chaînes Telegram publiques à partir de leurs liens t.me : profils de chaîne avec nombre d’abonnés, publications avec vues et réactions, publications isolées, commentaires des groupes de discussion, chaînes similaires et recherche dans tout l’historique.

API Telegram disponibles

Channel Info, Channel Scraper, Similar Channels et Channel Search partent d’un lien de chaîne, Post Detail et Comments d’un lien de publication, et chaque résultat contient des liens à transmettre directement à l’endpoint suivant.

Quelles données Telegram pouvez-vous récupérer ?

Chaque endpoint renvoie des enregistrements SocQ stables, construits à partir de ce qu’une chaîne publique montre à tout visiteur.

Profils de chaîne

Nom d’utilisateur, titre, description, avatar, badge de vérification et nombre d’abonnés en entier, pour 50 chaînes au maximum par requête.

Publications et médias

Texte, date de publication, vues, total des réactions y compris les réactions Star payantes, et liens des photos et vidéos, soit jusqu’à 1 000 publications des plus récentes aux plus anciennes, soit jusqu’à 50 publications par lien.

Commentaires des groupes de discussion

Nom de l’auteur, texte, date et réactions de 100 commentaires au maximum par publication, avec parent_id et post_id pour reconstruire les fils de réponses.

Chaînes similaires

Les chaînes que Telegram recommande à côté d’une chaîne, une dizaine en général, dans l’ordre de Telegram et avec le nombre exact d’abonnés.

Recherche dans une chaîne

Jusqu’à 100 publications contenant un mot ou une expression n’importe où dans l’historique d’une chaîne, chacune avec ses vues et réactions.

SocQ et l’API Telegram

L’API de Telegram sert à créer des applications et des bots Telegram. SocQ renvoie les données des chaînes publiques sous forme d’enregistrements normalisés à stocker, comparer et combiner.

FonctionnalitéSocQAPI Telegram
AccèsClé d’API SocQID d’application Telegram avec un compte connecté, ou jeton de bot
Point de départLiens t.me publics de chaînes et de publicationsIdentifiants d’objets Telegram résolus dans une session client
SortieEnregistrements JSON normalisés avec des compteurs entiersObjets Telegram natifs
FonctionnementTâches asynchrones aux résultats stockés et paginésAppels en direct depuis votre propre client

Fonctionnement des API Telegram

Les six endpoints suivent le même cycle asynchrone d’envoi, d’interrogation et de lecture.

  1. 1. Partir d’un lien

    Envoyez un lien de chaîne à Channel Info, Channel Scraper, Similar Channels ou Channel Search, ou un lien de publication à Post Detail ou Comments.

  2. 2. Interroger la tâche

    Utilisez le task_id renvoyé avec /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou échoue.

  3. 3. Enchaîner les résultats

    Transmettez les url de publications issues de Channel Scraper ou Channel Search à Comments ou Post Detail, et les url de chaînes issues de Similar Channels à Channel Info.

Démarrer avec une seule requête d’API

Authentifiez-vous avec une clé d’API SocQ. Channel Scraper renvoie 20 publications par défaut et en accepte jusqu’à 1 000.

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

# Puis lisez les commentaires d’une publication :
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Interrogez GET /v1/tasks/{task_id}

Cas d’usage courants de l’API Telegram

Évaluation avant un sponsoring

Vérifiez le nombre d’abonnés et la vérification avec Channel Info, puis les vues récentes avec Channel Scraper, avant de payer un placement.

Synthèses et alertes de chaînes

Collectez régulièrement les dernières publications de chaînes d’actualité, de marché ou de projets et envoyez les nouveaux textes et liens vers des synthèses ou des alertes.

Retours de la communauté

Récupérez les commentaires sous les annonces et regroupez-les par thème pour voir comment les lecteurs réagissent et quelles questions reviennent.

Cartographie d’une niche

Partez de chaînes de départ avec Similar Channels pour constituer une liste de chaînes liées avec la taille de leur audience.

Étude des mentions

Recherchez une marque, un jeton ou un produit dans des chaînes influentes et mesurez l’attention reçue par chaque mention.

Périmètre des données

Les résultats reflètent ce que les chaînes Telegram publiques montrent à tout visiteur au moment de la collecte.

  • Chaque endpoint lit des chaînes publiques, désignées par le nom d’utilisateur d’une chaîne ou par un numéro de publication dans une chaîne.
  • Les commentaires proviennent du groupe de discussion qu’une chaîne associe à ses publications, jusqu’à 100 par publication et par tâche.
  • Similar Channels renvoie les recommandations que Telegram affiche pour une chaîne, une dizaine en général.
  • Channel Search cherche dans une chaîne par requête, sur tout son historique, et renvoie jusqu’à 100 résultats.
  • Les compteurs sont des instantanés pris à collected_at, et les liens des fichiers photo et vidéo sont temporaires : téléchargez rapidement les fichiers à conserver.

Questions fréquentes sur l’API Telegram

Qu’est-ce que l’API Telegram ?

L’API Telegram est un ensemble d’endpoints SocQ qui lisent les chaînes Telegram publiques à partir de leurs liens et renvoient profils de chaîne, publications, commentaires des groupes de discussion, chaînes similaires et résultats de recherche dans une chaîne sous forme d’enregistrements JSON normalisés.

Quelles API Telegram sont disponibles ?

Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API et Telegram Channel Search API.

Faut-il un compte Telegram ou un jeton de bot ?

Non. Les requêtes utilisent votre clé d’API SocQ et un lien de chaîne ou de publication public.

Quels formats de lien sont acceptés ?

Les liens de chaîne comme t.me/durov ou t.me/s/durov, leurs variantes telegram.me et telegram.dog, ainsi que les liens de publication comme t.me/durov/510 pour Post Detail et Comments.

Sous quelle forme sont renvoyés les abonnés et les vues ?

En nombres entiers. Les libellés abrégés de Telegram comme 9.95M ou 661K sont convertis en entiers, et Similar Channels renvoie le nombre exact d’abonnés.

Comment les endpoints sont-ils facturés ?

Channel Info, Post Detail, Similar Channels et Channel Search coûtent 0,5 crédit par résultat renvoyé, Channel Scraper et Comments 0,3 crédit par publication ou commentaire. Les liens illisibles sont ignorés ou remboursés, et les publications sans commentaires comme les recherches sans résultat ne coûtent rien.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Link in Bio API

Transformez l’unique lien de la bio Instagram, TikTok ou YouTube d’un créateur en données structurées : nom affiché, bio, avatar, e-mail de contact indiqué, profils sociaux liés et chaque bouton de la page avec son titre et sa destination.

Creator API

Partez d’un profil Instagram, TikTok, YouTube, X, Facebook ou Threads pour trouver les e-mails professionnels publics d’un créateur, ses comptes sur d’autres réseaux ou une estimation de son âge et de son genre d’après sa photo de profil.

Google Hotels API

Recherchez des hôtels par destination, ouvrez la fiche complète de n’importe quel hôtel sur Google Hotels et récupérez son calendrier de prix par nuit, le tout relié par un même identifiant.

Brand Monitoring API

Trouvez les pages web qui citent une marque, un produit ou un sujet, notez chacune selon le sentiment et l’émotion, et résumez la façon dont le web en parle.

AI Search API

Suivez comment AI Overviews, ChatGPT et Google AI Mode répondent aux questions de votre marché : les réponses qui citent votre marque, votre niveau de visibilité, et les domaines et pages qu’ils citent.

Instagram API

Recherchez ou trouvez des profils publics et collectez enregistrements de listes d’abonnés, relations d’abonnement, publications publiées, publications où un profil est identifié, résultats par hashtag, Reels, transcriptions, commentaires, nombres de comptes, indicateurs d’engagement et métadonnées de médias dans un seul workflow asynchrone.