Everything you need to know about Xtream Codes API protocol, setup, configuration, and troubleshooting for IPTV services
Xtream Codes API is the industry-standard protocol for IPTV service delivery, used by thousands of providers worldwide. This comprehensive guide covers everything from basic setup to advanced API usage, helping both users and developers understand how to work with Xtream Codes effectively. Whether you're setting up your first IPTV subscription or building custom applications, this guide provides the knowledge you need.
Xtream Codes API is a standardized protocol that allows IPTV applications to communicate with IPTV servers. Originally developed by Xtream Codes before its shutdown in 2019, the API protocol has become the de facto standard for IPTV services. Most modern IPTV providers continue to use Xtream Codes API format because of its widespread compatibility and robust feature set.
To connect to an IPTV service using Xtream Codes API, you need three essential pieces of information provided by your IPTV provider:
The server URL is the address of your IPTV provider's server. It typically looks like http://example.com:8080 or http://123.456.789.012:8080. This is where your IPTV app will connect to retrieve channel lists and stream content.
Your unique username identifies your subscription on the IPTV server. This is usually a random string of letters and numbers provided by your IPTV provider. Never share your username with others as it's tied to your subscription.
The password authenticates your account and should be kept secure. Like the username, it's typically a random string provided by your IPTV provider. Some providers allow you to change your password through their customer portal.
Never share your Xtream Codes credentials with anyone. Your provider can track which devices and IP addresses use your account. Sharing credentials may result in account suspension and violates most providers' terms of service.
Open TiviMate and Add Playlist
Launch TiviMate, go to Settings → Playlists → Add Playlist
Select Xtream Codes API
Choose "Xtream Codes API" as the playlist type
Enter Your Credentials
Fill in the following fields:
Save and Load Channels
Click "Next" and TiviMate will automatically load your channel list, VOD, and series
Launch IPTV Smarters Pro
Open the app and select "Login with Xtream Codes API"
Enter Server Information
Input your credentials:
Add User
Click "Add User" and the app will verify your credentials and load content
Access Your Content
Navigate between Live TV, Movies, and Series tabs to access your content
Open Settings
Launch Perfect Player, press the gear icon or back button to access settings
Add Playlist
Go to "General" → "Playlists" → Click "+" to add new playlist
Configure Xtream Codes
Enter your details:
Save and Restart
Save settings and restart Perfect Player to load your channels
For developers and advanced users, understanding Xtream Codes API endpoints is essential. Here are the main API calls used by IPTV applications:
Returns user information, subscription status, expiration date, allowed connections, and server information. This is typically the first API call made to verify credentials.
Returns complete list of available live TV channels with stream IDs, names, categories, and metadata. Apps use this to build the channel list.
Returns list of Video on Demand content including movies with titles, descriptions, ratings, and cover images.
Returns list of TV series with season and episode information, allowing apps to organize content by show.
Returns category list for organizing live channels (Sports, Movies, News, etc.).
Returns Electronic Program Guide data for a specific channel, showing current and upcoming programs.
The actual streaming URL format for playing live channels. Replace STREAM_ID with the channel's stream ID from the get_live_streams response.
| Feature | Xtream Codes API | M3U Playlist |
|---|---|---|
| Setup Complexity | Easy - Just 3 credentials | Medium - Need full URL |
| Channel Updates | Automatic - Real-time sync | Manual - Must reload playlist |
| EPG Support | Built-in - Integrated EPG | Separate - Requires EPG URL |
| VOD & Series | Full Support - Organized by category | Limited - Basic VOD only |
| Catch-up TV | Supported - If provider enables | Not Available |
| App Compatibility | Excellent - Most modern apps | Universal - All IPTV apps |
| Security | Better - Credentials only | Lower - Full URLs exposed |
Use Xtream Codes API whenever your provider supports it. It offers better functionality, automatic updates, and improved security compared to M3U playlists. Only use M3U if your provider doesn't offer Xtream Codes or if you're using an older app that doesn't support the API.
This error indicates the app cannot reach your IPTV server. Common causes include incorrect server URL, network issues, or server downtime.
Solutions:
Authentication failed because the credentials are incorrect or the account is inactive.
Solutions:
Your account is being used on more devices than allowed by your subscription plan.
Solutions:
The API returned successfully but no channels were loaded. This usually indicates a server-side issue.
Solutions:
Your subscription has reached its expiration date and needs to be renewed.
Solutions:
Xtream Codes supports catch-up TV, allowing you to watch programs that aired in the past few days. If your provider enables this feature, you can access it through compatible apps.
How to use:
Some providers offer multiple quality options for the same channel through Xtream Codes API. This allows you to choose between HD, SD, and low-quality streams based on your internet speed.
Quality options:
Xtream Codes API includes parental control information that apps can use to restrict access to adult content. Categories marked as adult require PIN entry in compatible apps.
Features:
Unlike M3U playlists, Xtream Codes properly organizes TV series by show, season, and episode. This makes it easy to binge-watch series and track your progress.
Organization:
Never share your Xtream Codes credentials with anyone. Store them securely and change your password regularly if your provider allows it. Use different passwords for different services to minimize risk if one account is compromised.
Stick to well-known IPTV apps like TiviMate, IPTV Smarters Pro, or Perfect Player. These apps properly implement Xtream Codes API and receive regular updates. Avoid unknown apps that might mishandle your credentials or contain malware.
Keep track of which devices are using your IPTV subscription. Most providers show active connections in their customer portal. If you see unexpected connections, change your password immediately and contact your provider.
Keep your IPTV apps updated to the latest versions. Updates often include improvements to Xtream Codes API handling, bug fixes, and new features. Enable automatic updates when possible to ensure you always have the latest version.
When trying a new IPTV provider, start with a short subscription (24 hours or 1 week) to test their Xtream Codes implementation. Verify that channels load quickly, EPG works correctly, and VOD/series are properly organized before purchasing longer subscriptions.
Save your Xtream Codes credentials in a secure location (password manager or encrypted note). This makes it easy to reconfigure if you switch devices or need to reinstall apps. Some apps also offer backup/restore features for your settings.
Xtream Codes API is a standardized protocol for IPTV service delivery that allows apps to communicate with IPTV servers. It provides access to live TV, VOD, series, EPG, and other features through a set of API endpoints. Most modern IPTV providers use this protocol.
Yes, the Xtream Codes API protocol continues to work even after the original company shut down in 2019. The API format has become an industry standard, and most IPTV providers continue to use Xtream Codes-compatible servers.
Your IPTV provider will give you Xtream Codes credentials (server URL, username, password) when you purchase a subscription. These are typically sent via email or available in your customer portal. Never share these credentials with others.
Yes, but the number of simultaneous connections depends on your subscription plan. Most providers offer 1-5 connections. You can install the same credentials on multiple devices, but only the allowed number can stream at once.
Most modern IPTV apps support Xtream Codes including TiviMate, IPTV Smarters Pro, Perfect Player, GSE Smart IPTV, OTT Navigator, and many others. Check your app's documentation to confirm Xtream Codes support.
Xtream Codes is an API protocol that provides dynamic content updates, EPG integration, VOD organization, and catch-up TV. M3U is a static playlist file that requires manual updates and has limited features. Xtream Codes is generally superior when available.
Connection issues are usually caused by incorrect server URL, wrong credentials, network problems, or server downtime. Verify your credentials are correct, check your internet connection, and contact your provider if the problem persists.
Xtream Codes playlists update automatically when you restart your IPTV app or manually refresh. Unlike M3U playlists, you don't need to download new files - the API always provides the latest channel list from your provider.
Yes, you can generate an M3U playlist from Xtream Codes credentials using the URL format: http://server:port/get.php?username=USERNAME&password=PASSWORD&type=m3u_plus&output=ts. However, you'll lose many Xtream Codes features.
Xtream Codes itself is reasonably secure as it uses username/password authentication. However, security depends on your provider's implementation and whether they use HTTPS. Always use strong passwords and don't share credentials.
This error means your account is being used on more devices than your subscription allows. Close IPTV apps on other devices, wait for connections to timeout (5-10 minutes), or upgrade to a plan with more simultaneous connections.
Your provider should give you the server URL when you subscribe. It typically looks like http://example.com:8080 or http://123.456.789.012:8080. Check your welcome email or customer portal, or contact provider support.
Yes, Xtream Codes works with VPN. In fact, using a VPN is recommended for IPTV to protect privacy and prevent ISP throttling. Just ensure your VPN doesn't significantly slow your connection, which could cause buffering.
Catch-up TV allows you to watch programs that aired in the past few days. If your provider enables this feature, you can access it through the EPG by selecting past programs. Availability typically ranges from 1-7 days depending on the provider.
Parental controls are configured in your IPTV app, not in Xtream Codes itself. Most apps that support Xtream Codes offer PIN protection, content filtering, and kids modes. Enable these features in your app's settings.
An empty playlist usually indicates a server-side issue. Wait a few minutes and try reloading, clear your app cache, or contact your provider. They may be updating their channel list or experiencing technical difficulties.
No, sharing credentials violates most providers' terms of service and can result in account suspension. Providers can track which devices and IP addresses use your account. Each user should have their own subscription.
For SD streaming, you need at least 5 Mbps. For HD streaming, aim for 10-15 Mbps per device. If multiple devices will stream simultaneously, multiply these requirements. A 50 Mbps connection comfortably supports 3-4 HD streams.
Double-check your credentials for typos, ensure no extra spaces, verify your subscription is active, and confirm the server URL is correct. If everything looks right, contact your provider to verify your account status.
Yes, if your Smart TV supports IPTV apps that work with Xtream Codes. Samsung Tizen and LG webOS have limited app options, but Android TV and Fire TV have excellent Xtream Codes app support including TiviMate and IPTV Smarters Pro.
Xtream Codes API has become the gold standard for IPTV service delivery, offering superior functionality compared to traditional M3U playlists. Understanding how to properly configure and use Xtream Codes credentials ensures you get the best possible experience from your IPTV subscription.
Whether you're a casual user setting up your first IPTV service or a developer building custom applications, this guide provides the foundation you need to work effectively with Xtream Codes API. Always use reputable IPTV apps, keep your credentials secure, and follow best practices to ensure reliable streaming.
As IPTV technology continues to evolve, Xtream Codes API remains the most widely supported and feature-rich protocol for delivering live TV, VOD, and series content. By mastering Xtream Codes, you'll be well-equipped to enjoy the full capabilities of modern IPTV services.