Community artwork for shows, movies, collections and games, as JSON.
The Mediux API gives your app the artwork, Sets, creators and Lists in the
Mediux library. Reading public artwork needs no account, key or token: send a
GET and you’re done. To act for a user, such as editing their Lists, use
OAuth.
Two APIs, one host
Section titled “Two APIs, one host”Everything lives at https://api.mediux.io.
| Public API | Protected API | |
|---|---|---|
| Use it to | Read titles, Sets, creators, Lists and feeds | Read and edit one user’s Lists, follows and more |
| Authentication | None | OAuth access token the user approved |
| Methods | GET and HEAD | GET, POST, PATCH, PUT and DELETE |
| Paths | /shows/1399, /movie-set/{id}, … | /account, /notifications, /relationships |
| Runs from | Anywhere, including browsers | Your server or a native app |
Artwork itself comes from https://img.mediux.io; responses give you image IDs
and you build the URLs.
Start here
Section titled “Start here”Get started
Make your first request in a minute.
AuthenticationRegister an app and connect a user with OAuth.
Responses and errorsThe response envelope, IDs and every error code.
Indexes, feeds and pagesList everything of one type and follow new artwork.