API Documentation

Embed movies and TV shows with a single URL. No API key required.

Base URL

All endpoints are relative to this base. No authentication required for public embed and listing endpoints.

Iframe Usage

Embed the player in your page using a standard iframe.

Rate Limits

Exceeding the limit returns 429 Too Many Requests.

Movie Embed

TV Show Embed

Episode Embed

Optional Parameters

These query parameters work with all embed endpoints.

postMessage API

The player communicates bidirectionally with its parent page via window.postMessage. All messages use type: "mplayer".

const player = document.getElementById('mplayer-iframe');

// Send a command to the player
player.contentWindow.postMessage({ type: 'mplayer', action: 'play' }, '*');

// Listen to player events
window.addEventListener('message', (e) => {
  if (e.data?.type === 'mplayer') {
    console.log(e.data.event, e.data);
  }
});

Inbound Commands (parent → player)

Outbound Events (player → parent)

Keyboard Shortcuts

Progress / Resume API

The player automatically saves watch position server-side using an anonymous session cookie (mpsid). Position is saved every 30 seconds and on pause/end. A "Resume from X:XX?" prompt appears for returning viewers.

{
  "position": 1234,    // seconds
  "duration": 7200,    // total duration
  "percent":  17,       // 0–100
  "ts":       1710000000000
}

{ "saved": true, "position": 1234 }

Thumbnail Preview API

Generates seek bar thumbnail previews from the video stream using FFmpeg. First request triggers background generation and returns 202. Subsequent requests return 200 once ready. The player automatically polls these endpoints.

List Available Subtitles

[
  { "lang": "en", "label": "English" },
  { "lang": "es", "label": "Spanish" }
]

Fetch Subtitle File

List Latest Movies

{
  "page": 1,
  "total_pages": 5,
  "result": [
    {
      "imdb_id": "tt0468569",
      "tmdb_id": 155,
      "title": "The Dark Knight",
      "year": 2008,
      "poster": "https://image.tmdb.org/...",
      "embed_url_imdb": "/embed/movie/tt0468569",
      "embed_url_tmdb": "/embed/movie/155"
    }
  ]
}

List Latest TV Shows

{
  "page": 1,
  "total_pages": 3,
  "result": [
    {
      "imdb_id": "tt0944947",
      "tmdb_id": 1399,
      "show_title": "Game of Thrones",
      "embed_url": "/embed/tv/1399"
    }
  ]
}

List Latest Episodes

{
  "page": 1,
  "total_pages": 120,
  "result": [
    {
      "tmdb_id": 2894230,
      "show_title": "Mom",
      "season_num": 8,
      "episode_num": 18,
      "embed_url": "/embed/tv/2894230/8/18"
    }
  ]
}