Telegram Post Detail
Telegram Post Detail è il record completo di un singolo post di un canale, con testo, data di pubblicazione, visualizzazioni, totale delle reazioni e foto o video allegati. Leggere questi valori per post che conosci già permette di aggiornare i numeri di una campagna, conservare quanto detto in un annuncio e aggiungere dati di copertura ai link nei tuoi archivi.
Funzionalità della Telegram Post Detail API
- Post da molti canali insiemeurls accetta fino a 50 link nella forma t.me/channel/post_id, che possono provenire da canali diversi nella stessa richiesta.
- Visualizzazioni e reazioni attualimetrics.views_count e metrics.likes_count forniscono come interi visualizzazioni e totale delle reazioni al momento della raccolta.
- Testo completo e mediatext contiene l’intero corpo del post e media elenca ogni foto o video con tipo e URL del file.
- Post mancanti saltati senza costiI post eliminati e quelli di canali privati vengono esclusi e non costano nulla; l’attività fallisce con rimborso solo se nessun link può essere letto.
Parametri della Telegram Post Detail API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Fino a 50 link di post Telegram nella forma https://t.me/channel/post_id, come https://t.me/durov/510. Puoi mescolare link di canali pubblici diversi. |
Come usare la Telegram Post Detail API
Invia i link dei post che ti interessano e leggi un record completo per ogni post trovato.
- Invia con POST {"urls": ["https://t.me/durov/510"]} a /v1/telegram/post-detail.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i post da results.items e, finché has_more è true, passa results.next_cursor per caricare la pagina successiva.
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"]}'Casi d’uso della Telegram Post Detail API
- Aggiornare i numeri di una campagna: Conserva i link dei post sponsorizzati o di annuncio e raccoglili di nuovo a intervalli regolari per seguire visualizzazioni e reazioni nel tempo.
- Conservare il testo di un post: Salva testo esatto e data di un post citato in un report, in una contestazione o in un articolo, insieme a collected_at.
- Arricchire i link condivisi: Trasforma i link di post raccolti da chat, articoli o fogli di calcolo in record completi con canale di origine, copertura e media.
Consigli degli esperti per la Telegram Post Detail API
- Raggruppa i link di molti canali in un’unica richiesta da massimo 50 invece di inviarli uno alla volta.
- author.username indica il canale a cui appartiene ogni post, utile per raggruppare per canale un lotto misto.
- Per raccogliere gli ultimi post di un canale senza conoscerne i link, usa Telegram Channel Scraper API; Post Detail è pensato per i post che sai già indicare.
API correlate
Oltre alla Telegram Post Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Telegram.
- Telegram Channel Info API — Interroga fino a 50 canali Telegram pubblici tramite link e restituisce titolo, descrizione, avatar, badge di verifica e numero di iscritti come intero.
- Telegram Channel Scraper API — Raccoglie fino a 1.000 post di un canale Telegram pubblico a partire dal più recente, con testo, data, visualizzazioni, reazioni, foto e video.
- Telegram Comments API — Raccoglie fino a 100 commenti sotto un post di un canale Telegram dal suo gruppo di discussione, con autore, testo, data, reazioni e commento a cui risponde.
- Telegram Similar Channels API — Trova i canali che Telegram consiglia accanto a un canale pubblico, di solito una decina, con titolo, badge di verifica e numero esatto di iscritti.
- Telegram Channel Search API — Cerca una parola o una frase in tutto lo storico di un canale Telegram pubblico e restituisce fino a 100 post corrispondenti con testo, data, visualizzazioni e reazioni.