Mayk IP TV

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 / TagTierTypeExample ValueDescription
user_info.authRequiredInteger (1 = success)1Authentication status code: integer 1 indicates successful credentials.
user_info.statusRequiredString ("Active")"Active"Account subscription status; must be 'Active' for stream access.
user_info.exp_dateRequiredUnix Timestamp / null"1775000000"Expiration timestamp in Unix epoch seconds, or null for unlimited.
user_info.max_connectionsRequiredString / Integer"2"Maximum number of simultaneous active player connections permitted.
user_info.allowed_output_formatsRequiredArray of String["m3u8", "ts"]List of supported stream container formats (m3u8, ts, mp4, mkv).
server_infoRequiredObject{"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 / TagTierTypeExample ValueDescription
get_live_categoriesRequiredArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Catalog action returning the array of live television category objects.
get_vod_categoriesRequiredArray 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_categoriesRequiredArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Catalog action returning the array of TV series category objects.
get_live_streamsRequiredArray 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_streamsRequiredArray 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_seriesRequiredArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Catalog action returning TV series overview entries.
get_series_infoRequiredSeries 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 / TagTierTypeExample ValueDescription
stream_idRequiredInteger / String101Unique numeric or string stream identifier for live and movie items.
nameRequiredString"TRT 1 HD"Display name of the television channel or video-on-demand movie.
stream_typeRequiredString ("live" | "movie")"live"Stream classification string: 'live' for TV or 'movie' for VOD.
stream_iconOptionalURL (http/https)"https://stream.example.com:8080/images/101.png"Direct HTTP/HTTPS URL for the channel logo or movie poster image.
category_idRequiredString / Integer"1"Category identifier referencing an existing category ID.
container_extensionRequiredString without dot ("mp4", "mkv", "m3u8")"mp4"Target stream container file extension without dot (mp4, mkv, m3u8).
is_adultOptionalInteger / String ("0" | "1")"0"Age restriction flag: integer or string '1' marks adult material.

Series & Episode Data Fields

Field / TagTierTypeExample ValueDescription
series_idRequiredInteger / String303Unique identifier for the television series record.
nameRequiredString"Example Series"Canonical title of the television series.
coverOptionalURL (http/https)"https://stream.example.com:8080/images/series303.png"Direct HTTP/HTTPS poster cover image URL for the series.
category_idRequiredString / Integer"20"Category identifier matching an entry in series categories.
seasonRequiredInteger / String1Season number containing the specific episode item.
episode_numRequiredInteger / String1Episode sequence number within the season.
container_extensionRequiredString without dot ("mp4", "mkv")"mp4"Video container file extension without leading dot for episode.

Stream URL Patterns

TypeField / TagExample Value
Live TV{server}/live/{username}/{password}/{stream_id}.m3u8https://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

GET /player_api.php (user_info & server_info)
{
  "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"
  }
}
get_live_streams & get_vod_streams
[
  {
    "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"
  }
]
get_series_info (seasons & episodes)
{
  "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.