# ๐Ÿ“ก XtreamCodes API The API provides access to IPTV streams (Live TV, Radio), VOD (Movies), Series, and EPG (TV guide) for applications compatible with XtreamCodes. It is a core component for integration with XC_VM. --- ## ๐Ÿ“š Navigation - [๐Ÿ“‚ File Location](#file-location) - [๐Ÿ“‘ Overview](#overview) - [๐Ÿ”‘ Authorization](#authorization) - [๐Ÿ“บ Live TV (TV & Radio)](#live-tv-tv--radio) - [๐ŸŽฌ VOD (Movies)](#vod-movies) - [๐Ÿ“ฝ Series](#series) - [๐ŸŽž Media Access](#media-access) - [๐Ÿงพ Notes](#notes) --- ## File Location The main API is handled by `PlayerApiController`: ```text src/public/Controllers/Api/PlayerApiController.php ``` The EPG/XMLTV endpoint (`/xmltv.php`) is handled by `EpgApiController`: ```text src/public/Controllers/Api/EpgApiController.php ``` --- ## Overview The API is divided into key sections for easier integration. Each endpoint includes example requests and responses. --- ## Authorization Authorization is the first step to access content. It validates user credentials and returns server information. ### Request ```http GET /player_api?username={username}&password={password} ``` ### Example Response ```json { "user_info": { "username": "testxc", "password": "testxc", "message": "Welcome to XC_VM", "auth": 1, "status": "Active", "exp_date": null, "is_trial": 0, "created_at": 1757353729, "max_connections": 1, "allowed_output_formats": [ "m3u8", "ts", "rtmp" ] }, "server_info": { "xui": true, "version": "1.1.0", "url": "176.124.192.118", "port": "80", "https_port": "443", "server_protocol": "http", "rtmp_port": "8880", "timestamp_now": 1757442189, "time_now": "2025-09-09 19:23:09", "timezone": "Europe/London" } } ``` > ๐Ÿ’ก **Tip:** Use the obtained data for subsequent requests to avoid repeated authentication. --- ## Live TV (TV & Radio) Endpoints for working with live streams, including categories, streams, and EPG. ### Get All Live Categories ```http GET /player_api?username={username}&password={password}&action=get_live_categories ``` #### Example Response ```json [ { "category_id": "1", "category_name": "News", "parent_id": 0 }, { "category_id": "2", "category_name": "Sports", "parent_id": 0 } ] ``` ### Get All Live Streams ```http GET /player_api?username={username}&password={password}&action=get_live_streams ``` #### Example Response ```json [ { "num": 1, "name": "BBC News", "stream_type": "live", "stream_id": 101, "stream_icon": "http://176.124.192.118/images/bbc.png", "epg_channel_id": "bbc.news.uk", "added": "1660568200", "category_id": "1", "custom_sid": "", "tv_archive": 0, "direct_source": "", "tv_archive_duration": 0 } ] ``` ### Get Streams by Category ```http GET /player_api?username={username}&password={password}&action=get_live_streams&category_id={id} ``` ### Get Channel Short EPG ```http GET /player_api?username={username}&password={password}&action=get_short_epg&stream_id={id}&limit={N} ``` #### Example Response ```json { "epg_listings": [ { "id": 1, "title": "Morning News", "start": "2022-08-15 07:00:00", "end": "2022-08-15 08:00:00", "description": "Daily morning news update." } ] } ``` ### Get Full Channel Schedule ```http GET /player_api?username={username}&password={password}&action=get_simple_data_table&stream_id={id} ``` ### Get EPG for All Channels (XMLTV) ```http GET /xmltv.php?username={username}&password={password} ``` #### Example Response (XMLTV) ```xml BBC News Morning News Daily morning news update. ``` --- ## VOD (Movies) Endpoints for Video on Demand, including categories and movie details. ### Get Movie Categories ```http GET /player_api?username={username}&password={password}&action=get_vod_categories ``` #### Example Response ```json [ { "category_id": "10", "category_name": "Action", "parent_id": 0 }, { "category_id": "11", "category_name": "Drama", "parent_id": 0 } ] ``` > โš ๏ธ **Note:** The full list of categories may be large; only fragments are shown in examples. ### Get All VOD Streams ```http GET /player_api?username={username}&password={password}&action=get_vod_streams ``` #### Example Response ```json [ { "num": 1, "name": "The Dark Knight (2008)", "title": "The Dark Knight", "year": 2008, "stream_type": "movie", "stream_id": 1, "stream_icon": "http://176.124.192.118:80/images/...jpg", "rating": 8.5, "rating_5based": 4.3, "added": 1757343129, "plot": "Batman raises the stakes in his war on crime. With the ...", "cast": "Christian Bale, Heath Ledger, Aaron Eckhart, Michael Caine, Maggie Gyllenhaal", "director": "Christopher Nolan, Christopher Nolan, Steve Gehrke", "genre": "Drama, Action, Crime", "release_date": "2008-07-16", "youtube_trailer": "kmJLuwP3MbY", "episode_run_time": "152", "category_id": "1", "category_ids": [1, 2], "container_extension": "mp4", "custom_sid": "", "direct_source": "" } ] ``` ### Get Movies by Category ```http GET /player_api?username={username}&password={password}&action=get_vod_streams&category_id={id} ``` ### Get Movie Info ```http GET /player_api?username={username}&password={password}&action=get_vod_info&vod_id={id} ``` #### Response example ```json { "info": { "kinopoisk_url": "https://www.themoviedb.org/movie/155", "tmdb_id": 155, "name": "The Dark Knight", "o_name": "The Dark Knight", "cover_big": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljuWhs_Jbsg3Nu1tBcV0ErgPL_v9ei3c1fI0mNI7C5eos.jpg", "movie_image": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljuWhs_Jbsg3Nu1tBcV0ErgPL_v9ei3c1fI0mNI7C5eos.jpg", "release_date": "2008-07-16", "episode_run_time": 152, "youtube_trailer": "kmJLuwP3MbY", "director": "Christopher Nolan, Christopher Nolan, Steve Gehrke", "actors": "Christian Bale, Heath Ledger, Aaron Eckhart, Michael Caine, Maggie Gyllenhaal", "cast": "Christian Bale, Heath Ledger, Aaron Eckhart, Michael Caine, Maggie Gyllenhaal", "description": "Batman raises the stakes in his war on crime. With the help of Lt. Jim Gordon and District Attorney Harvey Dent, Batman sets out to dismantle the remaining criminal organizations that plague the streets. The partnership proves to be effective, but they soon find themselves prey to a reign of chaos unleashed by a rising criminal mastermind known to the terrified citizens of Gotham as the Joker.", "plot": "Batman raises the stakes in his war on crime. With the help of Lt. Jim Gordon and District Attorney Harvey Dent, Batman sets out to dismantle the remaining criminal organizations that plague the streets. The partnership proves to be effective, but they soon find themselves prey to a reign of chaos unleashed by a rising criminal mastermind known to the terrified citizens of Gotham as the Joker.", "age": "", "mpaa_rating": "", "rating_count_kinopoisk": 0, "country": "United Kingdom", "genre": "Drama, Action, Crime", "backdrop_path": [ "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCADBzwKB171qpiTTqrZdeATVLqPvNOO1tw6QZZproFAJRjrtA4EzIxoMJZlI2R3OlQ.jpg" ], "duration_secs": 9120, "duration": "02:32:00", "bitrate": 0, "rating": 8.52, "releasedate": "2008-07-16", "subtitles": [] }, "movie_data": { "stream_id": 1, "name": "The Dark Knight (2008)", "title": "The Dark Knight", "year": 2008, "added": 1757343129, "category_id": "1", "category_ids": [1, 2], "container_extension": "mp4", "custom_sid": "", "direct_source": "" } } ``` --- ## Series Endpoints for managing TV shows, including categories, seasons, and episodes. ### Get Series Categories ```http GET /player_api?username={username}&password={password}&action=get_series_categories ``` #### Response example ```json [ { "category_id": "20", "category_name": "Drama", "parent_id": 0 } ] ``` --- ### All series ```http GET /player_api?username={username}&password={password}&action=get_series ``` #### Example Response ```json [ { "num": 1, "name": "Braceface (2001)", "title": "Braceface", "year": 2001, "stream_type": "series", "series_id": 1, "cover": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljpT6mCZeHa4zLXMQZ2eaTpGZUSOucptPKyuP5tgpEZm0.jpg", "plot": "The show, set in Elkford, British Columbia, is based around Sharon Spitz, who is a junior high school student with braces that get in her way of leading a normal teenage life. In the first season, she is enrolled at Mary Pickford Junior High.", "cast": "Stacey DePass", "director": "Charles E. Bastien", "genre": "Drama, Animation, Comedy", "release_date": "2001-06-02", "releaseDate": "2001-06-02", "last_modified": "1757348651", "rating": "7", "rating_5based": 3.5, "backdrop_path": [ "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCADBzwKB171qpiTTqrZdeATBaSzxZEgi9EPIvh5kU_50ecbH2L-yDt1PIfqijKTIMg.jpg" ], "youtube_trailer": null, "episode_run_time": 25, "category_id": "4", "category_ids": [4] } ] ``` --- ### Series by Category ```http GET /player_api?username={username}&password={password}&action=get_series&category_id={id} ``` ### Get Series Info ```http GET /player_api?username={username}&password={password}&action=get_series_info&series_id={id} ``` #### Example Response ```json { "seasons": [ { "air_date": "2001-06-02", "episode_count": 26, "id": 4937, "name": "Season 1", "overview": "", "season_number": 1, "vote_average": 4.5, "cover": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljJBrZ7sNEJHE6hlqofFOJSRKiMRvSj08-T6iTQVWvj2I.jpg", "cover_big": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljJBrZ7sNEJHE6hlqofFOJSRKiMRvSj08-T6iTQVWvj2I.jpg" } ], "info": { "name": "Braceface (2001)", "title": "Braceface", "year": 2001, "cover": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCLaoCzC2XshRjzbEF-0-ISX3OBAKZPN21ASjMFFF_OljpT6mCZeHa4zLXMQZ2eaTpGZUSOucptPKyuP5tgpEZm0.jpg", "plot": "The show, set in Elkford, British Columbia, is based around Sharon Spitz, who is a junior high school student with braces that get in her way of leading a normal teenage life. In the first season, she is enrolled at Mary Pickford Junior High.", "cast": "Stacey DePass", "director": "Charles E. Bastien", "genre": "Drama, Animation, Comedy", "release_date": "2001-06-02", "releaseDate": "2001-06-02", "last_modified": "1757348651", "rating": "7", "rating_5based": 3.5, "backdrop_path": [ "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCADBzwKB171qpiTTqrZdeATBaSzxZEgi9EPIvh5kU_50ecbH2L-yDt1PIfqijKTIMg.jpg" ], "youtube_trailer": null, "episode_run_time": 25, "category_id": "4", "category_ids": [4] }, "episodes": { "1": [ { "id": "2", "episode_num": "1", "title": "Braceface - S01E01 - Brace Yourself", "container_extension": "mp4", "info": { "release_date": "2001-06-02", "plot": "Sharon Spitz, a 13-year-old 8th grader gets braces the day before picture day. During the procedure, a thunderstorm causes a power outage, and something strange happens with Sharon's braces, making her do all sorts of weird things!", "duration_secs": 649, "duration": "00:10:49", "movie_image": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCADBzwKB171qpiTTqrZdeARCK8Ch0a6wlNxuIHhbJ3c1Dg_AqkwSsH-qdpnCvcMsiy6U85vvi1bs1xDOddBeOEQ.jpg", "bitrate": 2791, "rating": "5", "season": "1", "tmdb_id": "105800", "cover_big": "http://176.124.192.118:80/images/7pQr8EhEi05VXRmZc5QfCADBzwKB171qpiTTqrZdeARCK8Ch0a6wlNxuIHhbJ3c1Dg_AqkwSsH-qdpnCvcMsiy6U85vvi1bs1xDOddBeOEQ.jpg" }, "subtitles": [], "custom_sid": "", "added": 1757348651, "season": 1, "direct_source": "" } ] } } ``` --- ## Media Access After authorization, you can access direct links to media files. - **Live TV (channel):** ```http http://176.124.192.118/live/{username}/{password}/{stream_id}.ts ``` - **Movie (VOD):** ```http http://176.124.192.118/movie/{username}/{password}/{vod_id}.mp4 ``` - **Episode:** ```http http://176.124.192.118/series/{username}/{password}/{episode_id}.mp4 ``` > โš ๏ธ **Important:** On the first request, a redirect occurs to `/auth/...` for authentication before content is served. --- ## Notes - **Output Formats:** Supported formats โ€” `m3u8`, `ts`, `rtmp`. Choose based on your device. - **Security:** All requests require valid authorization; monitor logs for access errors. - **Integration:** Use tools like Postman for testing. Implement response caching in your application for better performance. > ๐Ÿ’ฌ If you have integration issues, please open an issue in the [repository](https://github.com/Vateron-Media/XC_VM/issues). ---