# Public API

> Anonymous read endpoints for titles, Sets, creators, Lists, feeds and YAML exports.

Every Public API route is an anonymous `GET` or `HEAD` on `https://api.mediux.io`:
no account, key or token. Paths have no version prefix, trailing slash or query
string.

- **Titles and more:** Shows, Movies, Collections, Games, People, Networks,
  Companies and Categories each have an index, a detail route and their Assets;
  Shows, Movies, Collections and Games also list their Sets. They appear once
  they have published artwork. Their text comes from TMDB or IGDB, in English
  only.
- **Sets:** the Set's type is in the path, such as `/movie-set/{id}`; show, movie
  and collection Sets also have [YAML for Kometa](https://docs-preview.mediux.io/api/guides/kometa.md). Talent,
  Brand and Category Sets, and the Sets routes of People, Networks, Companies and
  Categories, are not in the initial release.
- **Creators and Lists:** profiles with paged content, and Public Lists.
- **Feeds:** the Sets changed each day, as JSON or Atom.

See [Indexes, feeds and pages](https://docs-preview.mediux.io/api/pagination.md) to go through everything,
[Build image URLs](https://docs-preview.mediux.io/api/guides/image-urls.md) for artwork, and
[Responses and errors](https://docs-preview.mediux.io/api/errors.md) for the envelope and codes.

## All operations

### Reference

- `GET /config`: [Retrieve the API configuration](https://docs-preview.mediux.io/api/reference/reference/retrieve-config.md)

### Shows

- `GET /shows/{id}/assets`: [Retrieve a Show's Assets](https://docs-preview.mediux.io/api/reference/shows/retrieve-assets.md)
- `GET /shows/{id}/sets`: [Retrieve a Show's Sets](https://docs-preview.mediux.io/api/reference/shows/retrieve-sets.md)
- `GET /shows/{id}`: [Retrieve a Show](https://docs-preview.mediux.io/api/reference/shows/retrieve.md)
- `GET /shows`: [Retrieve the Show index](https://docs-preview.mediux.io/api/reference/shows.md)
- `GET /shows/chunks/{chunk}`: [Retrieve a Show index chunk](https://docs-preview.mediux.io/api/reference/shows/index-chunk.md)

### Seasons

- `GET /seasons/{id}/assets`: [Retrieve a Season's Assets](https://docs-preview.mediux.io/api/reference/seasons/retrieve-assets.md)
- `GET /seasons/{id}`: [Retrieve a Season](https://docs-preview.mediux.io/api/reference/seasons/retrieve.md)

### Episodes

- `GET /episodes/{id}`: [Retrieve an Episode](https://docs-preview.mediux.io/api/reference/episodes/retrieve.md)

### Movies

- `GET /movies/{id}/assets`: [Retrieve a Movie's Assets](https://docs-preview.mediux.io/api/reference/movies/retrieve-assets.md)
- `GET /movies/{id}/sets`: [Retrieve a Movie's Sets](https://docs-preview.mediux.io/api/reference/movies/retrieve-sets.md)
- `GET /movies/{id}`: [Retrieve a Movie](https://docs-preview.mediux.io/api/reference/movies/retrieve.md)
- `GET /movies`: [Retrieve the Movie index](https://docs-preview.mediux.io/api/reference/movies.md)
- `GET /movies/chunks/{chunk}`: [Retrieve a Movie index chunk](https://docs-preview.mediux.io/api/reference/movies/index-chunk.md)

### Collections

- `GET /collections/{id}/assets`: [Retrieve a Collection's Assets](https://docs-preview.mediux.io/api/reference/collections/retrieve-assets.md)
- `GET /collections/{id}/sets`: [Retrieve a Collection's Sets](https://docs-preview.mediux.io/api/reference/collections/retrieve-sets.md)
- `GET /collections/{id}`: [Retrieve a Collection](https://docs-preview.mediux.io/api/reference/collections/retrieve.md)
- `GET /collections`: [Retrieve the Collection index](https://docs-preview.mediux.io/api/reference/collections.md)
- `GET /collections/chunks/{chunk}`: [Retrieve a Collection index chunk](https://docs-preview.mediux.io/api/reference/collections/index-chunk.md)

### People

- `GET /people/{id}/assets`: [Retrieve a Person's Assets](https://docs-preview.mediux.io/api/reference/people/retrieve-assets.md)
- `GET /people/{id}`: [Retrieve a Person](https://docs-preview.mediux.io/api/reference/people/retrieve.md)
- `GET /people`: [Retrieve the Person index](https://docs-preview.mediux.io/api/reference/people.md)
- `GET /people/chunks/{chunk}`: [Retrieve a Person index chunk](https://docs-preview.mediux.io/api/reference/people/index-chunk.md)

### Networks

- `GET /networks/{id}/assets`: [Retrieve a Network's Assets](https://docs-preview.mediux.io/api/reference/networks/retrieve-assets.md)
- `GET /networks/{id}`: [Retrieve a Network](https://docs-preview.mediux.io/api/reference/networks/retrieve.md)
- `GET /networks`: [Retrieve the Network index](https://docs-preview.mediux.io/api/reference/networks.md)
- `GET /networks/chunks/{chunk}`: [Retrieve a Network index chunk](https://docs-preview.mediux.io/api/reference/networks/index-chunk.md)

### Companies

- `GET /companies/{id}/assets`: [Retrieve a Company's Assets](https://docs-preview.mediux.io/api/reference/companies/retrieve-assets.md)
- `GET /companies/{id}`: [Retrieve a Company](https://docs-preview.mediux.io/api/reference/companies/retrieve.md)
- `GET /companies`: [Retrieve the Company index](https://docs-preview.mediux.io/api/reference/companies.md)
- `GET /companies/chunks/{chunk}`: [Retrieve a Company index chunk](https://docs-preview.mediux.io/api/reference/companies/index-chunk.md)

### Categories

- `GET /categories/{id}/assets`: [Retrieve a Category's Assets](https://docs-preview.mediux.io/api/reference/categories/retrieve-assets.md)
- `GET /categories/{id}`: [Retrieve a Category](https://docs-preview.mediux.io/api/reference/categories/retrieve.md)
- `GET /categories`: [Retrieve the Category index](https://docs-preview.mediux.io/api/reference/categories.md)
- `GET /categories/chunks/{chunk}`: [Retrieve a Category index chunk](https://docs-preview.mediux.io/api/reference/categories/index-chunk.md)

### Games

- `GET /games/{id}/assets`: [Retrieve a Game's Assets](https://docs-preview.mediux.io/api/reference/games/retrieve-assets.md)
- `GET /games/{id}/sets`: [Retrieve a Game's Sets](https://docs-preview.mediux.io/api/reference/games/retrieve-sets.md)
- `GET /games/{id}`: [Retrieve a Game](https://docs-preview.mediux.io/api/reference/games/retrieve.md)
- `GET /games`: [Retrieve the Game index](https://docs-preview.mediux.io/api/reference/games.md)
- `GET /games/chunks/{chunk}`: [Retrieve a Game index chunk](https://docs-preview.mediux.io/api/reference/games/index-chunk.md)

### Sets

- `GET /show-set/{id}`: [Retrieve a Show Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set.md)
- `GET /movie-set/{id}`: [Retrieve a Movie Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set.md)
- `GET /collection-set/{id}`: [Retrieve a Collection Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set.md)
- `GET /game-set/{id}`: [Retrieve a Game Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-game-set.md)
- `GET /show-set/{id}.yaml`: [Retrieve Show Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set-yaml.md)
- `GET /show-set/{id}.original.yaml`: [Retrieve Show Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set-original-yaml.md)
- `GET /movie-set/{id}.yaml`: [Retrieve Movie Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set-yaml.md)
- `GET /movie-set/{id}.original.yaml`: [Retrieve Movie Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set-original-yaml.md)
- `GET /collection-set/{id}.yaml`: [Retrieve Collection Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set-yaml.md)
- `GET /collection-set/{id}.original.yaml`: [Retrieve Collection Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set-original-yaml.md)

### Boxsets and Loadouts

- `GET /boxsets/{id}`: [Retrieve a Boxset](https://docs-preview.mediux.io/api/reference/boxsets-and-loadouts/retrieve-boxset.md)
- `GET /loadouts/{id}`: [Retrieve a Loadout](https://docs-preview.mediux.io/api/reference/boxsets-and-loadouts/retrieve-loadout.md)

### Assets

- `GET /assets/{id}`: [Retrieve an Asset](https://docs-preview.mediux.io/api/reference/assets/retrieve.md)

### Profiles

- `GET /users`: [Retrieve the creators directory](https://docs-preview.mediux.io/api/reference/profiles.md)
- `GET /users/chunks/{prefix}`: [Retrieve a creators directory bucket](https://docs-preview.mediux.io/api/reference/profiles/index-chunk.md)
- `GET /users/{username}`: [Retrieve a User Profile](https://docs-preview.mediux.io/api/reference/profiles/retrieve.md)
- `GET /users/{username}/sets/pages/{page}`: [List a creator's Sets](https://docs-preview.mediux.io/api/reference/profiles/list-sets.md)
- `GET /users/{username}/boxsets/pages/{page}`: [List a creator's Boxsets](https://docs-preview.mediux.io/api/reference/profiles/list-boxsets.md)
- `GET /users/{username}/loadouts/pages/{page}`: [List a creator's Loadouts](https://docs-preview.mediux.io/api/reference/profiles/list-loadouts.md)
- `GET /users/{username}/assets/pages/{page}`: [List a creator's Assets](https://docs-preview.mediux.io/api/reference/profiles/list-assets.md)
- `GET /users/{username}/lists/pages/{page}`: [List a creator's Public Lists](https://docs-preview.mediux.io/api/reference/profiles/list-lists.md)

### Lists

- `GET /lists`: [Retrieve the List discovery index](https://docs-preview.mediux.io/api/reference/lists.md)
- `GET /lists/chunks/{prefix}`: [Retrieve a List discovery bucket](https://docs-preview.mediux.io/api/reference/lists/index-chunk.md)
- `GET /lists/{id}`: [Retrieve a List](https://docs-preview.mediux.io/api/reference/lists/retrieve.md)
- `GET /lists/{id}/titles/{family}/{entity}`: [Retrieve a List title](https://docs-preview.mediux.io/api/reference/lists/retrieve-title.md)

### Activity feeds

- `GET /feeds/media-sets`: [List today's Media Sets](https://docs-preview.mediux.io/api/reference/feeds/list-media-sets.md)
- `GET /feeds/media-sets/{date}`: [List Media Sets changed on a day](https://docs-preview.mediux.io/api/reference/feeds/list-media-sets-day.md)
- `GET /feeds/media-sets.atom`: [Retrieve the Media Set feed as Atom](https://docs-preview.mediux.io/api/reference/feeds/retrieve-media-sets-atom.md)
- `GET /feeds/game-sets`: [List today's Game Sets](https://docs-preview.mediux.io/api/reference/feeds/list-game-sets.md)
- `GET /feeds/game-sets/{date}`: [List Game Sets changed on a day](https://docs-preview.mediux.io/api/reference/feeds/list-game-sets-day.md)
- `GET /feeds/game-sets.atom`: [Retrieve the Game Set feed as Atom](https://docs-preview.mediux.io/api/reference/feeds/retrieve-game-sets-atom.md)
