La API de Xtream Codes es una forma de distribuir IPTV basada en inicio de sesión: en lugar de un único enlace de lista de reproducción, introduces una URL de servidor, un usuario y una contraseña, y la app recupera tus canales, películas, series y guía de programación como listas organizadas que se actualizan solas. Es la alternativa más habitual a una simple lista de reproducción M3U y es lo que la mayoría de los reproductores de IPTV modernos quieren decir con «Iniciar sesión con Xtream Codes». Esta guía explica cómo funciona, en qué se diferencia del M3U y de las URL de portal, y cómo usarla de forma segura.
Qué es la API de Xtream Codes
La API de Xtream Codes empezó como un software de panel que los proveedores de IPTV usaban para gestionar las suscripciones. Su API —la forma en que las apps se comunican con ese servidor— se convirtió en un estándar de facto, así que hoy «API de Xtream Codes» se refiere sobre todo al método de inicio de sesión que usa tu reproductor, incluso cuando el proveedor ejecuta un software distinto por detrás.
La característica que la define es que te autenticas con tres datos:
- URL de servidor — la dirección del servidor del proveedor, p. ej.
http://example.com:8080. - Usuario — el nombre de tu cuenta.
- Contraseña — la clave de tu cuenta.
A partir de ellos, la app solicita todo lo demás. Nunca pegas una lista de canales gigantesca; el servidor entrega a tu reproductor datos estructurados bajo demanda.
Cómo funciona
Cuando inicias sesión, tu reproductor de IPTV llama a la API del servidor y recibe tu servicio dividido en secciones limpias:
- Autenticación. La app envía tu usuario y tu contraseña a la URL de servidor y recibe los datos de tu cuenta (estado, caducidad, conexiones permitidas).
- Categorías de contenido. El servidor devuelve la TV en directo, el VOD (películas) y las series como listas separadas y por categorías, no como un único archivo plano.
- Emisiones bajo demanda. Cuando abres un canal, la app solicita solo esa emisión, así que la carga es rápida.
- EPG. La guía de programación se entrega a través de la misma API, de modo que la EPG encaja con tus canales sin una URL aparte.
Como las listas viven en el servidor, el proveedor puede añadir o quitar canales y tu app lo refleja en la siguiente actualización, sin reimportar nada.
API de Xtream vs M3U vs URL de portal
Estos tres términos se solapan y a menudo se confunden. Así es como se comparan:
| Lista M3U | API de Xtream Codes | URL de portal (tipo MAG) | |
|---|---|---|---|
| Tú introduces | Una URL o un archivo de lista | URL de servidor + usuario + contraseña | URL de portal (vinculada a la MAC del dispositivo) |
| Estructura del contenido | Una lista plana | En directo / VOD / Series por categorías | Diseño de portal definido por el proveedor |
| EPG | URL de EPG aparte | Integrada en la API | Integrada en el portal |
| Actualizaciones | Reimportar para refrescar | Automáticas | Automáticas |
| Dispositivos típicos | Casi cualquier reproductor | TiviMate, IPTV Smarters, etc. | Boxes MAG / emuladores de STB |
En resumen: el M3U es el más sencillo y universal, la API de Xtream Codes es la más organizada para las apps y una URL de portal es el estilo de descodificador vinculado a la dirección MAC de tu dispositivo. Muchos proveedores ofrecen las tres desde la misma cuenta.
Bueno es saberlo: la mayoría de los servidores Xtream también pueden generar un enlace M3U añadiendo una ruta get.php —p. ej. http://server:port/get.php?username=USER&password=PASS&type=m3u_plus—, de modo que un reproductor que solo acepta M3U puede cargar igualmente los mismos canales.
Cómo iniciar sesión
Iniciar sesión con Xtream Codes lleva menos de un minuto en la mayoría de los reproductores:
- Elige un reproductor compatible como TiviMate o IPTV Smarters; consulta nuestra guía de los mejores reproductores de IPTV.
- Elige «Iniciar sesión con Xtream Codes» (a veces «Xtream Codes API» o «Añadir lista → Xtream»).
- Introduce tus tres campos —URL de servidor, usuario y contraseña— exactamente como te los dio tu proveedor, incluido el número de puerto.
- Espera a que cargue. La app recupera la TV en directo, el VOD, las series y la EPG automáticamente.
- Organiza. Oculta las categorías que no uses y reordena los favoritos; la mayoría de los reproductores lo recuerdan por perfil.
Para un tutorial completo de la app, sigue nuestra guía de configuración de TiviMate.
¿Es legal?
El protocolo de la API de Xtream Codes es legal: es un método de distribución, exactamente igual que el M3U. Lo que importa es el proveedor que hay detrás de los datos de acceso.
- Legal: los datos de acceso de un servicio que posee los derechos de los canales que emite.
- No legal: los accesos baratos de «todos los canales» que se venden sin ningún derecho, por muy pulida que parezca la app.
Aviso: un inicio de sesión de Xtream con buena pinta no hace que un servicio sea legítimo. Se aplican las mismas señales de alarma que con cualquier IPTV: todos los canales premium por unos pocos euros, el pago con tarjetas regalo o criptomonedas y la ausencia de una empresa real. WatchlyGuide solo cubre fuentes con licencia.
En resumen
La API de Xtream Codes no es más que una forma más ordenada de iniciar sesión en la IPTV: tres campos —URL de servidor, usuario y contraseña— que cargan tu TV en directo, tus películas, tus series y tu guía como secciones organizadas que se actualizan solas. Está más estructurada que un M3U plano y es distinta de una URL de portal MAG, aunque muchas cuentas admiten las tres. Usa un reproductor compatible, introduce tus datos con exactitud y hazlo siempre y solo con un proveedor que posea los derechos correspondientes.
A continuación, compárala con el formato de lista de reproducción M3U, o empieza por lo básico con qué es la IPTV y cómo funciona realmente el streaming.
¿No tienes claro algún término de esta página? Búscalo en el glosario de streaming.