# Indexes, feeds and pages

> List everything of one type with indexes, follow new artwork with feeds, and page through a creator's work.

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

| You want                          | Use                               |
| --------------------------------- | --------------------------------- |
| Everything of one type            | [Indexes](#indexes)               |
| What's new or changed             | [Activity feeds](#activity-feeds) |
| One creator's Sets, Assets, Lists | [Creator pages](#creator-pages)   |

## Indexes

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:

```json
{
  "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`.

## Activity feeds

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.

## Creator pages

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 lists

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.
