L’API Xtream Codes è un modo di distribuire l’IPTV basato sull’accesso con credenziali: invece di un singolo link a una playlist inserisci un URL del server, un nome utente e una password, e l’app recupera canali, film, serie e guida ai programmi sotto forma di liste ordinate che si aggiornano da sole. È l’alternativa più diffusa a una semplice playlist M3U ed è quello che quasi tutti i player IPTV moderni intendono con «Login with Xtream Codes». Questa guida spiega come funziona, in che cosa differisce da M3U e dai portal URL e come usarla in sicurezza.
Che cos’è l’API Xtream Codes
Xtream Codes è nato come software di gestione che gli operatori IPTV usavano per amministrare gli abbonamenti. La sua API — il modo in cui le app dialogano con quel server — è diventata uno standard di fatto, così oggi «API Xtream Codes» indica soprattutto il metodo di accesso usato dal tuo player, anche quando dietro le quinte l’operatore fa girare un software diverso.
Il tratto che la definisce è che ti autentichi con tre informazioni:
- URL del server — l’indirizzo del server dell’operatore, per esempio
http://example.com:8080. - Nome utente — il nome del tuo account.
- Password — la chiave del tuo account.
Da queste, l’app richiede tutto il resto. Non incolli mai una lista di canali gigantesca: è il server a consegnare al player dati strutturati su richiesta.
Come funziona
Quando accedi, il tuo player IPTV interroga l’API del server e riceve il servizio suddiviso in sezioni ordinate:
- Autenticazione. L’app invia nome utente e password all’URL del server e riceve in risposta i dati del tuo account (stato, scadenza, connessioni consentite).
- Categorie di contenuti. Il server restituisce TV in diretta, VOD (film) e serie come liste separate e suddivise per categoria, non come un unico file piatto.
- Flussi su richiesta. Quando apri un canale, l’app richiede solo quel flusso, quindi il caricamento è rapido.
- EPG. La guida ai programmi viaggia sulla stessa API, così l’EPG si allinea ai tuoi canali senza bisogno di un URL a parte.
Poiché le liste stanno sul server, l’operatore può aggiungere o togliere canali e la tua app lo rispecchia al primo aggiornamento: nessuna reimportazione.
API Xtream, M3U e portal URL a confronto
Questi tre termini si sovrappongono e vengono spesso confusi. Ecco come si confrontano:
| Playlist M3U | API Xtream Codes | Portal URL (stile MAG) | |
|---|---|---|---|
| Che cosa inserisci | Un URL o un file di playlist | URL del server + nome utente + password | Portal URL (legato al MAC del dispositivo) |
| Struttura dei contenuti | Un’unica lista piatta | Live / VOD / serie divisi per categoria | Struttura del portale definita dall’operatore |
| EPG | URL dell’EPG a parte | Integrato nell’API | Integrato nel portale |
| Aggiornamenti | Reimportare per aggiornare | Automatici | Automatici |
| Dispositivi tipici | Quasi qualsiasi player | TiviMate, IPTV Smarters, ecc. | Box MAG / emulatori STB |
In breve: l’M3U è il più semplice e universale, l’API Xtream Codes è la più ordinata per le app e un portal URL è la modalità in stile set-top box legata all’indirizzo MAC del tuo dispositivo. Molti operatori offrono tutte e tre le opzioni dallo stesso account.
Buono a sapersi: quasi tutti i server Xtream possono restituire anche un link M3U aggiungendo un percorso get.php — per esempio http://server:port/get.php?username=USER&password=PASS&type=m3u_plus — così un player che accetta solo M3U può comunque caricare gli stessi canali.
Come effettuare l’accesso
Accedere con Xtream Codes richiede meno di un minuto nella maggior parte dei player:
- Scegli un player compatibile come TiviMate o IPTV Smarters — vedi la nostra guida ai migliori player IPTV.
- Seleziona «Login with Xtream Codes» (a volte «Xtream Codes API» o «Add Playlist → Xtream»).
- Inserisci i tre campi — URL del server, nome utente, password — esattamente come te li ha forniti l’operatore, numero di porta compreso.
- Aspetta il caricamento. L’app recupera in automatico TV in diretta, VOD, serie ed EPG.
- Organizza. Nascondi le categorie che non usi e riordina i preferiti; quasi tutti i player lo memorizzano per profilo.
Per una procedura completa dentro l’app, segui la nostra guida alla configurazione di TiviMate.
È legale?
Il protocollo dell’API Xtream Codes è legale: è un metodo di distribuzione, esattamente come l’M3U. Quello che conta è l’operatore che sta dietro le credenziali.
- Legale: credenziali di un servizio che detiene i diritti sui canali che trasmette.
- Non legale: accessi «tutti i canali» venduti a poco prezzo senza alcun diritto, per quanto curata possa sembrare l’app.
Attenzione: un accesso Xtream ben fatto non rende legittimo un servizio. Valgono gli stessi campanelli d’allarme di qualsiasi IPTV: tutti i canali premium per pochi euro, pagamento con gift card o criptovalute e nessuna società reale. WatchlyGuide si occupa solo di fonti con licenza.
In sintesi
L’API Xtream Codes è semplicemente un modo più ordinato di accedere all’IPTV: tre campi — URL del server, nome utente e password — che caricano TV in diretta, film, serie e guida come sezioni organizzate che si aggiornano da sole. È più strutturata di un M3U piatto ed è diversa da un portal URL in stile MAG, anche se molti account supportano tutte e tre le modalità. Usa un player compatibile, inserisci i dati con precisione e solo con un operatore che detiene i diritti giusti.
Il passo successivo è confrontarla con il formato playlist M3U, oppure partire dalle basi con cos’è l’IPTV e come funziona davvero lo streaming.
Un termine di questa pagina non ti è chiaro? Cercalo nel glossario dello streaming.