Le 2026-11-17, SocQ a ajouté une plateforme Telegram avec six endpoints dédiés aux chaînes Telegram publiques. Ensemble, ils couvrent toute la boucle de recherche : évaluer une chaîne, lire son flux, récupérer des publications précises, lire la discussion sous une publication, trouver des chaînes apparentées et rechercher un mot dans l’historique d’une chaîne.
Ce guide présente ce que renvoie chaque endpoint, la requête qu’il attend, son coût et les cas où l’utiliser. Tous les endpoints fonctionnent à partir de liens t.me publics et s’exécutent comme des tâches SocQ asynchrones.
Réponse rapide : envoyez un lien de chaîne ou de publication public à l’un des six endpoints
POST /v1/telegram/...avecAuthorization: Bearer $SOCQ_API_KEY. Enregistrez letask_idrenvoyé, interrogezGET /v1/tasks/{task_id}jusqu’à ce questatusvaillesucceeded, puis lisez les enregistrements dansdata.results.items. Chaque endpoint est facturé au résultat : 0,3 ou 0,5 crédit par ligne, soit $0,0015 ou $0,0025 à $0,005 le crédit.
Les six nouveaux endpoints Telegram
| Endpoint | Ce qu’il renvoie | Entrée | Prix |
|---|---|---|---|
| Channel Info | Titre, description, avatar, badge de vérification, nombre d’abonnés | Jusqu’à 50 liens de chaînes | 0,5 crédit ($0,0025) par chaîne |
| Channel Scraper | Publications de la plus récente à la plus ancienne, avec texte, date, vues, total des réactions, photos et vidéos | Un lien de chaîne | 0,3 crédit ($0,0015) par publication |
| Post Detail | Publications précises avec texte complet, date, vues, réactions et médias | Jusqu’à 50 liens de publications | 0,5 crédit ($0,0025) par publication |
| Comments | Jusqu’à 100 commentaires du groupe de discussion lié, avec auteur, texte, date, réactions et message auquel ils répondent | Un lien de publication | 0,3 crédit ($0,0015) par commentaire |
| Similar Channels | Chaînes que Telegram recommande à côté d’une chaîne, avec nom d’utilisateur, titre, badge et abonnés | Un lien de chaîne | 0,5 crédit ($0,0025) par chaîne |
| Channel Search | Publications de tout l’historique d’une chaîne qui contiennent un mot ou une expression | Un lien de chaîne + une requête | 0,5 crédit ($0,0025) par publication correspondante |
Les six endpoints ne facturent que les lignes renvoyées, sans frais de base par requête.
Telegram Channel Info : évaluer des chaînes en masse
L’API Telegram Channel Info recherche des chaînes publiques à partir d’un lien t.me/name ou t.me/s/name et renvoie une ligne par chaîne : nom, description, avatar, badge de vérification et nombre d’abonnés (metrics.followers_count). Utilisez-la pour évaluer une chaîne avant un sponsoring, actualiser une liste de suivi de chaînes d’actualité ou crypto, ou enrichir des liens de chaînes collectés ailleurs. Le fichier de résultats brut contient aussi le nombre de photos, de vidéos et de liens partagés par chaque chaîne.
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"]
}'
Envoyez jusqu’à 50 liens par requête. Les liens vers des chaînes non publiques sont ignorés ; la tâche n’échoue, avec remboursement, que si aucun d’eux ne peut être lu. Consultez la documentation Channel Info.
Telegram Channel Scraper : lire le flux d’une chaîne
L’API Telegram Channel Scraper lit une chaîne publique en remontant depuis la dernière publication. Chaque publication est fournie avec son texte, sa date de publication, son nombre de vues, le total de ses réactions emoji et Star, ainsi que les photos et vidéos jointes. Récupérez les derniers jours pour un digest quotidien, ou augmentez la limite pour reconstituer l’historique d’une chaîne.
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
}'
results_limit vaut 20 par défaut et accepte de 1 à 1 000. Une chaîne illisible fait échouer la tâche, avec remboursement. Consultez la documentation Channel Scraper.
Telegram Post Detail : actualiser des publications connues
Si vous savez déjà quelles publications comptent, l’API Telegram Post Detail prend leurs liens et renvoie chacune en entier : texte, date de publication, vues, total des réactions, photos et vidéos. Vous pouvez mélanger des publications de chaînes différentes dans une même requête, ce qui convient pour actualiser les chiffres d’annonces ou de publications de campagne suivies. Le fichier de résultats brut conserve le nombre de réactions par emoji et la source du transfert.
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov/510"]
}'
Envoyez jusqu’à 50 liens au format t.me/channel/post_id. Les publications supprimées et celles des chaînes privées sont ignorées. Consultez la documentation Post Detail.
Telegram Comments : lire la discussion sous une publication
Les chaînes qui associent un groupe de discussion permettent aux lecteurs de commenter chaque publication. L’API Telegram Comments lit ce fil pour une publication et renvoie chaque commentaire avec le nom de son auteur, son texte, sa date, son total de réactions et le commentaire auquel il répond (parent_id). Utilisez-la pour voir comment une communauté a réagi à une annonce, ou pour alimenter un workflow de support ou de recherche avec des commentaires.
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/tginfo/4455",
"results_limit": 100
}'
results_limit vaut 100 par défaut, ce qui est aussi le maximum. Vous ne payez que les commentaires renvoyés. Consultez la documentation Comments.
Telegram Similar Channels : cartographier une niche
Telegram affiche une rangée de chaînes apparentées sur chaque chaîne publique. L’API Telegram Similar Channels renvoie cette liste pour une chaîne, généralement une dizaine, dans l’ordre où Telegram les présente, chacune avec son nom d’utilisateur, son titre, son badge de vérification et son nombre d’abonnés. Partez d’un concurrent ou d’une chaîne sur laquelle vous faites déjà de la publicité pour élargir votre liste de médias.
curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov"
}'
Consultez la documentation Similar Channels.
Telegram Channel Search : rechercher dans l’historique d’une chaîne
L’API Telegram Channel Search recherche un mot ou une expression dans tout l’historique d’une chaîne publique et renvoie les publications correspondantes avec texte, date, vues et réactions. Vérifiez si une chaîne influente a déjà mentionné un projet, ou rassemblez toutes les publications qu’une chaîne a consacrées à un lancement.
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
}'
results_limit vaut 20 par défaut et accepte de 1 à 100. Une recherche sans résultat ne coûte rien. Dans les résultats de recherche, les photos renvoient vers la publication qui les affiche. Consultez la documentation Channel Search.
Authentification et flux de tâches asynchrones
Chaque requête transmet votre clé API et un type de contenu JSON :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Chaque appel de soumission démarre une tâche en arrière-plan :
submit -> task_id -> queued -> running -> succeeded
\-> failed
La réponse de soumission renvoie data.task_id et data.status. Interrogez la tâche avec la même clé :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Tant que la tâche est queued, running ou failed, la réponse ne contient que les métadonnées de la tâche ; en cas de failed, lisez error_message. Lorsqu’elle est succeeded, la même réponse inclut la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et monte jusqu’à 500. Si has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. fields accepte jusqu’à 50 champs ou chemins pointés séparés par des virgules si vous voulez une projection plus réduite.
Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même task_id au lieu de soumettre à nouveau et de payer un doublon. Pour éviter l’interrogation, ajoutez callback_url au corps de la soumission ; SocQ envoie un POST unique avec un résumé de la tâche quand elle se termine, puis vous lisez les enregistrements depuis l’endpoint de tâche.
Combien coûte une tâche type
- Évaluer 50 chaînes avec Channel Info : 50 × 0,5 = 25 crédits, $0,125.
- Reconstituer 1 000 publications d’une chaîne : 1 000 × 0,3 = 300 crédits, $1,50.
- Lire 100 commentaires sous une annonce : 30 crédits, $0,15.
- Rechercher dans une chaîne et obtenir 20 correspondances : 10 crédits, $0,05.
FAQ
Ces endpoints fonctionnent-ils avec les chaînes ou groupes privés ?
Non. Ils lisent les chaînes publiques à partir de leurs liens t.me. Channel Info et Post Detail ignorent les liens qu’ils ne peuvent pas lire, et Comments lit le groupe de discussion qu’une chaîne publique associe à ses publications.
Jusqu’où le Channel Scraper peut-il remonter ?
Il lit de la plus récente à la plus ancienne, et results_limit accepte jusqu’à 1 000 publications par requête. Pour retrouver d’anciennes publications sur un sujet précis, utilisez Channel Search, qui couvre tout l’historique de la chaîne.
Que comprend le nombre de réactions ?
Pour les publications de chaîne, metrics.likes_count contient le total des réactions emoji et Star. Le fichier de résultats brut de Post Detail conserve le détail par emoji.
Dois-je payer pour les chaînes ou publications introuvables ?
Non. La facturation se fait par ligne renvoyée, sans frais de base. Un Channel Search sans correspondance ne coûte rien, et une tâche dont aucun lien ne peut être lu échoue avec remboursement.
Comment trouver de nouvelles chaînes à suivre ?
Partez d’une chaîne que vous connaissez et appelez Similar Channels, puis transmettez les liens renvoyés à Channel Info pour comparer le nombre d’abonnés. Retrouvez tous les endpoints sur la page de la plateforme Telegram et les tarifs actuels sur la page des tarifs.
TELEGRAM API
Tester le workflow avec une URL publique Telegram
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API Telegram