Telegram Channel Info
Telegram Channel Info correspond au profil public d’une chaîne de diffusion, composé de son nom d’utilisateur, de son titre, de sa description, de son avatar, de son badge de vérification et de son nombre d’abonnés. Ces quelques signaux montrent la taille d’une chaîne, si Telegram l’a vérifiée et ce qu’elle déclare publier, ce qui sert à évaluer une chaîne avant un sponsoring, à tenir à jour une liste de veille et à enrichir des listes de chaînes.
Fonctionnalités de la Telegram Channel Info API
- Jusqu’à 50 chaînes par tâcheMélangez dans urls des liens t.me/name, t.me/s/name, telegram.me et telegram.dog ; une chaîne citée deux fois est interrogée une seule fois, et chaque chaîne trouvée produit une ligne.
- Abonnés en nombre entiermetrics.followers_count convertit l’affichage abrégé de Telegram, comme 9.95M, en un entier tel que 9950000, prêt pour le tri, le filtrage et les seuils.
- Identité et vérification sur une ligneusername, name, text et avatar_url décrivent la chaîne, et is_verified indique si elle porte le badge de vérification de Telegram.
- Liens illisibles ignorés sans fraisUn lien vers une chaîne privée ou supprimée est écarté des résultats et ne coûte rien, tandis que les autres chaînes du lot reviennent normalement.
Paramètres de la Telegram Channel Info API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Jusqu’à 50 liens de chaînes Telegram publiques, comme https://t.me/durov ou https://t.me/s/durov. Les liens telegram.me et telegram.dog fonctionnent aussi, et une chaîne répétée est interrogée une seule fois. |
Comment utiliser la Telegram Channel Info API
Envoyez une liste de liens de chaînes et lisez une ligne par chaîne trouvée.
- Envoyez {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} en POST à /v1/telegram/channel-info.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les chaînes 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-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'Cas d’usage de la Telegram Channel Info API
- Évaluer une chaîne avant un sponsoring : Comparez le nombre d’abonnés, le statut de vérification et la description de la chaîne avant d’accepter un placement payant.
- Tenir à jour une liste de veille : Relancez la même liste à intervalle régulier et enregistrez followers_count avec collected_at pour suivre la croissance de chaque chaîne crypto, d’actualité ou de niche.
- Enrichir des liens collectés ailleurs : Transformez une colonne de liens t.me issue d’un tableur, d’une recherche ou d’une liste de partenaires en titres, descriptions et tailles d’audience.
Conseils d’expert pour la Telegram Channel Info API
- Utilisez le username renvoyé comme clé : t.me/name et t.me/s/name désignent la même chaîne et produisent le même id, ce qui permet de fusionner proprement des recherches répétées.
- Un lien de publication comme https://t.me/durov/510 est lu comme sa chaîne ; pour obtenir la publication elle-même, envoyez-le à Telegram Post Detail API.
API associées
En complément de la Telegram Channel Info API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Telegram.
- 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.
- Telegram Channel Search API — Recherchez un mot ou une expression dans tout l’historique d’une chaîne Telegram publique et obtenez jusqu’à 100 publications avec texte, date, vues et réactions.