telegram/
post-detail

Récupérez des publications Telegram précises à partir de leurs liens, jusqu’à 50 par tâche et depuis n’importe quel mélange de chaînes publiques, chacune avec texte intégral, date de publication, vues, total des réactions et médias.

Telegram Post Detail API

Jusqu’à 50 publications par requête
Chaînes mélangées
Vues et réactions
Photos et vidéos
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 Post Detail

Telegram Post Detail est la fiche complète d’une publication de chaîne, avec son texte, sa date de publication, son nombre de vues, son total de réactions et ses photos ou vidéos jointes. Lire ces valeurs pour des publications déjà connues permet d’actualiser les chiffres d’une campagne, de conserver ce qu’une annonce a dit et d’ajouter des données de portée aux liens de vos propres fichiers.

Fonctionnalités de la Telegram Post Detail API

  • Des publications de plusieurs chaînes à la foisurls accepte jusqu’à 50 liens de la forme t.me/channel/post_id, qui peuvent venir de chaînes différentes dans une même requête.
  • Vues et réactions actuellesmetrics.views_count et metrics.likes_count donnent en entiers le nombre de vues et le total des réactions au moment de la collecte.
  • Texte intégral et médiastext contient tout le corps de la publication, et media liste chaque photo ou vidéo avec son type et l’URL du fichier.
  • Publications manquantes ignorées sans fraisLes publications supprimées et celles des chaînes privées sont écartées et ne coûtent rien ; la tâche échoue avec remboursement uniquement si aucun lien ne peut être lu.

Paramètres de la Telegram Post Detail API

ParamètresObligatoireDescription
urlsObligatoireJusqu’à 50 liens de publications Telegram de la forme https://t.me/channel/post_id, comme https://t.me/durov/510. Les liens de différentes chaînes publiques peuvent être mélangés.

Comment utiliser la Telegram Post Detail API

Envoyez les liens des publications voulues et lisez une fiche complète par publication trouvée.

  1. Envoyez {"urls": ["https://t.me/durov/510"]} en POST à /v1/telegram/post-detail.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les publications 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/post-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov/510"]}'

Cas d’usage de la Telegram Post Detail API

  • Actualiser les chiffres d’une campagne : Conservez les liens des publications sponsorisées ou d’annonce et collectez-les de nouveau à intervalle régulier pour suivre l’évolution des vues et réactions.
  • Garder une trace d’une publication : Enregistrez le texte exact et la date de publication d’un message cité dans un rapport, un litige ou un article, avec collected_at.
  • Enrichir des liens partagés : Transformez des liens de publications glanés dans des discussions, des articles ou des tableurs en fiches complètes avec chaîne source, portée et médias.

Conseils d’expert pour la Telegram Post Detail API

  • Regroupez les liens de plusieurs chaînes dans une seule requête de 50 au maximum plutôt que de les envoyer un par un.
  • author.username indique la chaîne de chaque publication, pratique pour regrouper un lot mélangé par chaîne.
  • Pour collecter les dernières publications d’une chaîne sans connaître leurs liens, utilisez Telegram Channel Scraper API ; Post Detail convient aux publications que vous savez déjà désigner.

En complément de la Telegram Post Detail 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 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.

Explorer d’autres plateformes

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

Telegram Post Detail API — FAQ

Telegram Post Detail API est une interface programmatique qui récupère des publications précises de chaînes Telegram publiques à partir de leurs liens, jusqu’à 50 par requête. Chaque publication revient avec son texte, sa date de publication, son nombre de vues, son total de réactions et ses médias.

Chaque lien indique une chaîne et un numéro de publication, comme https://t.me/durov/510. Les formes t.me/s/, telegram.me et telegram.dog du même lien sont également acceptées.

Oui. Jusqu’à 50 liens peuvent être librement mélangés, et les champs author de chaque ligne montrent de quelle chaîne vient la publication.

Elles sont ignorées et non facturées, et les autres publications reviennent normalement. Si aucun lien ne peut être lu, la tâche échoue et les crédits sont remboursés.

Chaque publication renvoyée coûte 0,5 crédit, soit 25 crédits pour un lot complet de 50 publications lisibles.