Contents
On this page

Browse Titles - Plugixa Stream

GET /plugixa-stream/v1/series

List published series and movies one page at a time, as the Watch app’s search and filter screen does.

Public: no sign-in needed. Only published titles and episodes are ever returned.

Request

GET https://your-site.example/wp-json/plugixa-stream/v1/series?kind=movie&genre=35&per_page=12

Query parameters

Field Type Required Description
search string No Words to look for. With Pro, also custom fields with Viewer search on.
genre integer No A genre id, from List Genres.
language integer No A language term id.
kind string No series, movie, or empty for both.
year integer No Release year, from List Years. Ignored outside 1900 to next year.
page integer No Page to return, from 1. Defaults to 1.
per_page integer No Titles per page, 1 to 100. Defaults to 24.

Filters combine: every one you send must match. The order is WordPress’s default for a search or a list.

Responses

200 OK. data is one page of title cards.

{
  "success": true,
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "total": 9,
    "pages": 1
  }
}
Field Type Meaning
data[].id integer The title’s id
data[].slug string Its URL slug
data[].kind string series or movie
data[].year integer|null Release year, or null when none is set
data[].title string Raw title: render it as text, not HTML
data[].poster string Poster image URL, empty when there is none
data[].genres string[] Genre names
data[].episode_count integer Published episodes (a movie has 1)
data[].duration integer A movie’s running time in seconds; 0 for a series
data[].release_status string ongoing or completed
data[].url string The title’s public page
data[].watch_url string The title inside the Watch app
meta.total integer Titles matching the filters
meta.pages integer Pages at this per_page

Errors

Status Code When
400 rest_invalid_param kind is not series or movie, or per_page is outside 1 to 100.

Plus the errors every endpoint can return.

Examples

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

Quick Links

Share