{ "openapi": "3.1.0", "info": { "title": "jikan-edge", "version": "v1", "description": "Public MyAnimeList data over HTTP, read from the public pages on demand and cached in D1. A parameter a route does not declare is a 400: UNKNOWN_PARAMETER for a name that does not exist, UNSUPPORTED_PARAMETER for one Jikan v4 has and this API does not honour (see x-unsupported-parameters)." }, "servers": [ { "url": "https://jikan.lucashdo.com" } ], "security": [], "x-unsupported-parameters": { "limit": "Not supported outside the user list routes: this API serves one MyAnimeList page per request, so a limit would either slice that page (a different result from Jikan's) or require crawling several pages upstream.", "sfw": "Not supported: MyAnimeList has no server-side safe-for-work switch, and approximating one by excluding a few genre ids would be a guess wearing the name of a guarantee. Use \"rating\", which maps to MyAnimeList's own classification dropdown — anime search only, since the manga search page carries no equivalent field.", "max_score": "Not supported: MyAnimeList's search form offers a single minimum-score dropdown, which is what \"score\" and \"min_score\" map to. An upper bound could only be applied after the fact, which would make this route's page size and \"hasNextPage\" wrong.", "producers": "Not supported: MyAnimeList's search page has a producer field, but it no longer filters — searching \"gundam\" with and without it returns the same results. Producer catalogues live at /v1/producers/:id.", "genres_exclude": "Not supported: MyAnimeList's exclude flag no longer inverts a genre filter — with it set, 16 of 18 results are the same entries the un-inverted filter returns. Excluding a genre reliably would mean filtering after the fetch, which would break the page size this route reports.", "unapproved": "Not supported: this API reads the public pages, which list approved entries only.", "preliminary": "Only the review routes take it: /v1/reviews/{anime,manga} and /v1/{anime,manga}/:id/reviews.", "spoilers": "Only the review routes take it: /v1/reviews/{anime,manga} and /v1/{anime,manga}/:id/reviews.", "kids": "Not supported yet: season cards carry MyAnimeList's own kids marker, but this API does not filter on it.", "continuing": "Only the season routes take it: /v1/seasons/now and /v1/seasons/:year/:season." }, "components": { "schemas": { "Pagination": { "type": "object", "properties": { "page": { "type": "integer" }, "limit": { "type": "integer" }, "count": { "type": "integer" }, "total": { "type": [ "integer", "null" ], "description": "Only the user lists know a total; null elsewhere." }, "hasNextPage": { "type": "boolean" } }, "required": [ "page", "limit", "count", "total", "hasNextPage" ] }, "Meta": { "type": "object", "properties": { "cached": { "type": "boolean" }, "stale": { "type": "boolean", "description": "The payload outlived its TTL and is being served while it refreshes." }, "refreshFailed": { "type": "boolean" }, "fetchedAt": { "type": "string", "description": "When the payload was read from MyAnimeList." }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "cached", "stale", "refreshFailed", "fetchedAt" ] }, "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ] } }, "required": [ "error" ] } }, "parameters": {} }, "paths": { "/health": { "get": { "operationId": "getHealth", "summary": "GET /health", "tags": [ "health" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ok" ] }, "service": { "type": "string", "enum": [ "jikan-edge" ] }, "checks": { "type": "object", "properties": { "database": { "type": "string", "enum": [ "ok", "not_configured", "not_migrated", "unavailable" ] } }, "required": [ "database" ] } }, "required": [ "status", "service", "checks" ] }, "meta": { "type": "object", "properties": { "requestId": { "type": "string" } }, "required": [ "requestId" ] } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}": { "get": { "operationId": "getUsersByUsername", "summary": "GET /v1/users/{username}", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "maxLength": 64 }, "canonicalUsername": { "type": "string", "minLength": 1, "maxLength": 64 }, "profileUrl": { "type": "string", "format": "uri" }, "avatarUrl": { "type": [ "string", "null" ], "format": "uri" }, "about": { "type": [ "string", "null" ] }, "gender": { "type": [ "string", "null" ] }, "location": { "type": [ "string", "null" ] }, "birthday": { "type": [ "string", "null" ] }, "joinedAt": { "type": [ "string", "null" ] }, "lastOnlineAt": { "type": [ "string", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "username", "canonicalUsername", "profileUrl", "avatarUrl", "about", "gender", "location", "birthday", "joinedAt", "lastOnlineAt", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/statistics": { "get": { "operationId": "getUsersByUsernameStatistics", "summary": "GET /v1/users/{username}/statistics", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "anime": { "type": "object", "properties": { "watching": { "type": "number" }, "completed": { "type": "number" }, "onHold": { "type": "number" }, "dropped": { "type": "number" }, "planToWatch": { "type": "number" }, "totalEntries": { "type": "number" }, "rewatched": { "type": [ "number", "null" ] }, "episodesWatched": { "type": [ "number", "null" ] }, "daysWatched": { "type": [ "number", "null" ] }, "meanScore": { "type": [ "number", "null" ] } }, "required": [ "watching", "completed", "onHold", "dropped", "planToWatch", "totalEntries", "rewatched", "episodesWatched", "daysWatched", "meanScore" ] }, "manga": { "type": "object", "properties": { "reading": { "type": "number" }, "completed": { "type": "number" }, "onHold": { "type": "number" }, "dropped": { "type": "number" }, "planToRead": { "type": "number" }, "totalEntries": { "type": "number" }, "reread": { "type": [ "number", "null" ] }, "chaptersRead": { "type": [ "number", "null" ] }, "volumesRead": { "type": [ "number", "null" ] }, "daysRead": { "type": [ "number", "null" ] }, "meanScore": { "type": [ "number", "null" ] } }, "required": [ "reading", "completed", "onHold", "dropped", "planToRead", "totalEntries", "reread", "chaptersRead", "volumesRead", "daysRead", "meanScore" ] } }, "required": [ "anime", "manga" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/favorites": { "get": { "operationId": "getUsersByUsernameFavorites", "summary": "GET /v1/users/{username}/favorites", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "anime": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "characters": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "people": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } } }, "required": [ "anime", "manga", "characters", "people" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/userupdates": { "get": { "operationId": "getUsersByUsernameUserupdates", "summary": "GET /v1/users/{username}/userupdates", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "anime": { "type": "array", "items": { "type": "object", "properties": { "entry": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl" ] }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string" }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string" } }, "required": [ "entry", "score", "status", "progress", "total", "date" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "entry": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl" ] }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string" }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string" } }, "required": [ "entry", "score", "status", "progress", "total", "date" ] } } }, "required": [ "anime", "manga" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/full": { "get": { "operationId": "getUsersByUsernameFull", "summary": "GET /v1/users/{username}/full", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "maxLength": 64 }, "canonicalUsername": { "type": "string", "minLength": 1, "maxLength": 64 }, "profileUrl": { "type": "string", "format": "uri" }, "avatarUrl": { "type": [ "string", "null" ], "format": "uri" }, "about": { "type": [ "string", "null" ] }, "gender": { "type": [ "string", "null" ] }, "location": { "type": [ "string", "null" ] }, "birthday": { "type": [ "string", "null" ] }, "joinedAt": { "type": [ "string", "null" ] }, "lastOnlineAt": { "type": [ "string", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "username", "canonicalUsername", "profileUrl", "avatarUrl", "about", "gender", "location", "birthday", "joinedAt", "lastOnlineAt", "fetchedAt" ] }, "statistics": { "type": "object", "properties": { "anime": { "type": "object", "properties": { "watching": { "type": "number" }, "completed": { "type": "number" }, "onHold": { "type": "number" }, "dropped": { "type": "number" }, "planToWatch": { "type": "number" }, "totalEntries": { "type": "number" }, "rewatched": { "type": [ "number", "null" ] }, "episodesWatched": { "type": [ "number", "null" ] }, "daysWatched": { "type": [ "number", "null" ] }, "meanScore": { "type": [ "number", "null" ] } }, "required": [ "watching", "completed", "onHold", "dropped", "planToWatch", "totalEntries", "rewatched", "episodesWatched", "daysWatched", "meanScore" ] }, "manga": { "type": "object", "properties": { "reading": { "type": "number" }, "completed": { "type": "number" }, "onHold": { "type": "number" }, "dropped": { "type": "number" }, "planToRead": { "type": "number" }, "totalEntries": { "type": "number" }, "reread": { "type": [ "number", "null" ] }, "chaptersRead": { "type": [ "number", "null" ] }, "volumesRead": { "type": [ "number", "null" ] }, "daysRead": { "type": [ "number", "null" ] }, "meanScore": { "type": [ "number", "null" ] } }, "required": [ "reading", "completed", "onHold", "dropped", "planToRead", "totalEntries", "reread", "chaptersRead", "volumesRead", "daysRead", "meanScore" ] } }, "required": [ "anime", "manga" ] }, "favorites": { "type": "object", "properties": { "anime": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "characters": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } }, "people": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "startYear": { "type": [ "number", "null" ] }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "imageUrl" ] } } }, "required": [ "anime", "manga", "characters", "people" ] }, "updates": { "type": "object", "properties": { "anime": { "type": "array", "items": { "type": "object", "properties": { "entry": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl" ] }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string" }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string" } }, "required": [ "entry", "score", "status", "progress", "total", "date" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "entry": { "type": "object", "properties": { "malId": { "type": "integer" }, "title": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl" ] }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string" }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string" } }, "required": [ "entry", "score", "status", "progress", "total", "date" ] } } }, "required": [ "anime", "manga" ] } }, "required": [ "profile", "statistics", "favorites", "updates" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/about": { "get": { "operationId": "getUsersByUsernameAbout", "summary": "GET /v1/users/{username}/about", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "about": { "type": [ "string", "null" ] } }, "required": [ "about" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/friends": { "get": { "operationId": "getUsersByUsernameFriends", "summary": "GET /v1/users/{username}/friends", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "lastOnline": { "type": [ "string", "null" ] }, "friendsSince": { "type": [ "string", "null" ] } }, "required": [ "username", "imageUrl", "lastOnline", "friendsSince" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/clubs": { "get": { "operationId": "getUsersByUsernameClubs", "summary": "GET /v1/users/{username}/clubs", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/reviews": { "get": { "operationId": "getUsersByUsernameReviews", "summary": "GET /v1/users/{username}/reviews", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "username": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "tag": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "reviewText": { "type": [ "string", "null" ] }, "reviewId": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "isPreliminary": { "type": "boolean" }, "isSpoiler": { "type": "boolean" }, "episodesWatched": { "type": [ "integer", "null" ], "minimum": 0 }, "chaptersRead": { "type": [ "integer", "null" ], "minimum": 0 }, "reactions": { "type": [ "object", "null" ], "properties": { "overall": { "type": "integer", "minimum": 0 }, "nice": { "type": "integer", "minimum": 0 }, "loveIt": { "type": "integer", "minimum": 0 }, "funny": { "type": "integer", "minimum": 0 }, "confusing": { "type": "integer", "minimum": 0 }, "informative": { "type": "integer", "minimum": 0 }, "wellWritten": { "type": "integer", "minimum": 0 }, "creative": { "type": "integer", "minimum": 0 } }, "required": [ "overall", "nice", "loveIt", "funny", "confusing", "informative", "wellWritten", "creative" ] } }, "required": [ "malId", "title", "imageUrl", "username", "date", "tag", "score", "reviewText", "reviewId", "url", "isPreliminary", "isSpoiler", "episodesWatched", "chaptersRead", "reactions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/recommendations": { "get": { "operationId": "getUsersByUsernameRecommendations", "summary": "GET /v1/users/{username}/recommendations", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "recommendedMalId": { "type": "integer", "exclusiveMinimum": 0 }, "recommendedTitle": { "type": "string", "minLength": 1 }, "recommendedImageUrl": { "type": [ "string", "null" ], "format": "uri" }, "content": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "recommendedMalId", "recommendedTitle", "recommendedImageUrl", "content", "username" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/animelist": { "get": { "operationId": "getUsersByUsernameAnimelist", "summary": "GET /v1/users/{username}/animelist", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "mediaType": { "type": "string", "enum": [ "anime", "manga" ] }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "status": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "startedAt": { "type": [ "string", "null" ] }, "finishedAt": { "type": [ "string", "null" ] }, "updatedAt": { "type": [ "string", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "username", "mediaType", "malId", "title", "imageUrl", "status", "score", "progress", "total", "startedAt", "finishedAt", "updatedAt", "fetchedAt" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{username}/mangalist": { "get": { "operationId": "getUsersByUsernameMangalist", "summary": "GET /v1/users/{username}/mangalist", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "username", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "mediaType": { "type": "string", "enum": [ "anime", "manga" ] }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "status": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "startedAt": { "type": [ "string", "null" ] }, "finishedAt": { "type": [ "string", "null" ] }, "updatedAt": { "type": [ "string", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "username", "mediaType", "malId", "title", "imageUrl", "status", "score", "progress", "total", "startedAt", "finishedAt", "updatedAt", "fetchedAt" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users": { "get": { "operationId": "getUsers", "summary": "GET /v1/users", "tags": [ "users" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "maxLength": 64 }, "url": { "type": "string", "format": "uri" }, "avatarUrl": { "type": [ "string", "null" ], "format": "uri" }, "joinedAt": { "type": [ "string", "null" ] } }, "required": [ "username", "url", "avatarUrl", "joinedAt" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime": { "get": { "operationId": "getAnime", "summary": "GET /v1/anime", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "type", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "rating", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "score", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "min_score", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "genres", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "order_by", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "sort", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "letter", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "start_date", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "end_date", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": "string", "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "synopsis": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "endDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "rating": { "type": [ "string", "null" ] } }, "required": [ "malId", "url", "title", "imageUrl", "synopsis", "type", "score", "startDate", "endDate", "members", "episodes", "rating" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}": { "get": { "operationId": "getAnimeById", "summary": "GET /v1/anime/{id}", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "trailer": { "type": "object", "properties": { "youtubeId": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ], "format": "uri" }, "embedUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "youtubeId", "url", "embedUrl" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "airing": { "type": "boolean" }, "aired": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "season": { "type": [ "string", "null" ] }, "year": { "type": [ "number", "null" ] }, "broadcast": { "type": "object", "properties": { "day": { "type": [ "string", "null" ] }, "time": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "day", "time", "timezone", "string" ] }, "studios": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "producers": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "licensors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "duration": { "type": [ "string", "null" ] }, "rating": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "streaming": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "available": { "type": "boolean" } }, "required": [ "name", "url", "available" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "trailer", "synopsis", "background", "type", "episodes", "status", "airing", "aired", "season", "year", "broadcast", "studios", "producers", "licensors", "genres", "themes", "demographics", "duration", "rating", "score", "scoredBy", "rank", "popularity", "members", "favorites", "source", "relations", "externalLinks", "streaming", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/full": { "get": { "operationId": "getAnimeByIdFull", "summary": "GET /v1/anime/{id}/full", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "trailer": { "type": "object", "properties": { "youtubeId": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ], "format": "uri" }, "embedUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "youtubeId", "url", "embedUrl" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "airing": { "type": "boolean" }, "aired": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "season": { "type": [ "string", "null" ] }, "year": { "type": [ "number", "null" ] }, "broadcast": { "type": "object", "properties": { "day": { "type": [ "string", "null" ] }, "time": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "day", "time", "timezone", "string" ] }, "studios": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "producers": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "licensors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "duration": { "type": [ "string", "null" ] }, "rating": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "streaming": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "available": { "type": "boolean" } }, "required": [ "name", "url", "available" ] } }, "fetchedAt": { "type": "string", "format": "date-time" }, "themeSongs": { "type": "object", "properties": { "openings": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "artist": { "type": [ "string", "null" ] }, "episodes": { "type": [ "string", "null" ] } }, "required": [ "title", "artist", "episodes" ] } }, "endings": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "artist": { "type": [ "string", "null" ] }, "episodes": { "type": [ "string", "null" ] } }, "required": [ "title", "artist", "episodes" ] } } }, "required": [ "openings", "endings" ] } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "trailer", "synopsis", "background", "type", "episodes", "status", "airing", "aired", "season", "year", "broadcast", "studios", "producers", "licensors", "genres", "themes", "demographics", "duration", "rating", "score", "scoredBy", "rank", "popularity", "members", "favorites", "source", "relations", "externalLinks", "streaming", "fetchedAt", "themeSongs" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/relations": { "get": { "operationId": "getAnimeByIdRelations", "summary": "GET /v1/anime/{id}/relations", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/external": { "get": { "operationId": "getAnimeByIdExternal", "summary": "GET /v1/anime/{id}/external", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/streaming": { "get": { "operationId": "getAnimeByIdStreaming", "summary": "GET /v1/anime/{id}/streaming", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "available": { "type": "boolean" } }, "required": [ "name", "url", "available" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/characters": { "get": { "operationId": "getAnimeByIdCharacters", "summary": "GET /v1/anime/{id}/characters", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "voiceActors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "language": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "malId", "name", "language", "imageUrl" ] } } }, "required": [ "malId", "name", "imageUrl", "role", "favorites", "voiceActors" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/staff": { "get": { "operationId": "getAnimeByIdStaff", "summary": "GET /v1/anime/{id}/staff", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "malId", "name", "imageUrl", "role" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/statistics": { "get": { "operationId": "getAnimeByIdStatistics", "summary": "GET /v1/anime/{id}/statistics", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "type": "object", "properties": { "inProgress": { "type": [ "number", "null" ] }, "completed": { "type": [ "number", "null" ] }, "onHold": { "type": [ "number", "null" ] }, "dropped": { "type": [ "number", "null" ] }, "planned": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] } }, "required": [ "inProgress", "completed", "onHold", "dropped", "planned", "total" ] }, "scores": { "type": "array", "items": { "type": "object", "properties": { "score": { "type": "integer", "minimum": 1, "maximum": 10 }, "votes": { "type": "integer", "minimum": 0 }, "percentage": { "type": "number" } }, "required": [ "score", "votes", "percentage" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "status", "scores", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/pictures": { "get": { "operationId": "getAnimeByIdPictures", "summary": "GET /v1/anime/{id}/pictures", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "imageUrl": { "type": "string", "format": "uri" }, "thumbnailUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "imageUrl", "thumbnailUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/news": { "get": { "operationId": "getAnimeByIdNews", "summary": "GET /v1/anime/{id}/news", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "excerpt": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "author": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "url", "imageUrl", "excerpt", "date", "author" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/forum": { "get": { "operationId": "getAnimeByIdForum", "summary": "GET /v1/anime/{id}/forum", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "topicId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "startedBy": { "type": [ "string", "null" ] }, "startedDate": { "type": [ "string", "null" ] }, "replies": { "type": [ "number", "null" ] }, "lastPostBy": { "type": [ "string", "null" ] } }, "required": [ "topicId", "title", "startedBy", "startedDate", "replies", "lastPostBy" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/episodes": { "get": { "operationId": "getAnimeByIdEpisodes", "summary": "GET /v1/anime/{id}/episodes", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "number": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "titleJapanese": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" }, "aired": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "forumReplies": { "type": [ "number", "null" ] }, "filler": { "type": "boolean" }, "recap": { "type": "boolean" } }, "required": [ "number", "title", "titleJapanese", "url", "aired", "score", "forumReplies", "filler", "recap" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/recommendations": { "get": { "operationId": "getAnimeByIdRecommendations", "summary": "GET /v1/anime/{id}/recommendations", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "votes": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "malId", "title", "imageUrl", "votes" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/reviews": { "get": { "operationId": "getAnimeByIdReviews", "summary": "GET /v1/anime/{id}/reviews", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "preliminary", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "spoilers", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "date": { "type": [ "string", "null" ] }, "tag": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "reviewText": { "type": [ "string", "null" ] }, "reviewId": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "isPreliminary": { "type": "boolean" }, "isSpoiler": { "type": "boolean" }, "episodesWatched": { "type": [ "integer", "null" ], "minimum": 0 }, "chaptersRead": { "type": [ "integer", "null" ], "minimum": 0 }, "reactions": { "type": [ "object", "null" ], "properties": { "overall": { "type": "integer", "minimum": 0 }, "nice": { "type": "integer", "minimum": 0 }, "loveIt": { "type": "integer", "minimum": 0 }, "funny": { "type": "integer", "minimum": 0 }, "confusing": { "type": "integer", "minimum": 0 }, "informative": { "type": "integer", "minimum": 0 }, "wellWritten": { "type": "integer", "minimum": 0 }, "creative": { "type": "integer", "minimum": 0 } }, "required": [ "overall", "nice", "loveIt", "funny", "confusing", "informative", "wellWritten", "creative" ] } }, "required": [ "username", "imageUrl", "date", "tag", "score", "reviewText", "reviewId", "url", "isPreliminary", "isSpoiler", "episodesWatched", "chaptersRead", "reactions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/videos": { "get": { "operationId": "getAnimeByIdVideos", "summary": "GET /v1/anime/{id}/videos", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "promos": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "videoUrl": { "type": [ "string", "null" ], "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "title", "videoUrl", "imageUrl" ] } }, "musicVideos": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "videoUrl": { "type": [ "string", "null" ], "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "title", "videoUrl", "imageUrl" ] } }, "episodes": { "type": "array", "items": { "type": "object", "properties": { "episode": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "episode", "title", "url", "imageUrl" ] } } }, "required": [ "promos", "musicVideos", "episodes" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/videos/episodes": { "get": { "operationId": "getAnimeByIdVideosEpisodes", "summary": "GET /v1/anime/{id}/videos/episodes", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "episode": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "episode", "title", "url", "imageUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/episodes/{episode}": { "get": { "operationId": "getAnimeByIdEpisodesByEpisode", "summary": "GET /v1/anime/{id}/episodes/{episode}", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "episode", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "episode": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": [ "string", "null" ] }, "titleAlternative": { "type": [ "string", "null" ] }, "duration": { "type": [ "string", "null" ] }, "aired": { "type": [ "string", "null" ] }, "synopsis": { "type": [ "string", "null" ] } }, "required": [ "malId", "episode", "title", "titleAlternative", "duration", "aired", "synopsis" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/userupdates": { "get": { "operationId": "getAnimeByIdUserupdates", "summary": "GET /v1/anime/{id}/userupdates", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string", "minLength": 1 }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string", "minLength": 1 } }, "required": [ "username", "imageUrl", "score", "status", "progress", "total", "date" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/themes": { "get": { "operationId": "getAnimeByIdThemes", "summary": "GET /v1/anime/{id}/themes", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "openings": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "artist": { "type": [ "string", "null" ] }, "episodes": { "type": [ "string", "null" ] } }, "required": [ "title", "artist", "episodes" ] } }, "endings": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "artist": { "type": [ "string", "null" ] }, "episodes": { "type": [ "string", "null" ] } }, "required": [ "title", "artist", "episodes" ] } } }, "required": [ "openings", "endings" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/anime/{id}/moreinfo": { "get": { "operationId": "getAnimeByIdMoreinfo", "summary": "GET /v1/anime/{id}/moreinfo", "tags": [ "anime" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "text": { "type": [ "string", "null" ] } }, "required": [ "text" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/genres/anime": { "get": { "operationId": "getGenresAnime", "summary": "GET /v1/genres/anime", "tags": [ "genres" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "filter", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "count": { "type": "integer", "minimum": 0 }, "type": { "type": "string", "enum": [ "genres", "explicit_genres", "themes", "demographics" ] } }, "required": [ "malId", "name", "url", "count", "type" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/top/anime": { "get": { "operationId": "getTopAnime", "summary": "GET /v1/top/anime", "tags": [ "top" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "filter", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/seasons": { "get": { "operationId": "getSeasons", "summary": "GET /v1/seasons", "tags": [ "seasons" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "year": { "type": "integer", "minimum": 1900, "maximum": 2100 }, "seasons": { "type": "array", "items": { "type": "string" }, "minItems": 1 } }, "required": [ "year", "seasons" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/seasons/now": { "get": { "operationId": "getSeasonsNow", "summary": "GET /v1/seasons/now", "tags": [ "seasons" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "continuing", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] }, "continuing": { "type": "boolean" } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members", "continuing" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/seasons/upcoming": { "get": { "operationId": "getSeasonsUpcoming", "summary": "GET /v1/seasons/upcoming", "tags": [ "seasons" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] }, "continuing": { "type": "boolean" } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members", "continuing" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/seasons/{year}/{season}": { "get": { "operationId": "getSeasonsByYearBySeason", "summary": "GET /v1/seasons/{year}/{season}", "tags": [ "seasons" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "year", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "season", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "continuing", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] }, "continuing": { "type": "boolean" } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members", "continuing" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/schedules": { "get": { "operationId": "getSchedules", "summary": "GET /v1/schedules", "tags": [ "schedules" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "filter", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "monday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "tuesday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "wednesday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "thursday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "friday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "saturday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "sunday": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "other": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } }, "unknown": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } } }, "required": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", "other", "unknown" ] }, { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "episodes", "startDate", "members" ] } } ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga": { "get": { "operationId": "getManga", "summary": "GET /v1/manga", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "type", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "score", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "min_score", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "genres", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "magazines", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "order_by", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "sort", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "letter", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "start_date", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "end_date", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": "string", "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "synopsis": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "endDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] }, "volumes": { "type": [ "number", "null" ] }, "chapters": { "type": [ "number", "null" ] } }, "required": [ "malId", "url", "title", "imageUrl", "synopsis", "type", "score", "startDate", "endDate", "members", "volumes", "chapters" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}": { "get": { "operationId": "getMangaById", "summary": "GET /v1/manga/{id}", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "volumes": { "type": [ "number", "null" ] }, "chapters": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "publishing": { "type": "boolean" }, "published": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "authors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "serializations": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "synopsis", "background", "type", "volumes", "chapters", "status", "publishing", "published", "authors", "serializations", "genres", "themes", "demographics", "score", "scoredBy", "rank", "popularity", "members", "favorites", "relations", "externalLinks", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/full": { "get": { "operationId": "getMangaByIdFull", "summary": "GET /v1/manga/{id}/full", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "volumes": { "type": [ "number", "null" ] }, "chapters": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "publishing": { "type": "boolean" }, "published": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "authors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "serializations": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "synopsis", "background", "type", "volumes", "chapters", "status", "publishing", "published", "authors", "serializations", "genres", "themes", "demographics", "score", "scoredBy", "rank", "popularity", "members", "favorites", "relations", "externalLinks", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/relations": { "get": { "operationId": "getMangaByIdRelations", "summary": "GET /v1/manga/{id}/relations", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/external": { "get": { "operationId": "getMangaByIdExternal", "summary": "GET /v1/manga/{id}/external", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/characters": { "get": { "operationId": "getMangaByIdCharacters", "summary": "GET /v1/manga/{id}/characters", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "voiceActors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "language": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "malId", "name", "language", "imageUrl" ] } } }, "required": [ "malId", "name", "imageUrl", "role", "favorites", "voiceActors" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/statistics": { "get": { "operationId": "getMangaByIdStatistics", "summary": "GET /v1/manga/{id}/statistics", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "type": "object", "properties": { "inProgress": { "type": [ "number", "null" ] }, "completed": { "type": [ "number", "null" ] }, "onHold": { "type": [ "number", "null" ] }, "dropped": { "type": [ "number", "null" ] }, "planned": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] } }, "required": [ "inProgress", "completed", "onHold", "dropped", "planned", "total" ] }, "scores": { "type": "array", "items": { "type": "object", "properties": { "score": { "type": "integer", "minimum": 1, "maximum": 10 }, "votes": { "type": "integer", "minimum": 0 }, "percentage": { "type": "number" } }, "required": [ "score", "votes", "percentage" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "status", "scores", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/pictures": { "get": { "operationId": "getMangaByIdPictures", "summary": "GET /v1/manga/{id}/pictures", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "imageUrl": { "type": "string", "format": "uri" }, "thumbnailUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "imageUrl", "thumbnailUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/news": { "get": { "operationId": "getMangaByIdNews", "summary": "GET /v1/manga/{id}/news", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "excerpt": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "author": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "url", "imageUrl", "excerpt", "date", "author" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/forum": { "get": { "operationId": "getMangaByIdForum", "summary": "GET /v1/manga/{id}/forum", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "topicId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "startedBy": { "type": [ "string", "null" ] }, "startedDate": { "type": [ "string", "null" ] }, "replies": { "type": [ "number", "null" ] }, "lastPostBy": { "type": [ "string", "null" ] } }, "required": [ "topicId", "title", "startedBy", "startedDate", "replies", "lastPostBy" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/recommendations": { "get": { "operationId": "getMangaByIdRecommendations", "summary": "GET /v1/manga/{id}/recommendations", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "votes": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "malId", "title", "imageUrl", "votes" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/reviews": { "get": { "operationId": "getMangaByIdReviews", "summary": "GET /v1/manga/{id}/reviews", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "preliminary", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "spoilers", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "date": { "type": [ "string", "null" ] }, "tag": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "reviewText": { "type": [ "string", "null" ] }, "reviewId": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "isPreliminary": { "type": "boolean" }, "isSpoiler": { "type": "boolean" }, "episodesWatched": { "type": [ "integer", "null" ], "minimum": 0 }, "chaptersRead": { "type": [ "integer", "null" ], "minimum": 0 }, "reactions": { "type": [ "object", "null" ], "properties": { "overall": { "type": "integer", "minimum": 0 }, "nice": { "type": "integer", "minimum": 0 }, "loveIt": { "type": "integer", "minimum": 0 }, "funny": { "type": "integer", "minimum": 0 }, "confusing": { "type": "integer", "minimum": 0 }, "informative": { "type": "integer", "minimum": 0 }, "wellWritten": { "type": "integer", "minimum": 0 }, "creative": { "type": "integer", "minimum": 0 } }, "required": [ "overall", "nice", "loveIt", "funny", "confusing", "informative", "wellWritten", "creative" ] } }, "required": [ "username", "imageUrl", "date", "tag", "score", "reviewText", "reviewId", "url", "isPreliminary", "isSpoiler", "episodesWatched", "chaptersRead", "reactions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/userupdates": { "get": { "operationId": "getMangaByIdUserupdates", "summary": "GET /v1/manga/{id}/userupdates", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "status": { "type": "string", "minLength": 1 }, "progress": { "type": [ "number", "null" ] }, "total": { "type": [ "number", "null" ] }, "date": { "type": "string", "minLength": 1 } }, "required": [ "username", "imageUrl", "score", "status", "progress", "total", "date" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/manga/{id}/moreinfo": { "get": { "operationId": "getMangaByIdMoreinfo", "summary": "GET /v1/manga/{id}/moreinfo", "tags": [ "manga" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "text": { "type": [ "string", "null" ] } }, "required": [ "text" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/genres/manga": { "get": { "operationId": "getGenresManga", "summary": "GET /v1/genres/manga", "tags": [ "genres" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "filter", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "count": { "type": "integer", "minimum": 0 }, "type": { "type": "string", "enum": [ "genres", "explicit_genres", "themes", "demographics" ] } }, "required": [ "malId", "name", "url", "count", "type" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/top/manga": { "get": { "operationId": "getTopManga", "summary": "GET /v1/top/manga", "tags": [ "top" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "filter", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "score": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "volumes": { "type": [ "number", "null" ] }, "startDate": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "score", "type", "volumes", "startDate", "members" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/magazines": { "get": { "operationId": "getMagazines", "summary": "GET /v1/magazines", "tags": [ "magazines" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "count": { "type": "integer", "minimum": 0 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "count", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/top/characters": { "get": { "operationId": "getTopCharacters", "summary": "GET /v1/top/characters", "tags": [ "top" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "nameKanji": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "animeography": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 } }, "required": [ "malId", "title" ] } }, "mangaography": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 } }, "required": [ "malId", "title" ] } }, "favorites": { "type": [ "number", "null" ] } }, "required": [ "malId", "name", "nameKanji", "imageUrl", "animeography", "mangaography", "favorites" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters": { "get": { "operationId": "getCharacters", "summary": "GET /v1/characters", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "malId", "name", "url", "imageUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}": { "get": { "operationId": "getCharactersById", "summary": "GET /v1/characters/{id}", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "nicknames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "nameKanji": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "name", "nicknames", "nameKanji", "imageUrl", "images", "about", "favorites", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}/full": { "get": { "operationId": "getCharactersByIdFull", "summary": "GET /v1/characters/{id}/full", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "nicknames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "nameKanji": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" }, "anime": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "role" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "role" ] } }, "voices": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "language": { "type": [ "string", "null" ] } }, "required": [ "malId", "name", "imageUrl", "language" ] } } }, "required": [ "malId", "url", "name", "nicknames", "nameKanji", "imageUrl", "images", "about", "favorites", "fetchedAt", "anime", "manga", "voices" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}/anime": { "get": { "operationId": "getCharactersByIdAnime", "summary": "GET /v1/characters/{id}/anime", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "role" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}/manga": { "get": { "operationId": "getCharactersByIdManga", "summary": "GET /v1/characters/{id}/manga", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "role" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}/voices": { "get": { "operationId": "getCharactersByIdVoices", "summary": "GET /v1/characters/{id}/voices", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "language": { "type": [ "string", "null" ] } }, "required": [ "malId", "name", "imageUrl", "language" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/characters/{id}/pictures": { "get": { "operationId": "getCharactersByIdPictures", "summary": "GET /v1/characters/{id}/pictures", "tags": [ "characters" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "imageUrl": { "type": "string", "format": "uri" }, "thumbnailUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "imageUrl", "thumbnailUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/producers": { "get": { "operationId": "getProducers", "summary": "GET /v1/producers", "tags": [ "producers" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "count": { "type": "integer", "minimum": 0 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "count", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/producers/{id}": { "get": { "operationId": "getProducersById", "summary": "GET /v1/producers/{id}", "tags": [ "producers" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "established": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "name", "imageUrl", "established", "favorites", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/producers/{id}/full": { "get": { "operationId": "getProducersByIdFull", "summary": "GET /v1/producers/{id}/full", "tags": [ "producers" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "established": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" }, "about": { "type": [ "string", "null" ] }, "external": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } } }, "required": [ "malId", "url", "name", "imageUrl", "established", "favorites", "fetchedAt", "about", "external" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/producers/{id}/external": { "get": { "operationId": "getProducersByIdExternal", "summary": "GET /v1/producers/{id}/external", "tags": [ "producers" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/clubs": { "get": { "operationId": "getClubs", "summary": "GET /v1/clubs", "tags": [ "clubs" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "description": { "type": [ "string", "null" ] }, "members": { "type": [ "number", "null" ] } }, "required": [ "malId", "title", "imageUrl", "description", "members" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/clubs/{id}": { "get": { "operationId": "getClubsById", "summary": "GET /v1/clubs/{id}", "tags": [ "clubs" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "members": { "type": [ "number", "null" ] }, "pictures": { "type": [ "number", "null" ] }, "category": { "type": [ "string", "null" ] }, "created": { "type": [ "string", "null" ] }, "staff": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "username", "url", "role" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "members", "pictures", "category", "created", "staff", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/clubs/{id}/staff": { "get": { "operationId": "getClubsByIdStaff", "summary": "GET /v1/clubs/{id}/staff", "tags": [ "clubs" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "role": { "type": [ "string", "null" ] } }, "required": [ "username", "url", "role" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/clubs/{id}/relations": { "get": { "operationId": "getClubsByIdRelations", "summary": "GET /v1/clubs/{id}/relations", "tags": [ "clubs" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "anime": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 } }, "required": [ "malId", "title" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 } }, "required": [ "malId", "title" ] } }, "characters": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 } }, "required": [ "malId", "name" ] } } }, "required": [ "anime", "manga", "characters" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/clubs/{id}/members": { "get": { "operationId": "getClubsByIdMembers", "summary": "GET /v1/clubs/{id}/members", "tags": [ "clubs" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "avatarUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "username", "url", "avatarUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/top/people": { "get": { "operationId": "getTopPeople", "summary": "GET /v1/top/people", "tags": [ "top" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "nameKanji": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "birthday": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] } }, "required": [ "malId", "name", "nameKanji", "imageUrl", "birthday", "favorites" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people": { "get": { "operationId": "getPeople", "summary": "GET /v1/people", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "malId", "name", "url", "imageUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}": { "get": { "operationId": "getPeopleById", "summary": "GET /v1/people/{id}", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "givenName": { "type": [ "string", "null" ] }, "familyName": { "type": [ "string", "null" ] }, "alternateNames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "birthday": { "type": [ "string", "null" ] }, "birthDate": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "name", "givenName", "familyName", "alternateNames", "birthday", "birthDate", "website", "imageUrl", "images", "about", "favorites", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/full": { "get": { "operationId": "getPeopleByIdFull", "summary": "GET /v1/people/{id}/full", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "givenName": { "type": [ "string", "null" ] }, "familyName": { "type": [ "string", "null" ] }, "alternateNames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "birthday": { "type": [ "string", "null" ] }, "birthDate": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" }, "anime": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "positions": { "type": "array", "items": { "type": "string" } } }, "required": [ "animeId", "animeTitle", "imageUrl", "positions" ] } }, "manga": { "type": "array", "items": { "type": "object", "properties": { "mangaId": { "type": "integer", "exclusiveMinimum": 0 }, "mangaTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "positions": { "type": "array", "items": { "type": "string" } } }, "required": [ "mangaId", "mangaTitle", "imageUrl", "positions" ] } }, "voices": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "animeImageUrl": { "type": [ "string", "null" ], "format": "uri" }, "characterId": { "type": "integer", "exclusiveMinimum": 0 }, "characterName": { "type": "string", "minLength": 1 }, "characterRole": { "type": [ "string", "null" ] }, "characterImageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "animeId", "animeTitle", "animeImageUrl", "characterId", "characterName", "characterRole", "characterImageUrl" ] } } }, "required": [ "malId", "url", "name", "givenName", "familyName", "alternateNames", "birthday", "birthDate", "website", "imageUrl", "images", "about", "favorites", "fetchedAt", "anime", "manga", "voices" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/anime": { "get": { "operationId": "getPeopleByIdAnime", "summary": "GET /v1/people/{id}/anime", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "positions": { "type": "array", "items": { "type": "string" } } }, "required": [ "animeId", "animeTitle", "imageUrl", "positions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/manga": { "get": { "operationId": "getPeopleByIdManga", "summary": "GET /v1/people/{id}/manga", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "mangaId": { "type": "integer", "exclusiveMinimum": 0 }, "mangaTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "positions": { "type": "array", "items": { "type": "string" } } }, "required": [ "mangaId", "mangaTitle", "imageUrl", "positions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/voices": { "get": { "operationId": "getPeopleByIdVoices", "summary": "GET /v1/people/{id}/voices", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "animeImageUrl": { "type": [ "string", "null" ], "format": "uri" }, "characterId": { "type": "integer", "exclusiveMinimum": 0 }, "characterName": { "type": "string", "minLength": 1 }, "characterRole": { "type": [ "string", "null" ] }, "characterImageUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "animeId", "animeTitle", "animeImageUrl", "characterId", "characterName", "characterRole", "characterImageUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/pictures": { "get": { "operationId": "getPeopleByIdPictures", "summary": "GET /v1/people/{id}/pictures", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "imageUrl": { "type": "string", "format": "uri" }, "thumbnailUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "imageUrl", "thumbnailUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/people/{id}/news": { "get": { "operationId": "getPeopleByIdNews", "summary": "GET /v1/people/{id}/news", "tags": [ "people" ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "excerpt": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "author": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "url", "imageUrl", "excerpt", "date", "author" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/watch/episodes": { "get": { "operationId": "getWatchEpisodes", "summary": "GET /v1/watch/episodes", "tags": [ "watch" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "episodes": { "type": "array", "items": { "type": "string" } } }, "required": [ "animeId", "animeTitle", "imageUrl", "episodes" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/watch/episodes/popular": { "get": { "operationId": "getWatchEpisodesPopular", "summary": "GET /v1/watch/episodes/popular", "tags": [ "watch" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "episodes": { "type": "array", "items": { "type": "string" } } }, "required": [ "animeId", "animeTitle", "imageUrl", "episodes" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/watch/promos": { "get": { "operationId": "getWatchPromos", "summary": "GET /v1/watch/promos", "tags": [ "watch" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string" }, "videoUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "animeId", "animeTitle", "imageUrl", "title", "videoUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/watch/promos/popular": { "get": { "operationId": "getWatchPromosPopular", "summary": "GET /v1/watch/promos/popular", "tags": [ "watch" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "animeId": { "type": "integer", "exclusiveMinimum": 0 }, "animeTitle": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string" }, "videoUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "animeId", "animeTitle", "imageUrl", "title", "videoUrl" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/recommendations/anime": { "get": { "operationId": "getRecommendationsAnime", "summary": "GET /v1/recommendations/anime", "tags": [ "recommendations" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "recommendedMalId": { "type": "integer", "exclusiveMinimum": 0 }, "recommendedTitle": { "type": "string", "minLength": 1 }, "recommendedImageUrl": { "type": [ "string", "null" ], "format": "uri" }, "content": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "recommendedMalId", "recommendedTitle", "recommendedImageUrl", "content", "username" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/recommendations/manga": { "get": { "operationId": "getRecommendationsManga", "summary": "GET /v1/recommendations/manga", "tags": [ "recommendations" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "recommendedMalId": { "type": "integer", "exclusiveMinimum": 0 }, "recommendedTitle": { "type": "string", "minLength": 1 }, "recommendedImageUrl": { "type": [ "string", "null" ], "format": "uri" }, "content": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] } }, "required": [ "malId", "title", "imageUrl", "recommendedMalId", "recommendedTitle", "recommendedImageUrl", "content", "username" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/reviews/anime": { "get": { "operationId": "getReviewsAnime", "summary": "GET /v1/reviews/anime", "tags": [ "reviews" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "preliminary", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "spoilers", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "username": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "tag": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "reviewText": { "type": [ "string", "null" ] }, "reviewId": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "isPreliminary": { "type": "boolean" }, "isSpoiler": { "type": "boolean" }, "episodesWatched": { "type": [ "integer", "null" ], "minimum": 0 }, "chaptersRead": { "type": [ "integer", "null" ], "minimum": 0 }, "reactions": { "type": [ "object", "null" ], "properties": { "overall": { "type": "integer", "minimum": 0 }, "nice": { "type": "integer", "minimum": 0 }, "loveIt": { "type": "integer", "minimum": 0 }, "funny": { "type": "integer", "minimum": 0 }, "confusing": { "type": "integer", "minimum": 0 }, "informative": { "type": "integer", "minimum": 0 }, "wellWritten": { "type": "integer", "minimum": 0 }, "creative": { "type": "integer", "minimum": 0 } }, "required": [ "overall", "nice", "loveIt", "funny", "confusing", "informative", "wellWritten", "creative" ] } }, "required": [ "malId", "title", "imageUrl", "username", "date", "tag", "score", "reviewText", "reviewId", "url", "isPreliminary", "isSpoiler", "episodesWatched", "chaptersRead", "reactions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/reviews/manga": { "get": { "operationId": "getReviewsManga", "summary": "GET /v1/reviews/manga", "tags": [ "reviews" ], "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "page", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "preliminary", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "spoilers", "in": "query" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "title": { "type": "string", "minLength": 1 }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "username": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] }, "tag": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "reviewText": { "type": [ "string", "null" ] }, "reviewId": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "isPreliminary": { "type": "boolean" }, "isSpoiler": { "type": "boolean" }, "episodesWatched": { "type": [ "integer", "null" ], "minimum": 0 }, "chaptersRead": { "type": [ "integer", "null" ], "minimum": 0 }, "reactions": { "type": [ "object", "null" ], "properties": { "overall": { "type": "integer", "minimum": 0 }, "nice": { "type": "integer", "minimum": 0 }, "loveIt": { "type": "integer", "minimum": 0 }, "funny": { "type": "integer", "minimum": 0 }, "confusing": { "type": "integer", "minimum": 0 }, "informative": { "type": "integer", "minimum": 0 }, "wellWritten": { "type": "integer", "minimum": 0 }, "creative": { "type": "integer", "minimum": 0 } }, "required": [ "overall", "nice", "loveIt", "funny", "confusing", "informative", "wellWritten", "creative" ] } }, "required": [ "malId", "title", "imageUrl", "username", "date", "tag", "score", "reviewText", "reviewId", "url", "isPreliminary", "isSpoiler", "episodesWatched", "chaptersRead", "reactions" ] } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/random/anime": { "get": { "operationId": "getRandomAnime", "summary": "GET /v1/random/anime", "tags": [ "random" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "trailer": { "type": "object", "properties": { "youtubeId": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ], "format": "uri" }, "embedUrl": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "youtubeId", "url", "embedUrl" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "episodes": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "airing": { "type": "boolean" }, "aired": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "season": { "type": [ "string", "null" ] }, "year": { "type": [ "number", "null" ] }, "broadcast": { "type": "object", "properties": { "day": { "type": [ "string", "null" ] }, "time": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "day", "time", "timezone", "string" ] }, "studios": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "producers": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "licensors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "duration": { "type": [ "string", "null" ] }, "rating": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "streaming": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "available": { "type": "boolean" } }, "required": [ "name", "url", "available" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "trailer", "synopsis", "background", "type", "episodes", "status", "airing", "aired", "season", "year", "broadcast", "studios", "producers", "licensors", "genres", "themes", "demographics", "duration", "rating", "score", "scoredBy", "rank", "popularity", "members", "favorites", "source", "relations", "externalLinks", "streaming", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/random/manga": { "get": { "operationId": "getRandomManga", "summary": "GET /v1/random/manga", "tags": [ "random" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string", "minLength": 1 }, "titleEnglish": { "type": [ "string", "null" ] }, "titleJapanese": { "type": [ "string", "null" ] }, "titleSynonyms": { "type": "array", "items": { "type": "string" } }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "synopsis": { "type": [ "string", "null" ] }, "background": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "volumes": { "type": [ "number", "null" ] }, "chapters": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "publishing": { "type": "boolean" }, "published": { "type": "object", "properties": { "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "string": { "type": [ "string", "null" ] } }, "required": [ "from", "to", "string" ] }, "authors": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "serializations": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "themes": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "demographics": { "type": "array", "items": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "malId", "name", "url" ] } }, "score": { "type": [ "number", "null" ] }, "scoredBy": { "type": [ "number", "null" ] }, "rank": { "type": [ "number", "null" ] }, "popularity": { "type": [ "number", "null" ] }, "members": { "type": [ "number", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation": { "type": "string", "minLength": 1 }, "malId": { "type": "integer", "exclusiveMinimum": 0 }, "type": { "type": "string", "enum": [ "anime", "manga" ] }, "title": { "type": "string", "minLength": 1 } }, "required": [ "relation", "malId", "type", "title" ] } }, "externalLinks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "title", "titleEnglish", "titleJapanese", "titleSynonyms", "imageUrl", "images", "synopsis", "background", "type", "volumes", "chapters", "status", "publishing", "published", "authors", "serializations", "genres", "themes", "demographics", "score", "scoredBy", "rank", "popularity", "members", "favorites", "relations", "externalLinks", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/random/characters": { "get": { "operationId": "getRandomCharacters", "summary": "GET /v1/random/characters", "tags": [ "random" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "nicknames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "nameKanji": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "name", "nicknames", "nameKanji", "imageUrl", "images", "about", "favorites", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/random/people": { "get": { "operationId": "getRandomPeople", "summary": "GET /v1/random/people", "tags": [ "random" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "malId": { "type": "integer", "exclusiveMinimum": 0 }, "url": { "type": [ "string", "null" ], "format": "uri" }, "name": { "type": "string", "minLength": 1 }, "givenName": { "type": [ "string", "null" ] }, "familyName": { "type": [ "string", "null" ] }, "alternateNames": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "birthday": { "type": [ "string", "null" ] }, "birthDate": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "imageUrl": { "type": [ "string", "null" ], "format": "uri" }, "images": { "type": "object", "properties": { "small": { "type": [ "string", "null" ], "format": "uri" }, "medium": { "type": [ "string", "null" ], "format": "uri" }, "large": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "small", "medium", "large" ] }, "about": { "type": [ "string", "null" ] }, "favorites": { "type": [ "number", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "malId", "url", "name", "givenName", "familyName", "alternateNames", "birthday", "birthDate", "website", "imageUrl", "images", "about", "favorites", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/random/users": { "get": { "operationId": "getRandomUsers", "summary": "GET /v1/random/users", "tags": [ "random" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "maxLength": 64 }, "canonicalUsername": { "type": "string", "minLength": 1, "maxLength": 64 }, "profileUrl": { "type": "string", "format": "uri" }, "avatarUrl": { "type": [ "string", "null" ], "format": "uri" }, "about": { "type": [ "string", "null" ] }, "gender": { "type": [ "string", "null" ] }, "location": { "type": [ "string", "null" ] }, "birthday": { "type": [ "string", "null" ] }, "joinedAt": { "type": [ "string", "null" ] }, "lastOnlineAt": { "type": [ "string", "null" ] }, "fetchedAt": { "type": "string", "format": "date-time" } }, "required": [ "username", "canonicalUsername", "profileUrl", "avatarUrl", "about", "gender", "location", "birthday", "joinedAt", "lastOnlineAt", "fetchedAt" ] }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "default": { "description": "Any error, with a machine-readable code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "webhooks": {} }