Qu’est-ce que l’API Xtream Codes ? Portail expliqué 2026

Dernière mise à jour : · Par l’équipe WatchlyGuide

L’API Xtream Codes est une façon de diffuser l’IPTV fondée sur une connexion à un compte : au lieu d’un unique lien de playlist, vous saisissez une URL de serveur, un nom d’utilisateur et un mot de passe, et l’application charge vos chaînes, vos films, vos séries et votre guide des programmes sous forme de listes classées qui s’actualisent toutes seules. C’est l’alternative la plus répandue à une simple playlist M3U, et c’est ce que désignent la plupart des lecteurs IPTV modernes par « Se connecter avec Xtream Codes ». Ce guide explique son fonctionnement, ce qui la distingue du M3U et des URL de portail, et comment l’utiliser sans risque.

L’écran de connexion d’un lecteur IPTV, avec les champs URL de serveur, nom d’utilisateur et mot de passe de l’API Xtream Codes
L’API Xtream Codes charge tout votre service à partir de trois champs : URL, nom d’utilisateur et mot de passe.
Sur cette page

Ce qu’est l’API Xtream Codes

Xtream Codes a d’abord été un logiciel de gestion (un « panel ») que les fournisseurs d’IPTV utilisaient pour administrer les abonnements. Son API — la façon dont les applications dialoguent avec ce serveur — est devenue un standard de fait : aujourd’hui, « API Xtream Codes » désigne surtout la méthode de connexion employée par votre lecteur, même quand le fournisseur fait tourner un autre logiciel en coulisses.

Le trait caractéristique, c’est que vous vous authentifiez avec trois informations :

  • L’URL du serveur — l’adresse du serveur du fournisseur, par exemple http://example.com:8080.
  • Le nom d’utilisateur — l’identifiant de votre compte.
  • Le mot de passe — la clé de votre compte.

À partir de là, l’application demande tout le reste. Vous ne collez jamais une gigantesque liste de chaînes : le serveur transmet à votre lecteur des données structurées, à la demande.

Comment elle fonctionne

Quand vous vous connectez, votre lecteur IPTV appelle l’API du serveur et reçoit votre service découpé en sections nettes :

  1. L’authentification. L’application envoie votre nom d’utilisateur et votre mot de passe à l’URL du serveur, et récupère les informations de votre compte (statut, échéance, connexions autorisées).
  2. Les catégories de contenu. Le serveur renvoie les chaînes en direct, la VOD (les films) et les séries sous forme de listes distinctes et classées, et non d’un fichier unique.
  3. Les flux à la demande. Quand vous ouvrez une chaîne, l’application ne demande que ce flux : le chargement est donc rapide.
  4. L’EPG. Le guide des programmes est fourni par la même API, si bien que l’EPG s’aligne sur vos chaînes sans URL séparée.

Comme les listes résident sur le serveur, le fournisseur peut ajouter ou retirer des chaînes et votre application le reflète à la prochaine actualisation — sans réimport.

Schéma d’une application IPTV qui envoie l’URL Xtream, un identifiant et un mot de passe au serveur et reçoit direct, VOD, séries et EPG
Une seule connexion renvoie quatre sections classées : direct, VOD, séries et EPG.

API Xtream, M3U ou URL de portail

Ces trois notions se recoupent et sont souvent confondues. Voici comment elles se comparent :

Playlist M3U API Xtream Codes URL de portail (type MAG)
Ce que vous saisissez Une URL ou un fichier de playlist URL de serveur + nom d’utilisateur + mot de passe URL de portail (liée à l’adresse MAC)
Structure du contenu Une liste unique Direct / VOD / Séries classés Mise en page définie par le fournisseur
EPG URL d’EPG séparée Intégré à l’API Intégré au portail
Mises à jour Réimport nécessaire Automatiques Automatiques
Appareils habituels Presque tous les lecteurs TiviMate, IPTV Smarters, etc. Boîtiers MAG / émulateurs de STB

En résumé : le M3U est le plus simple et le plus universel, l’API Xtream Codes est la plus organisée pour les applications, et une URL de portail correspond au style boîtier, lié à l’adresse MAC de votre appareil. Beaucoup de fournisseurs proposent les trois depuis un même compte.

Bon à savoir : la plupart des serveurs Xtream peuvent aussi fournir un lien M3U en ajoutant un chemin get.php — par exemple http://server:port/get.php?username=USER&password=PASS&type=m3u_plus — pour qu’un lecteur n’acceptant que le M3U puisse tout de même charger les mêmes chaînes.

Comment se connecter

Se connecter avec Xtream Codes prend moins d’une minute dans la plupart des lecteurs :

  1. Choisissez un lecteur compatible comme TiviMate ou IPTV Smarters — voyez notre guide des meilleurs lecteurs IPTV.
  2. Sélectionnez « Se connecter avec Xtream Codes » (parfois « API Xtream Codes » ou « Ajouter une playlist → Xtream »).
  3. Saisissez vos trois champs — URL de serveur, nom d’utilisateur, mot de passe — exactement comme votre fournisseur les a transmis, numéro de port compris.
  4. Attendez le chargement. L’application récupère automatiquement les chaînes en direct, la VOD, les séries et l’EPG.
  5. Organisez. Masquez les catégories inutiles et réordonnez vos favoris ; la plupart des lecteurs mémorisent ces réglages par profil.

Pour un pas-à-pas complet dans l’application, suivez notre guide d’installation de TiviMate.

Le protocole de l’API Xtream Codes est légal — c’est un mode de diffusion, exactement comme le M3U. Ce qui compte, c’est le fournisseur derrière les identifiants.

  • Légal : des identifiants fournis par un service qui détient les droits sur les chaînes qu’il diffuse.
  • Illégal : des accès « toutes chaînes » à bas prix vendus sans aucun droit, quelle que soit la qualité de l’application.

Attention : une connexion Xtream soignée ne rend pas un service légitime pour autant. Les mêmes signaux d’alerte valent que pour toute IPTV : toutes les chaînes premium pour quelques euros, un paiement par carte cadeau ou en cryptomonnaie, et aucune société réelle. WatchlyGuide ne traite que des sources licenciées.

En résumé

L’API Xtream Codes n’est qu’une manière plus ordonnée de se connecter à l’IPTV : trois champs — URL de serveur, nom d’utilisateur et mot de passe — qui chargent vos chaînes en direct, vos films, vos séries et votre guide en sections classées et auto-actualisées. Elle est plus structurée qu’un M3U à plat et différente d’une URL de portail MAG, même si beaucoup de comptes prennent en charge les trois. Utilisez un lecteur compatible, saisissez vos informations à l’identique, et uniquement avec un fournisseur qui détient les droits nécessaires.

Comparez ensuite avec le format de playlist M3U, ou reprenez les bases avec ce qu’est l’IPTV et comment fonctionne réellement le streaming.

Un terme de cette page vous échappe ? Cherchez-le dans le glossaire du streaming.

Questions fréquentes

Qu’est-ce que l’API Xtream Codes ?

L’API Xtream Codes est un système de diffusion IPTV fondé sur une connexion à un compte. Au lieu d’un unique lien de playlist, vous saisissez une URL de serveur, un nom d’utilisateur et un mot de passe. L’application interroge alors le serveur et charge vos chaînes en direct, vos films, vos séries et votre guide des programmes sous forme de listes classées par catégories, mises à jour automatiquement.

Quelle différence entre l’API Xtream et le M3U ?

Une playlist M3U est un lien unique contenant toutes les chaînes à la suite, tandis que l’API Xtream Codes utilise trois champs — URL de serveur, nom d’utilisateur et mot de passe — pour charger les chaînes, la VOD, les séries et l’EPG en sections distinctes et classées. Xtream est plus organisé et s’actualise tout seul ; le M3U est plus simple, mais reste une longue liste unique.

Qu’est-ce qu’une URL de portail ?

Une URL de portail est l’adresse du serveur auquel se connecte votre application IPTV, généralement sous la forme http://serveur:port. Avec l’API Xtream Codes, vous l’associez à un nom d’utilisateur et à un mot de passe ; avec certaines applications de boîtier (de type MAG), l’URL du portail suffit à charger le service, en s’appuyant sur l’adresse MAC de votre appareil.

Comment se connecter avec l’API Xtream Codes ?

Ouvrez un lecteur IPTV compatible avec la connexion Xtream Codes, comme TiviMate ou IPTV Smarters, choisissez l’option Xtream Codes ou « Se connecter avec Xtream », puis saisissez l’URL de serveur, le nom d’utilisateur et le mot de passe fournis par votre fournisseur. L’application se connecte et charge automatiquement vos chaînes en direct, la VOD, les séries et l’EPG.

L’API Xtream Codes est-elle légale ?

La technologie et le protocole Xtream Codes sont légaux : ce n’est qu’un mode de diffusion, comme le M3U. La légalité dépend entièrement du fournisseur derrière les identifiants. Les services licenciés qui l’emploient ne posent aucun problème ; des identifiants vendus à bas prix pour des chaînes premium sans droits, si. N’utilisez que des fournisseurs licenciés.

Peut-on convertir l’API Xtream Codes en M3U ?

Oui. La plupart des serveurs Xtream proposent une sortie M3U en ajoutant un chemin get.php à l’URL du serveur, avec votre nom d’utilisateur et votre mot de passe, par exemple http://server:port/get.php?username=USER&password=PASS&type=m3u_plus. Les lecteurs qui n’acceptent que le M3U peuvent ainsi charger les mêmes chaînes que la connexion Xtream.