Contents
On this page

Get Title - Plugixa Stream

GET /plugixa-stream/v1/series/{id}

One title as its screen in the Watch app shows it: the details, every published episode with its lock state, and what the caller has done with it.

Public: no sign-in needed. Only published titles and episodes are ever returned. Signed in, viewer also holds the caller’s My List, like and progress.

Note. An episode list never carries a stream URL. locked is the answer Play Episode will give, worked out on the server for this caller.

Request

GET https://your-site.example/wp-json/plugixa-stream/v1/series/2814

Path parameters

Name Type Description
id integer The title’s id

Responses

200 OK. data is the title.

{
  "success": true,
  "data": {
    "id": 2814,
    "slug": "flash-gordon",
    "kind": "series",
    "year": 1936,
    "title": "Flash Gordon",
    "poster": "https://your-site.example/wp-content/uploads/2026/10/flash-gordon-1936-poster-768x1165.jpg",
    "genres": ["Action", "Adventure", "Sci-Fi"],
    "episode_count": 13,
    "duration": 0,
    "release_status": "completed",
    "url": "https://your-site.example/series/flash-gordon/",
    "watch_url": "https://your-site.example/watch/#/series/2814",
    "synopsis": "<p>Polo player Flash Gordon, Dale Arden and Dr. Zarkov rocket to the planet Mongo.</p>\n",
    "banner": "https://your-site.example/wp-content/uploads/2026/10/flash-gordon-1936-banner.png",
    "trailer": "",
    "trailer_media": null,
    "age_rating": "7+",
    "tags": [],
    "studios": ["Universal Pictures"],
    "languages": ["English"],
    "original_lang": "en",
    "episodes": [
      {
        "id": 2815,
        "series_id": 2814,
        "number": 1,
        "season": 1,
        "title": "Chapter 1: The Planet of Peril",
        "duration": 1134,
        "thumbnail": "",
        "free": true,
        "locked": false
      },
      {
        "id": 2818,
        "series_id": 2814,
        "number": 4,
        "season": 1,
        "title": "Chapter 4: Battling the Sea Beast",
        "duration": 1034,
        "thumbnail": "",
        "free": false,
        "locked": true
      }
    ],
    "viewer": {
      "likes": 3,
      "in_list": true,
      "liked": false,
      "progress": {
        "2815": {
          "position": 1134,
          "completed": true
        }
      }
    }
  }
}
Field Type Meaning
data.* Every field of a title card (see Browse Titles), plus:
data.synopsis string HTML, with paragraphs
data.banner string Banner image URL, or empty
data.trailer string The trailer link as entered, or empty
data.trailer_media object|null What the page can play behind the artwork, or null
data.age_rating string Empty, all, 7+, 13+, 16+ or 18+
data.tags string[] Tag names
data.studios string[] Studio names
data.languages string[] Language names
data.original_lang string The spoken language, a tag such as en
data.episodes object[] Published episodes in playing order. Fields below
data.viewer.likes integer Likes the title has
data.viewer.in_list boolean Signed in only: on the caller’s My List
data.viewer.liked boolean Signed in only: the caller liked it
data.viewer.progress object Signed in only: by episode id, position (seconds) and completed
data.episodes[].id integer The episode’s id
data.episodes[].series_id integer Its title
data.episodes[].number integer Episode number, unique within the title
data.episodes[].season integer Season, 1 or more
data.episodes[].title string Raw title
data.episodes[].duration integer Seconds
data.episodes[].thumbnail string A Media Library image, else the image the video service made, else empty
data.episodes[].free boolean Free for everyone
data.episodes[].locked boolean The caller may not play it now. The same answer Play Episode gives

With Pro, the title also has credits (cast and crew: id, name, photo, role, character), custom_fields (fields with Viewer series page on: key, label, type, value), rating (average, count, when reviews are on), and viewer adds pricing (locked, full_price, bundle_price, discount, in coins) and vip (boolean).

Errors

Status Code When
404 plugixa_stream_not_found No title with that id, it is not published, or a kids profile PRO may not see it.

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-stream/v1/series/2814"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-stream/v1/series/2814');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-site.example/wp-json/plugixa-stream/v1/series/2814');
const { data } = await response.json();

Quick Links

Share