Contents
On this page

Get Home - Plugixa Stream

GET /plugixa-stream/v1/home

Everything the Watch app’s home screen shows in one call: up to 5 featured titles for the hero carousel, then every home row that has titles in it.

Public: no sign-in needed. Only published titles and episodes are ever returned. Signed in, the answer also carries the caller’s Continue watching cards.

Note. Rows come from Home rows in the admin, in their saved order. A row whose rule finds no published title is left out of the answer, not sent empty. Until rows are saved, the site has two: Trending now and New releases.

Request

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

Responses

200 OK. data holds hero, rows and, signed in, continue.

{
  "success": true,
  "data": {
    "hero": [
      {
        "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",
        "banner": "https://your-site.example/wp-content/uploads/2026/10/flash-gordon-1936-banner.png",
        "blurb": "Polo player Flash Gordon, Dale Arden and Dr. Zarkov rocket to the planet Mongo to stop it from colliding with Earth…"
      }
    ],
    "rows": [
      {
        "id": "new",
        "title": "New releases",
        "type": "new",
        "items": [
          {
            "id": 2681,
            "slug": "sintel",
            "kind": "movie",
            "year": 2010,
            "title": "Sintel",
            "poster": "https://your-site.example/wp-content/uploads/2026/10/sintel-poster-768x1086.jpg",
            "genres": ["Adventure", "Animation", "Fantasy", "Short"],
            "episode_count": 1,
            "duration": 888,
            "release_status": "completed",
            "url": "https://your-site.example/series/sintel/",
            "watch_url": "https://your-site.example/watch/#/series/2681"
          }
        ]
      }
    ],
    "continue": [
      {
        "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": 1147,
        "release_status": "completed",
        "url": "https://your-site.example/series/flash-gordon/",
        "watch_url": "https://your-site.example/watch/#/series/2814",
        "episode": 2,
        "position": 312,
        "resume": "https://your-site.example/watch/#/series/2814/ep/2"
      }
    ]
  }
}
Field Type Meaning
data.hero object[] Featured published titles, at most 5. Each is a title card plus banner (the banner image, else the poster) and blurb (the synopsis as plain text, 24 words at most)
data.rows[].id string The row’s id
data.rows[].title string The row’s heading
data.rows[].type string manual, featured, new, genre, trending; with Pro also top_rated
data.rows[].items object[] Title cards, as in Browse Titles
data.continue object[] Signed in only: up to 12 titles in progress, newest first. Each is a title card plus episode (number to resume), position and duration in seconds, and resume (the Watch app link to that episode)

A finished episode points at the next one, from the start; a title watched to its last episode drops out of continue. With Pro, a kids profile only gets titles its age rating allows.

Errors

This endpoint has no errors of its own.

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-stream/v1/home"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-stream/v1/home');
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/home');
const { data } = await response.json();

Quick Links

Share