Skip to content
MediuxDocs

Indexes, feeds and pages

Public routes don’t take query strings, so there are three fixed ways through a lot of results:

You wantUse
Everything of one typeIndexes
What’s new or changedActivity feeds
One creator’s Sets, Assets, ListsCreator pages

Each title type has an index (/shows, /movies, …), as do creators (/users) and Public Lists (/lists). An index is a manifest of chunks, each with its path, itemCount and when it last changed:

{
"data": [
{
"chunk": 0,
"path": "/shows/chunks/0",
"itemCount": 1111,
"updatedAt": "2026-11-15T07:55:55.544Z"
}
],
"meta": {
"scheme": "idRange",
"chunkSize": 10000,
"chunkCount": 33,
"totalItems": 7437
}
}

Fetch the manifest, then the chunks you need.

  • idRange (titles and other numeric IDs): chunk n holds IDs from n × chunkSize up to the next boundary, in ascending order. chunkSize differs by type.
  • uuidPrefix (creators and Public Lists): a chunk holds the IDs that start with the same two hexadecimal digits.

A chunk with no entries returns 404. Indexes refresh hourly; send each chunk’s ETag back as If-None-Match and an unchanged chunk answers 304.

Feeds list the Sets changed on one UTC day, newest first: /feeds/media-sets and /feeds/game-sets for today, or add a date (/feeds/media-sets/2026-11-14) for an earlier day. Follow meta.previous and meta.next to move between days. Today and the 13 days before it are kept; any other day is 404. A deleted or hidden Set simply drops out, so reconcile a full library through the indexes.

Each feed also has an Atom version (/feeds/media-sets.atom) for feed readers.

A creator’s profile, /users/{username} (the username in lower case; a spelling with capitals redirects there), counts their items of each kind in content. Read the items from /users/{username}/{kind}/pages/{page}, where kind is sets, boxsets, loadouts, assets or lists (sets holds show, movie, collection and game Sets):

  • pages hold up to 50 items, most recently updated first;
  • meta gives page, pageSize, totalItems, totalPages, and the next and previous paths (or null);
  • page 1 of an empty kind is an empty list, and a page past the end is 404.

Protected routes that list things, such as /account/lists and /notifications, page with a cursor instead: pass meta.nextCursor back as ?after= until it’s null. ?limit= sets the page size.