Reference

Every operation the api answers. Each page carries the same call in seven languages, what it asks for, what it answers with, and every shape that answer contains — because reading a reference is reading a shape and the shapes inside it.

account #

the account a token acts for

• GET /me The account, claim by claim, gated exactly as `/oauth2/userinfo` gates them.

catalogue #

titles, people, characters and what is airing

• GET /calendar What comes out this week, and what just did.
• GET /characters/{id}/titles characterTitles
• GET /characters/{id}/voices Whoever has voiced this character, once each, japanese first.
• GET /characters/{id} getCharacter
• GET /people/{id} getPerson
• GET /titles/{id} getTitle
• GET /genres The vocabulary the whole catalogue is described in.
• GET /titles listTitles
• GET /people/{id}/characters The other half of a voice actor: who they have played.
• GET /people/{id}/titles personTitles
• GET /titles/random One title, at random, out of the ones that can actually be watched here.
• GET /titles/{id}/related What it *is*, beside what it is like: the sequels, the films and the recaps `similar` throws away so a franchise cannot fill its own shelf.
• GET /characters Characters by name.
• GET /people searchPeople
• GET /titles/{id}/similar What else somebody who liked this would watch.
• GET /titles/{id}/characters titleCharacters
• GET /titles/{id}/episodes The preview frames each episode has.
• GET /titles/{id}/screenshots titleScreenshots
• GET /titles/{id}/staff titleStaff

people #

other people, as far as they have agreed to be read

• GET /users/{nick} getUser
• GET /users People by name.
• GET /users/{nick}/collections userCollections
• GET /users/{nick}/followers userFollowers
• GET /users/{nick}/following userFollowing
• GET /users/{nick}/lists What somebody is watching, if their list is anybody's business.
• GET /users/{nick}/stats userStats

library #

somebody's own list and shelves

• PUT /collections/{code}/items/{shikimori_id} addCollectionItem
• GET /collections/{code}/items collectionItems
• POST /collections createCollection
• GET /collections/{code} getCollection
• GET /collections listMyCollections
• GET /lists The list, a page at a time.
• PUT /lists/{shikimori_id}/score What somebody thought of a title, through a token.
• DELETE /collections/{code}/items/{shikimori_id} removeCollectionItem
• DELETE /lists/{shikimori_id} removeListEntry
• PUT /lists/{shikimori_id} saveListEntry
• DELETE /lists/{shikimori_id}/score unrateListEntry

social #

their writing, and who they read

• PUT /following/{nickname} followUser
• GET /following listMyFollowing
• GET /posts The caller's own posts.
• DELETE /following/{nickname} unfollowUser
• POST /posts writePost