Torna alle API
Dati pubblici dei canali Telegram

Telegram Public Data API

Leggi i canali Telegram pubblici dai loro link t.me: profili dei canali con iscritti, post con visualizzazioni e reazioni, singoli post, commenti dei gruppi di discussione, canali simili e ricerca in tutto lo storico.

API di Telegram disponibili

Channel Info, Channel Scraper, Similar Channels e Channel Search partono dal link di un canale, Post Detail e Comments dal link di un post, e ogni risultato contiene link da passare direttamente all’endpoint successivo.

Quali dati di Telegram puoi recuperare?

Ogni endpoint restituisce record SocQ stabili, costruiti a partire da ciò che un canale pubblico mostra a qualsiasi visitatore.

Profili dei canali

Nome utente, titolo, descrizione, avatar, badge di verifica e numero di iscritti come intero, per un massimo di 50 canali a richiesta.

Post e media

Testo, data di pubblicazione, visualizzazioni, totale delle reazioni comprese le reazioni Star a pagamento e link a foto e video, fino a 1.000 post a partire dal più recente oppure fino a 50 post tramite link.

Commenti dei gruppi di discussione

Nome dell’autore, testo, data e reazioni di un massimo di 100 commenti per post, con parent_id e post_id per ricostruire i thread di risposte.

Canali simili

I canali che Telegram consiglia accanto a un canale, di solito una decina, nell’ordine di Telegram e con il numero esatto di iscritti.

Ricerca in un canale

Fino a 100 post che contengono una parola o una frase in qualsiasi punto dello storico di un canale, ognuno con visualizzazioni e reazioni.

SocQ e l’API di Telegram

L’API di Telegram serve a creare app e bot per Telegram. SocQ restituisce i dati dei canali pubblici come record normalizzati da archiviare, confrontare e combinare.

FunzionalitàSocQAPI di Telegram
AccessoChiave API di SocQID app di Telegram con un account connesso, oppure un token del bot
Input inizialeLink t.me pubblici di canali e postIdentificatori di oggetti Telegram risolti in una sessione client
OutputRecord JSON normalizzati con conteggi interiOggetti nativi di Telegram
FunzionamentoAttività asincrone con risultati salvati e paginatiChiamate in tempo reale dal tuo client

Come funzionano le API di Telegram

Tutti e sei gli endpoint seguono lo stesso ciclo asincrono di invio, interrogazione e lettura.

  1. 1. Parti da un link

    Invia il link di un canale a Channel Info, Channel Scraper, Similar Channels o Channel Search, oppure il link di un post a Post Detail o Comments.

  2. 2. Interroga l’attività

    Usa il task_id restituito con /v1/tasks/{task_id} finché l’elaborazione non riesce o non fallisce.

  3. 3. Concatena i risultati

    Passa gli url dei post di Channel Scraper o Channel Search a Comments o Post Detail, e gli url dei canali di Similar Channels a Channel Info.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Channel Scraper restituisce 20 post per impostazione predefinita e ne accetta fino a 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}'

# Poi leggi i commenti di un post:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Interroga GET /v1/tasks/{task_id}

Casi d’uso comuni dell’API di Telegram

Valutazione prima di una sponsorizzazione

Controlla iscritti e verifica con Channel Info e le visualizzazioni recenti con Channel Scraper prima di pagare un posizionamento.

Riepiloghi e avvisi sui canali

Raccogli a intervalli regolari gli ultimi post di canali di notizie, di mercato o di progetto e invia testi e link nuovi a riepiloghi o avvisi.

Feedback della community

Recupera i commenti sotto gli annunci e raggruppali per tema per capire come reagiscono i lettori e quali domande tornano.

Mappatura di una nicchia

Allargati dai canali di partenza con Similar Channels per costruire un elenco di canali correlati con la dimensione del loro pubblico.

Ricerca sulle menzioni

Cerca un brand, un token o un prodotto nei canali influenti e misura l’attenzione ricevuta da ogni menzione.

Ambito dei dati

I risultati riflettono ciò che i canali Telegram pubblici mostrano a qualsiasi visitatore al momento della raccolta.

  • Ogni endpoint legge canali pubblici, indicati dal nome utente del canale o dal numero di un post all’interno di un canale.
  • I commenti provengono dal gruppo di discussione che un canale collega ai suoi post, fino a 100 per post in ogni attività.
  • Similar Channels restituisce i consigli che Telegram mostra per un canale, di solito una decina.
  • Channel Search cerca in un canale per richiesta, lungo tutto il suo storico, e restituisce fino a 100 risultati.
  • I conteggi sono istantanee prese a collected_at e i link ai file di foto e video sono temporanei, quindi scarica presto i file da conservare.

Domande frequenti sull’API di Telegram

Che cos’è l’API di Telegram?

L’API di Telegram è un insieme di endpoint SocQ che leggono i canali Telegram pubblici dai loro link e restituiscono profili dei canali, post, commenti dei gruppi di discussione, canali simili e risultati di ricerca in un canale come record JSON normalizzati.

Quali API di Telegram sono disponibili?

Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API e Telegram Channel Search API.

Serve un account Telegram o un token del bot?

No. Le richieste usano la tua chiave API di SocQ e il link pubblico di un canale o di un post.

Quali formati di link sono accettati?

Link di canale come t.me/durov o t.me/s/durov, le loro varianti telegram.me e telegram.dog, e link di post come t.me/durov/510 per Post Detail e Comments.

In che forma vengono restituiti iscritti e visualizzazioni?

Come numeri interi. Le etichette abbreviate di Telegram come 9.95M o 661K vengono convertite in interi, e Similar Channels restituisce il numero esatto di iscritti.

Come vengono addebitati gli endpoint?

Channel Info, Post Detail, Similar Channels e Channel Search costano 0,5 crediti per risultato restituito, Channel Scraper e Comments 0,3 crediti per post o commento. I link illeggibili vengono saltati o rimborsati, e i post senza commenti e le ricerche senza risultati non costano nulla.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.