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.

telegram/channel-info
Profils0,5 crédit par résultat

telegram/channel-posts
Publications0,3 crédit par résultat

telegram/post-detail
Publications0,5 crédit par résultat

telegram/post-comments
Commentaires0,3 crédit par résultat

telegram/similar-channels
Profils0,5 crédit par résultat

telegram/channel-search
Recherche0,5 crédit par résultat
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é | SocQ | API Telegram |
|---|---|---|
| Accès | Clé d’API SocQ | ID d’application Telegram avec un compte connecté, ou jeton de bot |
| Point de départ | Liens t.me publics de chaînes et de publications | Identifiants d’objets Telegram résolus dans une session client |
| Sortie | Enregistrements JSON normalisés avec des compteurs entiers | Objets Telegram natifs |
| Fonctionnement | Tâches asynchrones aux résultats stockés et paginés | Appels 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. 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. Interroger la tâche
Utilisez le task_id renvoyé avec /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou échoue.
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.
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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.