API di Telegram
Cerca canali, gruppi e messaggi pubblici su Telegram per ottenere il contenuto dei post, il numero di visualizzazioni e campioni di membri.
Gli username possono essere semplici o in forma di URL. I link di invito privati e gli elenchi completi dei membri non sono supportati.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su telegram e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio channel_posts.
- 6 funzionalità
- Da $0.56 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Telegram: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $0.56 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Post del canalechannel_posts | Leggi i messaggi pubblicati in un canale Telegram pubblico. | Normale | |
Profiliprofile | Scopri quanto è grande un canale Telegram pubblico. | Normale | |
Ricercasearch | Cerca messaggi nei canali Telegram pubblici per parola chiave. | Normale | |
Gruppogroup | Consulta la scheda informativa di un gruppo o canale Telegram: titolo, descrizione, numero di membri e di utenti online, data di creazione e flag scam, fake o verificato. | Normale | |
Membrimembers | Elenca i membri visibili di un gruppo Telegram pubblico, con username, nome, tipo di account, flag Premium, scam e fake e ora dell'ultimo accesso. | Normale | |
Dettagli del postpost_detail | Leggi un messaggio di un canale Telegram pubblico dal suo link, ad esempio https://t.me/durov/520. | $0.81 per 1.000 richieste | Normale |
Cosa accetta ogni azione di API di Telegram?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $0.56 | Campi della risposta |
|---|---|---|---|---|---|
channel_postsPost del canale Leggi i messaggi pubblicati in un canale Telegram pubblico. Ogni post ha testo, visualizzazioni, media, reazioni e fonte di inoltro. I link di invito privati non sono supportati. Il batch potrebbe non coprire l'intera cronologia del canale. | username | — | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions | |
profileProfili Scopri quanto è grande un canale Telegram pubblico. Ottieni numero di iscritti, numero di foto, video e link, bio, avatar e stato di verifica. Accetta un nome nelle forme name, @name, t.me/name o t.me/s/name. Chat private, numeri di telefono e nomi dei membri restano inaccessibili. | username | — | — | username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform | |
searchRicerca Cerca messaggi nei canali Telegram pubblici per parola chiave. Ogni risultato ha nome del canale, tipo, numero di iscritti, visualizzazioni, reazioni e media. Restringi l'intervallo con | keyword | since, until | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform | |
groupGruppo Consulta la scheda informativa di un gruppo o canale Telegram: titolo, descrizione, numero di membri e di utenti online, data di creazione e flag scam, fake o verificato. I link di invito privati non sono supportati, e la chiamata non entra mai nel gruppo né apre contenuti riservati. | username | — | — | id · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform | |
membersMembri Elenca i membri visibili di un gruppo Telegram pubblico, con username, nome, tipo di account, flag Premium, scam e fake e ora dell'ultimo accesso. L'elenco può essere parziale, e un numero di telefono compare solo se il membro lo ha reso pubblico. | username | — | Valori del catalogo: defaultLimit=100, maxLimit=5000. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform | |
post_detailDettagli del post Leggi un messaggio di un canale Telegram pubblico dal suo link, ad esempio https://t.me/durov/520. Ottieni testo, visualizzazioni, ora di pubblicazione, tipo e link del media, firma dell'autore, fonte di inoltro, link della risposta, anteprima del link e reazioni con i relativi conteggi. | url | — | — | $0.81 per 1.000 richieste | id · url · channel_username · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
Cosa significano i parametri channel_posts di API di Telegram?
Leggi i messaggi pubblicati in un canale Telegram pubblico. Ogni post ha testo, visualizzazioni, media, reazioni e fonte di inoltro. I link di invito privati non sono supportati. Il batch potrebbe non coprire l'intera cronologia del canale.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Indica il canale o il gruppo pubblico di destinazione in formati come name, @name, t.me/name o t.me/s/name. Usato da channel_posts e profile per i canali pubblici, da group per i metadati pubblici dell'entità e da members per recuperare i membri visibili del gruppo; i link di invito privati non sono supportati e l'elenco completo dei membri non è garantito.Documentazione ufficiale di Telegram: canali, username pubblici e conteggio delle visualizzazioni — La documentazione ufficiale di Telegram distingue i canali pubblici dai canali privati accessibili solo su invito, e precisa che i canali funzionano come strumenti di trasmissione e che il conteggio delle visualizzazioni include le copie inoltrate come valore approssimativo; questo spiega l'oggetto canale e il parametro view_count, ma non dimostra che questo endpoint possa leggere la cronologia completa di un canale o contenuti privati. · VerificatoDocumentazione ufficiale di Telegram: l'accesso ai contenuti resta soggetto ai termini di licenza — Le limitate eccezioni ufficiali per client di terze parti, bot e Mini App coprono solo i dati strettamente necessari al funzionamento e restano vincolate a termini, diritto d'autore e norme sulla privacy; la sola esistenza di un endpoint API non costituisce un'autorizzazione allo scraping, alla rivendita o al riutilizzo arbitrario dei dati della piattaforma. · Verificato
Cosa significano i parametri profile di API di Telegram?
Scopri quanto è grande un canale Telegram pubblico. Ottieni numero di iscritti, numero di foto, video e link, bio, avatar e stato di verifica. Accetta un nome nelle forme name, @name, t.me/name o t.me/s/name. Chat private, numeri di telefono e nomi dei membri restano inaccessibili.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Indica il canale o il gruppo pubblico di destinazione in formati come name, @name, t.me/name o t.me/s/name. Usato da channel_posts e profile per i canali pubblici, da group per i metadati pubblici dell'entità e da members per recuperare i membri visibili del gruppo; i link di invito privati non sono supportati e l'elenco completo dei membri non è garantito.Documentazione ufficiale di Telegram: canali, username pubblici e conteggio delle visualizzazioni — La documentazione ufficiale di Telegram distingue i canali pubblici dai canali privati accessibili solo su invito, e precisa che i canali funzionano come strumenti di trasmissione e che il conteggio delle visualizzazioni include le copie inoltrate come valore approssimativo; questo spiega l'oggetto canale e il parametro view_count, ma non dimostra che questo endpoint possa leggere la cronologia completa di un canale o contenuti privati. · Verificato
Cosa significano i parametri search di API di Telegram?
Cerca messaggi nei canali Telegram pubblici per parola chiave. Ogni risultato ha nome del canale, tipo, numero di iscritti, visualizzazioni, reazioni e media. Restringi l'intervallo con since e until. Le chat private non vengono mai cercate, e i risultati non rappresentano tutto Telegram.
keywordObbligatorio- Indica la query di ricerca dei messaggi nei canali pubblici per l'azione search. Non cerca nelle rubriche né nelle chat private.Documentazione ufficiale di Telegram: licenza dei contenuti e limiti all'uso per l'AI — I termini ufficiali di Telegram limitano l'accesso ai contenuti oltre il normale uso previsto della piattaforma e vietano lo scraping o l'aggregazione dei dati della piattaforma per addestramento, validazione, miglioramento, benchmarking e deployment di modelli AI; le eccezioni richiedono il consenso esplicito e continuativo degli utenti interessati per ogni contenuto e contesto, perché la visibilità pubblica non concede una licenza d'uso generale. · Verificato
sinceFacoltativo- Imposta il limite inferiore della data dei messaggi per l'azione search. Non filtra per data di creazione del gruppo, e channel_posts non ha un filtro per data.
untilFacoltativo- Imposta il limite superiore della data dei messaggi (beforeDate) per l'azione search. Si usa insieme a since per restringere i risultati dei messaggi pubblici; non garantisce la copertura completa dei messaggi nell'intervallo indicato.
Cosa significano i parametri group di API di Telegram?
Consulta la scheda informativa di un gruppo o canale Telegram: titolo, descrizione, numero di membri e di utenti online, data di creazione e flag scam, fake o verificato. I link di invito privati non sono supportati, e la chiamata non entra mai nel gruppo né apre contenuti riservati.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Indica il canale o il gruppo pubblico di destinazione in formati come name, @name, t.me/name o t.me/s/name. Usato da channel_posts e profile per i canali pubblici, da group per i metadati pubblici dell'entità e da members per recuperare i membri visibili del gruppo; i link di invito privati non sono supportati e l'elenco completo dei membri non è garantito.Documentazione ufficiale di Telegram: gruppi, username e privacy dell'ultimo accesso — La documentazione ufficiale di Telegram descrive in dettaglio gli username pubblici e i link t.me, e precisa che lo stato dell'ultimo accesso può essere nascosto o impostato per mostrare solo intervalli di tempo approssimativi; i campi last_seen_at dei membri non possono essere usati per ricostruire una cronologia esatta delle attività, e uno username pubblico non implica l'accesso a un numero di telefono pubblico. · Verificato
Cosa significano i parametri members di API di Telegram?
Elenca i membri visibili di un gruppo Telegram pubblico, con username, nome, tipo di account, flag Premium, scam e fake e ora dell'ultimo accesso. L'elenco può essere parziale, e un numero di telefono compare solo se il membro lo ha reso pubblico.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Indica il canale o il gruppo pubblico di destinazione in formati come name, @name, t.me/name o t.me/s/name. Usato da channel_posts e profile per i canali pubblici, da group per i metadati pubblici dell'entità e da members per recuperare i membri visibili del gruppo; i link di invito privati non sono supportati e l'elenco completo dei membri non è garantito.Documentazione ufficiale di Telegram: gruppi, username e privacy dell'ultimo accesso — La documentazione ufficiale di Telegram descrive in dettaglio gli username pubblici e i link t.me, e precisa che lo stato dell'ultimo accesso può essere nascosto o impostato per mostrare solo intervalli di tempo approssimativi; i campi last_seen_at dei membri non possono essere usati per ricostruire una cronologia esatta delle attività, e uno username pubblico non implica l'accesso a un numero di telefono pubblico. · VerificatoDocumentazione ufficiale di Telegram: l'accesso ai contenuti resta soggetto ai termini di licenza — Le limitate eccezioni ufficiali per client di terze parti, bot e Mini App coprono solo i dati strettamente necessari al funzionamento e restano vincolate a termini, diritto d'autore e norme sulla privacy; la sola esistenza di un endpoint API non costituisce un'autorizzazione allo scraping, alla rivendita o al riutilizzo arbitrario dei dati della piattaforma. · Verificato
Cosa significano i parametri post_detail di API di Telegram?
Leggi un messaggio di un canale Telegram pubblico dal suo link, ad esempio https://t.me/durov/520. Ottieni testo, visualizzazioni, ora di pubblicazione, tipo e link del media, firma dell'autore, fonte di inoltro, link della risposta, anteprima del link e reazioni con i relativi conteggi.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Link a un singolo messaggio di un canale pubblico per
post_detail, https://t.me/<channel>/<message ID>; funzionano anche i link t.me/s/.
Come usare l'API di Telegram
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<username>"}}'
Domande sull'API di Telegram
Cosa posso ottenere con l'API di Telegram?
Imposta platform su telegram. Il catalogo attuale elenca post del canale, profili, ricerca, gruppo, membri e more. Questi nomi di azione identificano oggetti o viste diversi di Telegram; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta channel_posts di Telegram?
Indica il canale o il gruppo pubblico di destinazione in formati come name, @name, t.me/name o t.me/s/name. Usato da channel_posts e profile per i canali pubblici, da group per i metadati pubblici dell'entità e da members per recuperare i membri visibili del gruppo; i link di invito privati non sono supportati e l'elenco completo dei membri non è garantito. Invialo come username all'interno di params.
Quali campi può restituire channel_posts di Telegram?
Il suo schema dichiarato include channel_username, channel_title, text e view_count. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Telegram rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.