{
"user_info": {
"username": "demo_user",
"password": "demo_pass",
"auth": 1,
"status": "Active",
"exp_date": "1775000000",
"is_trial": "0",
"active_cons": "0",
"max_connections": "2",
"created_at": "1700000000",
"allowed_output_formats": [
"m3u8",
"ts",
"mp4",
"mkv"
]
},
"server_info": {
"url": "stream.example.com",
"port": "8080",
"https_port": "8443",
"server_protocol": "https",
"rtmp_port": "8880",
"timezone": "UTC",
"timestamp_now": 1714000000,
"time_now": "2026-10-26 10:00:00"
}
}
Technical API Reference
Xtream Codes player_api.php Standards
Explore the data schemas, authentication protocol, and catalog responses expected by Mayk IP TV when connecting via Xtream Codes API.
Authentication and Server Information
The GET /player_api.php endpoint authenticates credentials and returns user_info and server_info objects. Successful authentication requires user_info.auth equal to 1 and status set to 'Active'.
Six Core Catalog Endpoints
Mayk IP TV queries categories via get_live_categories, get_vod_categories, and get_series_categories, and streams via get_live_streams, get_vod_streams, and get_series. Empty lists must return an empty JSON array [].
Category Integrity and Orphan Items
Every stream and series must reference a category_id that exists in the corresponding categories response. Orphaned IDs cause items to be omitted or misgrouped.
Series Metadata and Episode Mapping
Detailed season and episode structures are fetched via get_series_info&series_id=.... The response must contain an episodes dictionary keyed by season number strings containing episode arrays.
Playback URLs and Byte-Range Seeking
Streams are constructed using standard /live/, /movie/, and /series/ URL patterns. VOD and series servers must support HTTP 206 Partial Content range requests for timeline seeking.
Authentication Fields
| Field / Tag | Tier | Type | Example Value | Description |
|---|---|---|---|---|
user_info.auth | Required | Integer (1 = success) | 1 | Authentication status code: integer 1 indicates successful credentials. |
user_info.status | Required | String ("Active") | "Active" | Account subscription status; must be 'Active' for stream access. |
user_info.exp_date | Required | Unix Timestamp / null | "1775000000" | Expiration timestamp in Unix epoch seconds, or null for unlimited. |
user_info.max_connections | Required | String / Integer | "2" | Maximum number of simultaneous active player connections permitted. |
user_info.allowed_output_formats | Required | Array of String | ["m3u8", "ts"] | List of supported stream container formats (m3u8, ts, mp4, mkv). |
server_info | Required | Object | {"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"} | Server metadata object containing hostname, streaming ports, and protocol. |
Catalog Endpoints and Actions
| Field / Tag | Tier | Type | Example Value | Description |
|---|---|---|---|---|
get_live_categories | Required | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | Catalog action returning the array of live television category objects. |
get_vod_categories | Required | Array of Category Objects | [{"category_id":"10","category_name":"Action","parent_id":0}] | Catalog action returning the array of video-on-demand movie categories. |
get_series_categories | Required | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | Catalog action returning the array of TV series category objects. |
get_live_streams | Required | Array of Live Stream Objects | [{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}] | Catalog action returning all live channels or filtered by category_id. |
get_vod_streams | Required | Array of VOD Stream Objects | [{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}] | Catalog action returning all movie streams or filtered by category_id. |
get_series | Required | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | Catalog action returning TV series overview entries. |
get_series_info | Required | Series Detail Object (episodes map) | {"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}} | Detailed series action returning season summaries and episode mappings. |
Live Stream & VOD Data Fields
| Field / Tag | Tier | Type | Example Value | Description |
|---|---|---|---|---|
stream_id | Required | Integer / String | 101 | Unique numeric or string stream identifier for live and movie items. |
name | Required | String | "TRT 1 HD" | Display name of the television channel or video-on-demand movie. |
stream_type | Required | String ("live" | "movie") | "live" | Stream classification string: 'live' for TV or 'movie' for VOD. |
stream_icon | Optional | URL (http/https) | "https://stream.example.com:8080/images/101.png" | Direct HTTP/HTTPS URL for the channel logo or movie poster image. |
category_id | Required | String / Integer | "1" | Category identifier referencing an existing category ID. |
container_extension | Required | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Target stream container file extension without dot (mp4, mkv, m3u8). |
is_adult | Optional | Integer / String ("0" | "1") | "0" | Age restriction flag: integer or string '1' marks adult material. |
Series & Episode Data Fields
| Field / Tag | Tier | Type | Example Value | Description |
|---|---|---|---|---|
series_id | Required | Integer / String | 303 | Unique identifier for the television series record. |
name | Required | String | "Example Series" | Canonical title of the television series. |
cover | Optional | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Direct HTTP/HTTPS poster cover image URL for the series. |
category_id | Required | String / Integer | "20" | Category identifier matching an entry in series categories. |
season | Required | Integer / String | 1 | Season number containing the specific episode item. |
episode_num | Required | Integer / String | 1 | Episode sequence number within the season. |
container_extension | Required | String without dot ("mp4", "mkv") | "mp4" | Video container file extension without leading dot for episode. |
Stream URL Patterns
| Type | Field / Tag | Example Value |
|---|---|---|
| Live TV | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8 |
| Movie (VOD) | {server}/movie/{username}/{password}/{stream_id}.{container_extension} | https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4 |
| Series Episode | {server}/series/{username}/{password}/{episode_id}.{container_extension} | https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4 |
Sample Templates
[
{
"num": 1,
"name": "TRT 1 HD",
"stream_type": "live",
"stream_id": 101,
"stream_icon": "https://stream.example.com:8080/images/101.png",
"epg_channel_id": "trt1.tr",
"added": "1700000000",
"category_id": "1",
"custom_sid": null,
"tv_archive": 1,
"direct_source": "",
"tv_archive_duration": 3
},
{
"num": 2,
"name": "Example Movie (2026)",
"stream_type": "movie",
"stream_id": 202,
"stream_icon": "https://stream.example.com:8080/images/202.png",
"category_id": "10",
"container_extension": "mp4",
"rating": "8.4",
"year": "2026"
}
]
{
"seasons": [
{
"air_date": "2026-01-01",
"episode_count": 10,
"id": 1,
"name": "Season 1",
"overview": "First season overview",
"season_number": 1,
"cover": "https://stream.example.com:8080/images/season1.png"
}
],
"info": {
"name": "Example Series",
"cover": "https://stream.example.com:8080/images/series303.png",
"plot": "Series plot description",
"cast": "Actor One, Actor Two",
"director": "Director Name",
"genre": "Drama",
"releaseDate": "2026-01-01",
"rating": "8.7",
"category_id": "20"
},
"episodes": {
"1": [
{
"id": "30301",
"episode_num": 1,
"title": "Pilot",
"container_extension": "mp4",
"info": {
"duration_secs": 2700,
"duration": "00:45:00",
"video": {},
"audio": {},
"bitrate": 4500
},
"season": 1
}
]
}
}
Interactive Format Checker
Paste your M3U snippet or Xtream JSON payload below to verify compatibility with Mayk IP TV parsing rules.
Xtream API Compatibility Checklist
- Return user_info.auth = 1 and status = Active for valid user credentials.
- Return an empty JSON array [] rather than null or an object when lists are empty.
- Verify all stream category_id values match active category records.
- Provide clean container_extension values without leading dots (e.g., mp4, mkv).
- Ensure the media server supports HTTP 206 Partial Content for seeking.