{ "openapi": "3.0.0", "info": { "title": "Jikan API", "description": "[Jikan](https://jikan.moe) is an **Unofficial** MyAnimeList API.\nIt scrapes the website to satisfy the need for a complete API - which MyAnimeList lacks.\n\n# Information\n\nāš” Jikan is powered by its awesome backers - šŸ™ [Become a backer](https://www.patreon.com/jikan)\n\n## Rate Limiting\n\n| Duration | Requests |\n|----|----|\n| Daily | **Unlimited** |\n| Per Minute | 60 requests |\n| Per Second | 3 requests |\n\nNote: It's still possible to get rate limited from MyAnimeList.net instead.\n\n\n## JSON Notes\n- Any property (except arrays or objects) whose value does not exist or is undetermined, will be `null`.\n- Any array or object property whose value does not exist or is undetermined, will be empty.\n- Any `score` property whose value does not exist or is undetermined, will be `0`.\n- All dates and timestamps are returned in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format and in UTC timezone\n\n## Caching\nBy **CACHING**, we refer to the data parsed from MyAnimeList which is stored temporarily on our servers to provide better API performance.\n\nAll requests are cached for **24 hours**.\n\nThe following response headers will detail cache information.\n\n| Header | Remarks |\n| ---- | ---- |\n| `Expires` | Cache expiry date |\n| `Last-Modified` | Cache set date |\n| `X-Request-Fingerprint` | Unique request fingerprint (only for cachable requests, not queries) |\n\n\nNote: `X-Request-Fingerprint` will only be available on single resource requests and their child endpoints. e.g `/anime/1`, `/anime/1/relations`.\nThey won't be available on pages which perform queries, like /anime, or /top/anime, etc.\n\n## Allowed HTTP(s) requests\n\n**Jikan REST API does not provide authenticated requests for MyAnimeList.** This means you can not use it to update your anime/manga list.\nOnly GET requests are supported which return READ-ONLY data.\n\n## HTTP Responses\n\nAll error responses are accompanied by a JSON Error response.\n\n| Exception | HTTP Status | Remarks |\n| ---- | ---- | ---- |\n| N/A | `200 - OK` | The request was successful |\n| N/A | `304 - Not Modified` | You have the latest data (Cache Validation response) |\n| `BadRequestException`,`ValidationException` | `400 - Bad Request` | You've made an invalid request. Recheck documentation |\n| `BadResponseException` | `404 - Not Found` | The resource was not found or MyAnimeList responded with a `404` |\n| `BadRequestException` | `405 - Method Not Allowed` | Requested Method is not supported for resource. Only `GET` requests are allowed |\n| `RateLimitException` | `429 - Too Many Request` | You are being rate limited by Jikan or MyAnimeList is rate-limiting our servers (specified in the error response) |\n| `UpstreamException`,`ParserException`,etc. | `500 - Internal Server Error` | Something didn't work. Try again later. If you see an error response with a `report_url` URL, please click on it to open an auto-generated GitHub issue |\n| `ServiceUnavailableException` | `503 - Service Unavailable` | In most cases this is intentionally done if the service is down for maintenance. |\n\n## JSON Error Response\n\n```json\n {\n \"status\": 500,\n \"type\": \"InternalException\",\n \"message\": \"Exception Message\",\n \"error\": \"Exception Trace\",\n \"report_url\": \"https://github.com...\"\n }\n```\n\n| Property | Remarks |\n| ---- | ---- |\n| `status` | Returned HTTP Status Code |\n| `type` | Thrown Exception |\n| `message` | Human-readable error message |\n| `error` | Error response and trace from the API |\n| `report_url` | Clicking this would redirect you to a generated GitHub issue |\n\n\n## Cache Validation\n\n- All requests return a `ETag` header which is an MD5 hash of the response\n- You can use this hash to verify if there's new or updated content by suppliying it as the value for the `If-None-Match` in your next request header\n- You will get a HTTP `304 - Not Modified` response if the content has not changed\n- If the content has changed, you'll get a HTTP `200 - OK` response with the updated JSON response\n\n![Cache Validation](https://i.imgur.com/925ozVn.png 'Cache Validation')\n\n## Disclaimer\n\n- Jikan is not affiliated with MyAnimeList.net.\n- Jikan is a free, open-source API. Please use it responsibly.\n\n----\n\nBy using the API, you are agreeing to Jikan's [terms of use](https://jikan.moe/terms) policy.\n\n[v3 Documentation](https://jikan.docs.apiary.io/) - [Wrappers/SDKs](https://github.com/jikan-me/jikan#wrappers) - [Report an issue](https://github.com/jikan-me/jikan-rest/issues/new) - [Host your own server](https://github.com/jikan-me/jikan-rest)", "termsOfService": "https://jikan.moe/terms", "contact": { "name": "API Support (Discord)", "url": "http://discord.jikan.moe" }, "license": { "name": "MIT", "url": "https://github.com/jikan-me/jikan-rest/blob/master/LICENSE" }, "version": "4.0.0" }, "servers": [ { "url": "https://api.jikan.moe/v4", "description": "Jikan REST API" } ], "paths": { "/anime/{id}/full": { "get": { "tags": [ "anime" ], "operationId": "getAnimeFullById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns complete anime resource data", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/anime_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}": { "get": { "tags": [ "anime" ], "operationId": "getAnimeById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/anime" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/characters": { "get": { "tags": [ "anime" ], "operationId": "getAnimeCharacters", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime characters resource", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_characters" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/staff": { "get": { "tags": [ "anime" ], "operationId": "getAnimeStaff", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime staff resource", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_staff" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/episodes": { "get": { "tags": [ "anime" ], "operationId": "getAnimeEpisodes", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns a list of anime episodes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_episodes" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/episodes/{episode}": { "get": { "tags": [ "anime" ], "operationId": "getAnimeEpisodeById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "episode", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns a single anime episode resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/anime_episode" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/news": { "get": { "tags": [ "anime" ], "operationId": "getAnimeNews", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns a list of news articles related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_news" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/forum": { "get": { "tags": [ "anime" ], "operationId": "getAnimeForum", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "filter", "in": "query", "description": "Filter topics", "required": false, "schema": { "type": "string", "enum": [ "all", "episode", "other" ] } } ], "responses": { "200": { "description": "Returns a list of forum topics related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/forum" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/videos": { "get": { "tags": [ "anime" ], "operationId": "getAnimeVideos", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns videos related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_videos" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/videos/episodes": { "get": { "tags": [ "anime" ], "operationId": "getAnimeVideosEpisodes", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns episode videos related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_videos_episodes" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/pictures": { "get": { "tags": [ "anime" ], "operationId": "getAnimePictures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns pictures related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/pictures_variants" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/statistics": { "get": { "tags": [ "anime" ], "operationId": "getAnimeStatistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_statistics" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/moreinfo": { "get": { "tags": [ "anime" ], "operationId": "getAnimeMoreInfo", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/moreinfo" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/recommendations": { "get": { "tags": [ "anime" ], "operationId": "getAnimeRecommendations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/entry_recommendations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/userupdates": { "get": { "tags": [ "anime" ], "operationId": "getAnimeUserUpdates", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns a list of users who have added/updated/removed the entry on their list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_userupdates" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/reviews": { "get": { "tags": [ "anime" ], "operationId": "getAnimeReviews", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/preliminary" }, { "$ref": "#/components/parameters/spoilers" } ], "responses": { "200": { "description": "Returns anime reviews", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_reviews" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/relations": { "get": { "tags": [ "anime" ], "operationId": "getAnimeRelations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime relations", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/relation" } } }, "type": "object" } } } } } } }, "/anime/{id}/themes": { "get": { "tags": [ "anime" ], "operationId": "getAnimeThemes", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime themes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_themes" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/external": { "get": { "tags": [ "anime" ], "operationId": "getAnimeExternal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime external links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/external_links" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime/{id}/streaming": { "get": { "tags": [ "anime" ], "operationId": "getAnimeStreaming", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime streaming links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/external_links" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}/full": { "get": { "tags": [ "characters" ], "operationId": "getCharacterFullById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns complete character resource data", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/character_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}": { "get": { "tags": [ "characters" ], "operationId": "getCharacterById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns character resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/character" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}/anime": { "get": { "tags": [ "characters" ], "operationId": "getCharacterAnime", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime that character is in", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/character_anime" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}/manga": { "get": { "tags": [ "characters" ], "operationId": "getCharacterManga", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga that character is in", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/character_manga" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}/voices": { "get": { "tags": [ "characters" ], "operationId": "getCharacterVoiceActors", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns the character's voice actors", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/character_voice_actors" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters/{id}/pictures": { "get": { "tags": [ "characters" ], "operationId": "getCharacterPictures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns pictures related to the entry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/character_pictures" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/clubs/{id}": { "get": { "tags": [ "clubs" ], "operationId": "getClubsById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns Club Resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/club" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/clubs/{id}/members": { "get": { "tags": [ "clubs" ], "operationId": "getClubMembers", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns Club Members Resource", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/pagination" }, { "$ref": "#/components/schemas/club_member" } ] } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/clubs/{id}/staff": { "get": { "tags": [ "clubs" ], "operationId": "getClubStaff", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns Club Staff", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/club_staff" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/clubs/{id}/relations": { "get": { "tags": [ "clubs" ], "operationId": "getClubRelations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns Club Relations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/club_relations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/genres/anime": { "get": { "tags": [ "genres" ], "operationId": "getAnimeGenres", "parameters": [ { "name": "filter", "in": "query", "schema": { "$ref": "#/components/schemas/genre_query_filter" } } ], "responses": { "200": { "description": "Returns entry genres, explicit_genres, themes and demographics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genres" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/genres/manga": { "get": { "tags": [ "genres" ], "operationId": "getMangaGenres", "parameters": [ { "name": "filter", "in": "query", "schema": { "$ref": "#/components/schemas/genre_query_filter" } } ], "responses": { "200": { "description": "Returns entry genres, explicit_genres, themes and demographics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genres" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/magazines": { "get": { "tags": [ "magazines" ], "operationId": "getMagazines", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/magazines_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns magazines collection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/magazines" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/full": { "get": { "tags": [ "manga" ], "operationId": "getMangaFullById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns complete manga resource data", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/manga_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}": { "get": { "tags": [ "manga" ], "operationId": "getMangaById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns pictures related to the entry", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/manga" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/characters": { "get": { "tags": [ "manga" ], "operationId": "getMangaCharacters", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga characters resource", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_characters" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/news": { "get": { "tags": [ "manga" ], "operationId": "getMangaNews", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns a list of manga news topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_news" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/forum": { "get": { "tags": [ "manga" ], "operationId": "getMangaTopics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "filter", "in": "query", "description": "Filter topics", "required": false, "schema": { "type": "string", "enum": [ "all", "episode", "other" ] } } ], "responses": { "200": { "description": "Returns a list of manga forum topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/forum" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/pictures": { "get": { "tags": [ "manga" ], "operationId": "getMangaPictures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns a list of manga pictures", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_pictures" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/statistics": { "get": { "tags": [ "manga" ], "operationId": "getMangaStatistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns anime statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_statistics" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/moreinfo": { "get": { "tags": [ "manga" ], "operationId": "getMangaMoreInfo", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga moreinfo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/moreinfo" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/recommendations": { "get": { "tags": [ "manga" ], "operationId": "getMangaRecommendations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/entry_recommendations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/userupdates": { "get": { "tags": [ "manga" ], "operationId": "getMangaUserUpdates", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns manga user updates", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_userupdates" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/reviews": { "get": { "tags": [ "manga" ], "operationId": "getMangaReviews", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/preliminary" }, { "$ref": "#/components/parameters/spoilers" } ], "responses": { "200": { "description": "Returns manga reviews", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_reviews" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/relations": { "get": { "tags": [ "manga" ], "operationId": "getMangaRelations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga relations", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/relation" } } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga/{id}/external": { "get": { "tags": [ "manga" ], "operationId": "getMangaExternal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns manga external links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/external_links" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}/full": { "get": { "tags": [ "people" ], "operationId": "getPersonFullById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns complete character resource data", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/person_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}": { "get": { "tags": [ "people" ], "operationId": "getPersonById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns pictures related to the entry", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/person" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}/anime": { "get": { "tags": [ "people" ], "operationId": "getPersonAnime", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns person's anime staff positions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/person_anime" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}/voices": { "get": { "tags": [ "people" ], "operationId": "getPersonVoices", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns person's voice acting roles", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/person_voice_acting_roles" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}/manga": { "get": { "tags": [ "people" ], "operationId": "getPersonManga", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns person's published manga works", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/person_manga" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people/{id}/pictures": { "get": { "tags": [ "people" ], "operationId": "getPersonPictures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns a list of pictures of the person", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/person_pictures" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/producers/{id}": { "get": { "tags": [ "producers" ], "operationId": "getProducerById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns producer resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/producer" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/producers/{id}/full": { "get": { "tags": [ "producers" ], "operationId": "getProducerFullById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns producer resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/producer_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/producers/{id}/external": { "get": { "tags": [ "producers" ], "operationId": "getProducerExternal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns producer's external links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/external_links" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/random/anime": { "get": { "tags": [ "random" ], "operationId": "getRandomAnime", "responses": { "200": { "description": "Returns a random anime resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/anime" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/random/manga": { "get": { "tags": [ "random" ], "operationId": "getRandomManga", "responses": { "200": { "description": "Returns a random manga resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/manga" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/random/characters": { "get": { "tags": [ "random" ], "operationId": "getRandomCharacters", "responses": { "200": { "description": "Returns a random character resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/character" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/random/people": { "get": { "tags": [ "random" ], "operationId": "getRandomPeople", "responses": { "200": { "description": "Returns a random person resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/person" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/random/users": { "get": { "tags": [ "random" ], "operationId": "getRandomUsers", "responses": { "200": { "description": "Returns a random user profile resource", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/user_profile" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/recommendations/anime": { "get": { "tags": [ "recommendations" ], "operationId": "getRecentAnimeRecommendations", "parameters": [ { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns recent anime recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recommendations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/recommendations/manga": { "get": { "tags": [ "recommendations" ], "operationId": "getRecentMangaRecommendations", "parameters": [ { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns recent manga recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recommendations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/reviews/anime": { "get": { "tags": [ "reviews" ], "operationId": "getRecentAnimeReviews", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/preliminary" }, { "$ref": "#/components/parameters/spoilers" } ], "responses": { "200": { "description": "Returns recent anime reviews", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/reviews/manga": { "get": { "tags": [ "reviews" ], "operationId": "getRecentMangaReviews", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/preliminary" }, { "$ref": "#/components/parameters/spoilers" } ], "responses": { "200": { "description": "Returns recent manga reviews", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/schedules": { "get": { "tags": [ "schedules" ], "operationId": "getSchedules", "parameters": [ { "name": "filter", "in": "query", "description": "Filter by day", "required": false, "schema": { "type": "string", "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", "unknown", "other" ] } }, { "name": "kids", "in": "query", "description": "When supplied, it will filter entries with the `Kids` Genre Demographic. When supplied as `kids=true`, it will return only Kid entries and when supplied as `kids=false`, it will filter out any Kid entries. Defaults to `false`.", "required": false, "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "sfw", "in": "query", "description": "'Safe For Work'. When supplied, it will filter entries with the `Hentai` Genre. When supplied as `sfw=true`, it will return only SFW entries and when supplied as `sfw=false`, it will filter out any Hentai entries. Defaults to `false`.", "required": false, "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns weekly schedule", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/schedules" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/anime": { "get": { "tags": [ "anime" ], "operationId": "getAnimeSearch", "parameters": [ { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/anime_search_query_type" } }, { "name": "score", "in": "query", "schema": { "type": "number" } }, { "name": "min_score", "in": "query", "description": "Set a minimum score for results.", "schema": { "type": "number" } }, { "name": "max_score", "in": "query", "description": "Set a maximum score for results", "schema": { "type": "number" } }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/anime_search_query_status" } }, { "name": "rating", "in": "query", "schema": { "$ref": "#/components/schemas/anime_search_query_rating" } }, { "name": "sfw", "in": "query", "description": "Filter out Adult entries", "schema": { "type": "boolean" } }, { "name": "genres", "in": "query", "description": "Filter by genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "genres_exclude", "in": "query", "description": "Exclude genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/anime_search_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } }, { "name": "producers", "in": "query", "description": "Filter by producer(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "description": "Filter by starting date. Format: YYYY-MM-DD. e.g `2022`, `2005-05`, `2005-01-01`", "schema": { "type": "string" } }, { "name": "end_date", "in": "query", "description": "Filter by ending date. Format: YYYY-MM-DD. e.g `2022`, `2005-05`, `2005-01-01`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns search results for anime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/manga": { "get": { "tags": [ "manga" ], "operationId": "getMangaSearch", "parameters": [ { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/manga_search_query_type" } }, { "name": "score", "in": "query", "schema": { "type": "number" } }, { "name": "min_score", "in": "query", "description": "Set a minimum score for results.", "schema": { "type": "number" } }, { "name": "max_score", "in": "query", "description": "Set a maximum score for results", "schema": { "type": "number" } }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/manga_search_query_status" } }, { "name": "sfw", "in": "query", "description": "Filter out Adult entries", "schema": { "type": "boolean" } }, { "name": "genres", "in": "query", "description": "Filter by genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "genres_exclude", "in": "query", "description": "Exclude genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/manga_search_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } }, { "name": "magazines", "in": "query", "description": "Filter by magazine(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3", "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "description": "Filter by starting date. Format: YYYY-MM-DD. e.g `2022`, `2005-05`, `2005-01-01`", "schema": { "type": "string" } }, { "name": "end_date", "in": "query", "description": "Filter by ending date. Format: YYYY-MM-DD. e.g `2022`, `2005-05`, `2005-01-01`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns search results for manga", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/people": { "get": { "tags": [ "people" ], "operationId": "getPeopleSearch", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/people_search_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns search results for people", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/people_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/characters": { "get": { "tags": [ "characters" ], "operationId": "getCharactersSearch", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/characters_search_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns search results for characters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/characters_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users": { "get": { "tags": [ "users" ], "operationId": "getUsersSearch", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "gender", "in": "query", "schema": { "$ref": "#/components/schemas/users_search_query_gender" } }, { "name": "location", "in": "query", "schema": { "type": "string" } }, { "name": "maxAge", "in": "query", "schema": { "type": "integer" } }, { "name": "minAge", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns search results for users", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/users_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/userbyid/{id}": { "get": { "tags": [ "users" ], "operationId": "getUserById", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Returns username by ID search", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/user_by_id" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/clubs": { "get": { "tags": [ "clubs" ], "operationId": "getClubsSearch", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/club_search_query_type" } }, { "name": "category", "in": "query", "schema": { "$ref": "#/components/schemas/club_search_query_category" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/club_search_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns search results for clubs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/clubs_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/producers": { "get": { "tags": [ "producers" ], "operationId": "getProducers", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "order_by", "in": "query", "schema": { "$ref": "#/components/schemas/producers_query_orderby" } }, { "name": "sort", "in": "query", "schema": { "$ref": "#/components/schemas/search_query_sort" } }, { "name": "letter", "in": "query", "description": "Return entries starting with the given letter", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns producers collection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/producers" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/seasons/now": { "get": { "tags": [ "seasons" ], "operationId": "getSeasonNow", "parameters": [ { "name": "filter", "in": "query", "description": "Entry types", "schema": { "type": "string", "enum": [ "tv", "movie", "ova", "special", "ona", "music" ] } }, { "$ref": "#/components/parameters/sfw" }, { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/continuing" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns current seasonal anime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/seasons/{year}/{season}": { "get": { "tags": [ "seasons" ], "operationId": "getSeason", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "season", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Entry types", "schema": { "type": "string", "enum": [ "tv", "movie", "ova", "special", "ona", "music" ] } }, { "$ref": "#/components/parameters/sfw" }, { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/continuing" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns seasonal anime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/seasons": { "get": { "tags": [ "seasons" ], "operationId": "getSeasonsList", "responses": { "200": { "description": "Returns available list of seasons", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/seasons" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/seasons/upcoming": { "get": { "tags": [ "seasons" ], "operationId": "getSeasonUpcoming", "parameters": [ { "name": "filter", "in": "query", "description": "Entry types", "schema": { "type": "string", "enum": [ "tv", "movie", "ova", "special", "ona", "music" ] } }, { "$ref": "#/components/parameters/sfw" }, { "$ref": "#/components/parameters/unapproved" }, { "$ref": "#/components/parameters/continuing" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns upcoming season's anime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/top/anime": { "get": { "tags": [ "top" ], "operationId": "getTopAnime", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/anime_search_query_type" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/top_anime_filter" } }, { "name": "rating", "in": "query", "schema": { "$ref": "#/components/schemas/anime_search_query_rating" } }, { "name": "sfw", "in": "query", "description": "Filter out Adult entries", "schema": { "type": "boolean" } }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns top anime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/anime_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/top/manga": { "get": { "tags": [ "top" ], "operationId": "getTopManga", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/manga_search_query_type" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/top_manga_filter" } }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns top manga", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manga_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/top/people": { "get": { "tags": [ "top" ], "operationId": "getTopPeople", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns top people", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/people_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/top/characters": { "get": { "tags": [ "top" ], "operationId": "getTopCharacters", "parameters": [ { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Returns top characters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/characters_search" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/top/reviews": { "get": { "tags": [ "top" ], "operationId": "getTopReviews", "parameters": [ { "$ref": "#/components/parameters/page" }, { "name": "type", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/top_reviews_type_enum" } }, { "name": "preliminary", "in": "query", "description": "Whether the results include preliminary reviews or not. Defaults to true.", "required": false, "schema": { "type": "boolean" } }, { "name": "spoilers", "in": "query", "description": "Whether the results include reviews with spoilers or not. Defaults to true.", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Returns top reviews", "content": { "application/json": { "schema": { "properties": { "data": { "allOf": [ { "properties": { "data": { "type": "array", "items": { "anyOf": [ { "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "properties": { "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/anime_review" } ] }, { "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "properties": { "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/manga_review" } ] } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/full": { "get": { "tags": [ "users" ], "operationId": "getUserFullProfile", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns complete user resource data", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/user_profile_full" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}": { "get": { "tags": [ "users" ], "operationId": "getUserProfile", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user profile", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/user_profile" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/statistics": { "get": { "tags": [ "users" ], "operationId": "getUserStatistics", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_statistics" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/favorites": { "get": { "tags": [ "users" ], "operationId": "getUserFavorites", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user favorites", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/user_favorites" } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/userupdates": { "get": { "tags": [ "users" ], "operationId": "getUserUpdates", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user updates", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_updates" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/about": { "get": { "tags": [ "users" ], "operationId": "getUserAbout", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user about in raw HTML", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_about" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/history": { "get": { "tags": [ "users" ], "operationId": "getUserHistory", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "anime", "manga" ] } } ], "responses": { "200": { "description": "Returns user history (past 30 days)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_history" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/friends": { "get": { "tags": [ "users" ], "operationId": "getUserFriends", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns user friends", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_friends" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/animelist": { "get": { "tags": [ "users" ], "description": "User Anime lists have been discontinued since May 1st, 2022. Read more", "operationId": "getUserAnimelist", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/user_anime_list_status_filter" } } ], "responses": { "200": { "description": "Returns user anime list", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } }, "deprecated": true } }, "/users/{username}/mangalist": { "get": { "tags": [ "users" ], "description": "User Manga lists have been discontinued since May 1st, 2022. Read more", "operationId": "getUserMangaList", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/user_manga_list_status_filter" } } ], "responses": { "200": { "description": "Returns user manga list", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } }, "deprecated": true } }, "/users/{username}/reviews": { "get": { "tags": [ "users" ], "operationId": "getUserReviews", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns user reviews", "content": { "application/json": { "schema": { "properties": { "data": { "allOf": [ { "properties": { "data": { "type": "array", "items": { "anyOf": [ { "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "properties": { "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/anime_review" } ] }, { "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "properties": { "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/manga_review" } ] } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] } }, "type": "object" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/recommendations": { "get": { "tags": [ "users" ], "operationId": "getUserRecommendations", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns Recent Anime Recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recommendations" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/clubs": { "get": { "tags": [ "users" ], "operationId": "getUserClubs", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns user clubs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_clubs" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/users/{username}/external": { "get": { "tags": [ "users" ], "operationId": "getUserExternal", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns user's external links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/external_links" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/watch/episodes": { "get": { "tags": [ "watch" ], "operationId": "getWatchRecentEpisodes", "responses": { "200": { "description": "Returns Recently Added Episodes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watch_episodes" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/watch/episodes/popular": { "get": { "tags": [ "watch" ], "operationId": "getWatchPopularEpisodes", "responses": { "200": { "description": "Returns Popular Episodes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watch_episodes" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/watch/promos": { "get": { "tags": [ "watch" ], "operationId": "getWatchRecentPromos", "parameters": [ { "$ref": "#/components/parameters/page" } ], "responses": { "200": { "description": "Returns Recently Added Promotional Videos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watch_promos" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } }, "/watch/promos/popular": { "get": { "tags": [ "watch" ], "operationId": "getWatchPopularPromos", "responses": { "200": { "description": "Returns Popular Promotional Videos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watch_promos" } } } }, "400": { "description": "Error: Bad request. When required parameters were not supplied." } } } } }, "components": { "schemas": { "user_anime_list_status_filter": { "description": "User's anime list status filter options", "type": "string", "enum": [ "all", "watching", "completed", "onhold", "dropped", "plantowatch" ] }, "anime_search_query_orderby": { "description": "Available Anime order_by properties", "type": "string", "enum": [ "mal_id", "title", "start_date", "end_date", "episodes", "score", "scored_by", "rank", "popularity", "members", "favorites" ] }, "anime_search_query_rating": { "description": "Available Anime audience ratings

Ratings
", "type": "string", "enum": [ "g", "pg", "pg13", "r17", "r", "rx" ] }, "anime_search_query_status": { "description": "Available Anime statuses", "type": "string", "enum": [ "airing", "complete", "upcoming" ] }, "anime_search_query_type": { "description": "Available Anime types", "type": "string", "enum": [ "tv", "movie", "ova", "special", "ona", "music", "cm", "pv", "tv_special" ] }, "characters_search_query_orderby": { "description": "Available Character order_by properties", "type": "string", "enum": [ "mal_id", "name", "favorites" ] }, "club_search_query_category": { "description": "Club Search Query Category", "type": "string", "enum": [ "anime", "manga", "actors_and_artists", "characters", "cities_and_neighborhoods", "companies", "conventions", "games", "japan", "music", "other", "schools" ] }, "club_search_query_orderby": { "description": "Club Search Query OrderBy", "type": "string", "enum": [ "mal_id", "name", "members_count", "created" ] }, "club_search_query_type": { "description": "Club Search Query Type", "type": "string", "enum": [ "public", "private", "secret" ] }, "users_search_query_gender": { "description": "Users Search Query Gender.", "type": "string", "enum": [ "any", "male", "female", "nonbinary" ] }, "genre_query_filter": { "description": "Filter genres by type", "type": "string", "enum": [ "genres", "explicit_genres", "themes", "demographics" ] }, "magazines_query_orderby": { "description": "Order by magazine data", "type": "string", "enum": [ "mal_id", "name", "count" ] }, "user_manga_list_status_filter": { "description": "User's anime list status filter options", "type": "string", "enum": [ "all", "reading", "completed", "onhold", "dropped", "plantoread" ] }, "manga_search_query_orderby": { "description": "Available Manga order_by properties", "type": "string", "enum": [ "mal_id", "title", "start_date", "end_date", "chapters", "volumes", "score", "scored_by", "rank", "popularity", "members", "favorites" ] }, "manga_search_query_status": { "description": "Available Manga statuses", "type": "string", "enum": [ "publishing", "complete", "hiatus", "discontinued", "upcoming" ] }, "manga_search_query_type": { "description": "Available Manga types", "type": "string", "enum": [ "manga", "novel", "lightnovel", "oneshot", "doujin", "manhwa", "manhua" ] }, "people_search_query_orderby": { "description": "Available People order_by properties", "type": "string", "enum": [ "mal_id", "name", "birthday", "favorites" ] }, "producers_query_orderby": { "description": "Producers Search Query Order By", "type": "string", "enum": [ "mal_id", "count", "favorites", "established" ] }, "search_query_sort": { "description": "Search query sort direction", "type": "string", "enum": [ "desc", "asc" ] }, "top_anime_filter": { "description": "Top items filter types", "type": "string", "enum": [ "airing", "upcoming", "bypopularity", "favorite" ] }, "top_manga_filter": { "description": "Top items filter types", "type": "string", "enum": [ "publishing", "upcoming", "bypopularity", "favorite" ] }, "top_reviews_type_enum": { "description": "The type of reviews to filter by. Defaults to anime.", "type": "string", "enum": [ "anime", "manga" ] }, "anime_episodes": { "description": "Anime Episodes Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL. This is the URL of the episode's video. If there is no video url, this will be null.", "type": "string", "nullable": true }, "title": { "description": "Title", "type": "string" }, "title_japanese": { "description": "Title Japanese", "type": "string", "nullable": true }, "title_romanji": { "description": "title_romanji", "type": "string", "nullable": true }, "aired": { "description": "Aired Date ISO8601", "type": "string", "nullable": true }, "score": { "description": "Aggregated episode score (1.00 - 5.00) based on MyAnimeList user voting", "type": "float", "maximum": "5", "minimum": "1", "nullable": true }, "filler": { "description": "Filler episode", "type": "boolean" }, "recap": { "description": "Recap episode", "type": "boolean" }, "forum_url": { "description": "Episode discussion forum URL", "type": "string", "nullable": true } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "anime_news": { "description": "Anime News Resource", "allOf": [ { "$ref": "#/components/schemas/pagination" }, { "$ref": "#/components/schemas/news" } ] }, "anime_videos_episodes": { "description": "Anime Videos Episodes Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID or Episode Number", "type": "integer" }, "title": { "description": "Episode Title", "type": "string" }, "episode": { "description": "Episode Subtitle", "type": "string" }, "url": { "description": "Episode Page URL", "type": "string" }, "images": { "$ref": "#/components/schemas/common_images" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "character_pictures": { "description": "Character Pictures", "properties": { "data": { "type": "array", "items": { "properties": { "image_url": { "description": "Default JPG Image Size URL", "type": "string", "nullable": true }, "large_image_url": { "description": "Large JPG Image Size URL", "type": "string", "nullable": true } }, "type": "object" } } }, "type": "object" }, "club_member": { "description": "Club Member", "properties": { "data": { "type": "array", "items": { "properties": { "username": { "description": "User's username", "type": "string" }, "url": { "description": "User URL", "type": "string" }, "images": { "$ref": "#/components/schemas/user_images" } }, "type": "object" } } }, "type": "object" }, "manga_news": { "description": "Manga News Resource", "allOf": [ { "$ref": "#/components/schemas/pagination" }, { "$ref": "#/components/schemas/news" } ] }, "manga_pictures": { "description": "Manga Pictures", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/manga_images" } } }, "type": "object" }, "person_pictures": { "description": "Character Pictures", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/people_images" } } }, "type": "object" }, "random": { "description": "Random Resources", "properties": { "data": { "type": "array", "items": { "type": "object", "anyOf": [ { "$ref": "#/components/schemas/anime" }, { "$ref": "#/components/schemas/manga" }, { "$ref": "#/components/schemas/character" }, { "$ref": "#/components/schemas/person" } ] } } }, "type": "object" }, "schedules": { "description": "Anime resources currently airing", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/anime" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination_plus" } ] }, "users_search": { "description": "User Results", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "url": { "description": "MyAnimeList URL", "type": "string" }, "username": { "description": "MyAnimeList Username", "type": "string" }, "images": { "$ref": "#/components/schemas/user_images" }, "last_online": { "description": "Last Online Date ISO8601", "type": "string" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "seasons": { "description": "List of available seasons", "properties": { "data": { "type": "array", "items": { "properties": { "year": { "description": "Year", "type": "integer" }, "seasons": { "description": "List of available seasons", "type": "array", "items": { "type": "string" } } }, "type": "object" } } }, "type": "object" }, "reviews_collection": { "description": "Anime & Manga Reviews Resource", "properties": { "data": { "type": "array", "items": { "type": "object", "anyOf": [ { "$ref": "#/components/schemas/anime_review" }, { "$ref": "#/components/schemas/manga_review" } ] } } }, "type": "object" }, "user_friends": { "description": "User Friends", "allOf": [ { "properties": { "data": { "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "properties": { "last_online": { "description": "Last Online Date ISO8601 format", "type": "string" }, "friends_since": { "description": "Friends Since Date ISO8601 format", "type": "string" } }, "type": "object" } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "user_clubs": { "description": "User Clubs", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "name": { "description": "Club Name", "type": "string" }, "url": { "description": "Club URL", "type": "string" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "watch_episodes": { "description": "Watch Episodes", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "entry": { "$ref": "#/components/schemas/anime_meta" }, "episodes": { "description": "Recent Episodes (max 2 listed)", "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "title": { "description": "Episode Title", "type": "string" }, "premium": { "description": "For MyAnimeList Premium Users", "type": "boolean" } }, "type": "object" } }, "region_locked": { "description": "Region Locked Episode", "type": "boolean" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "watch_promos": { "description": "Watch Promos", "allOf": [ { "$ref": "#/components/schemas/pagination" }, { "allOf": [ { "properties": { "title": { "description": "Promo Title", "type": "string" } }, "type": "object" }, { "properties": { "data": { "type": "array", "items": { "properties": { "entry": { "$ref": "#/components/schemas/anime_meta" }, "trailer": { "type": "array", "items": { "$ref": "#/components/schemas/trailer" } } }, "type": "object" } } }, "type": "object" } ] } ] }, "anime_characters": { "description": "Anime Characters Resource", "properties": { "data": { "type": "array", "items": { "properties": { "character": { "description": "Character details", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/character_images" }, "name": { "description": "Character Name", "type": "string" } }, "type": "object" }, "role": { "description": "Character's Role", "type": "string" }, "voice_actors": { "type": "array", "items": { "properties": { "person": { "properties": { "mal_id": { "type": "integer" }, "url": { "type": "string" }, "images": { "$ref": "#/components/schemas/people_images" }, "name": { "type": "string" } }, "type": "object" }, "language": { "type": "string" } }, "type": "object" } } }, "type": "object" } } }, "type": "object" }, "anime_search": { "description": "Anime Collection Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/anime" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination_plus" } ] }, "anime_episode": { "description": "Anime Episode Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "title": { "description": "Title", "type": "string" }, "title_japanese": { "description": "Title Japanese", "type": "string", "nullable": true }, "title_romanji": { "description": "title_romanji", "type": "string", "nullable": true }, "duration": { "description": "Episode duration in seconds", "type": "integer", "nullable": true }, "aired": { "description": "Aired Date ISO8601", "type": "string", "nullable": true }, "filler": { "description": "Filler episode", "type": "boolean" }, "recap": { "description": "Recap episode", "type": "boolean" }, "synopsis": { "description": "Episode Synopsis", "type": "string", "nullable": true } }, "type": "object" }, "anime_full": { "description": "Full anime Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/anime_images" }, "trailer": { "$ref": "#/components/schemas/trailer_base" }, "approved": { "description": "Whether the entry is pending approval on MAL or not", "type": "boolean" }, "titles": { "description": "All titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "title": { "description": "Title", "type": "string", "deprecated": true }, "title_english": { "description": "English Title", "type": "string", "nullable": true, "deprecated": true }, "title_japanese": { "description": "Japanese Title", "type": "string", "nullable": true, "deprecated": true }, "title_synonyms": { "description": "Other Titles", "type": "array", "items": { "type": "string" }, "deprecated": true }, "type": { "description": "Anime Type", "type": "string", "enum": [ "TV", "OVA", "Movie", "Special", "ONA", "Music" ], "nullable": true }, "source": { "description": "Original Material/Source adapted from", "type": "string", "nullable": true }, "episodes": { "description": "Episode count", "type": "integer", "nullable": true }, "status": { "description": "Airing status", "type": "string", "enum": [ "Finished Airing", "Currently Airing", "Not yet aired" ], "nullable": true }, "airing": { "description": "Airing boolean", "type": "boolean" }, "aired": { "$ref": "#/components/schemas/daterange" }, "duration": { "description": "Parsed raw duration", "type": "string", "nullable": true }, "rating": { "description": "Anime audience rating", "type": "string", "enum": [ "G - All Ages", "PG - Children", "PG-13 - Teens 13 or older", "R - 17+ (violence & profanity)", "R+ - Mild Nudity", "Rx - Hentai" ], "nullable": true }, "score": { "description": "Score", "type": "number", "format": "float", "nullable": true }, "scored_by": { "description": "Number of users", "type": "integer", "nullable": true }, "rank": { "description": "Ranking", "type": "integer", "nullable": true }, "popularity": { "description": "Popularity", "type": "integer", "nullable": true }, "members": { "description": "Number of users who have added this entry to their list", "type": "integer", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer", "nullable": true }, "synopsis": { "description": "Synopsis", "type": "string", "nullable": true }, "background": { "description": "Background", "type": "string", "nullable": true }, "season": { "description": "Season", "type": "string", "enum": [ "summer", "winter", "spring", "fall" ], "nullable": true }, "year": { "description": "Year", "type": "integer", "nullable": true }, "broadcast": { "$ref": "#/components/schemas/broadcast" }, "producers": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "licensors": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "studios": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "explicit_genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "themes": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "demographics": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "relations": { "type": "array", "items": { "properties": { "relation": { "description": "Relation type", "type": "string" }, "entry": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" } }, "theme": { "properties": { "openings": { "type": "array", "items": { "type": "string" } }, "endings": { "type": "array", "items": { "type": "string" } } }, "type": "object" }, "external": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } }, "streaming": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "anime_relations": { "description": "Anime Relations", "properties": { "data": { "type": "array", "items": { "properties": { "relation": { "description": "Relation type", "type": "string" }, "entry": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" } } }, "type": "object" }, "anime": { "description": "Anime Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/anime_images" }, "trailer": { "$ref": "#/components/schemas/trailer_base" }, "approved": { "description": "Whether the entry is pending approval on MAL or not", "type": "boolean" }, "titles": { "description": "All titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "title": { "description": "Title", "type": "string", "deprecated": true }, "title_english": { "description": "English Title", "type": "string", "nullable": true, "deprecated": true }, "title_japanese": { "description": "Japanese Title", "type": "string", "nullable": true, "deprecated": true }, "title_synonyms": { "description": "Other Titles", "type": "array", "items": { "type": "string" }, "deprecated": true }, "type": { "description": "Anime Type", "type": "string", "enum": [ "TV", "OVA", "Movie", "Special", "ONA", "Music" ], "nullable": true }, "source": { "description": "Original Material/Source adapted from", "type": "string", "nullable": true }, "episodes": { "description": "Episode count", "type": "integer", "nullable": true }, "status": { "description": "Airing status", "type": "string", "enum": [ "Finished Airing", "Currently Airing", "Not yet aired" ], "nullable": true }, "airing": { "description": "Airing boolean", "type": "boolean" }, "aired": { "$ref": "#/components/schemas/daterange" }, "duration": { "description": "Parsed raw duration", "type": "string", "nullable": true }, "rating": { "description": "Anime audience rating", "type": "string", "enum": [ "G - All Ages", "PG - Children", "PG-13 - Teens 13 or older", "R - 17+ (violence & profanity)", "R+ - Mild Nudity", "Rx - Hentai" ], "nullable": true }, "score": { "description": "Score", "type": "number", "format": "float", "nullable": true }, "scored_by": { "description": "Number of users", "type": "integer", "nullable": true }, "rank": { "description": "Ranking", "type": "integer", "nullable": true }, "popularity": { "description": "Popularity", "type": "integer", "nullable": true }, "members": { "description": "Number of users who have added this entry to their list", "type": "integer", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer", "nullable": true }, "synopsis": { "description": "Synopsis", "type": "string", "nullable": true }, "background": { "description": "Background", "type": "string", "nullable": true }, "season": { "description": "Season", "type": "string", "enum": [ "summer", "winter", "spring", "fall" ], "nullable": true }, "year": { "description": "Year", "type": "integer", "nullable": true }, "broadcast": { "$ref": "#/components/schemas/broadcast" }, "producers": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "licensors": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "studios": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "explicit_genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "themes": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "demographics": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" }, "anime_staff": { "description": "Anime Staff Resource", "properties": { "data": { "type": "array", "items": { "properties": { "person": { "description": "Person details", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/people_images" }, "name": { "description": "Name", "type": "string" } }, "type": "object" }, "positions": { "description": "Staff Positions", "type": "array", "items": { "type": "string" } } }, "type": "object" } } }, "type": "object" }, "anime_statistics": { "description": "Anime Statistics Resource", "properties": { "data": { "properties": { "watching": { "description": "Number of users watching the resource", "type": "integer" }, "completed": { "description": "Number of users who have completed the resource", "type": "integer" }, "on_hold": { "description": "Number of users who have put the resource on hold", "type": "integer" }, "dropped": { "description": "Number of users who have dropped the resource", "type": "integer" }, "plan_to_watch": { "description": "Number of users who have planned to watch the resource", "type": "integer" }, "total": { "description": "Total number of users who have the resource added to their lists", "type": "integer" }, "scores": { "type": "array", "items": { "properties": { "score": { "description": "Scoring value", "type": "integer" }, "votes": { "description": "Number of votes for this score", "type": "integer" }, "percentage": { "description": "Percentage of votes for this score", "type": "number", "format": "float" } }, "type": "object" } } }, "type": "object" } }, "type": "object" }, "anime_themes": { "description": "Anime Opening and Ending Themes", "properties": { "data": { "properties": { "openings": { "type": "array", "items": { "type": "string" } }, "endings": { "type": "array", "items": { "type": "string" } } }, "type": "object" } }, "type": "object" }, "anime_videos": { "description": "Anime Videos Resource", "properties": { "data": { "properties": { "promo": { "type": "array", "items": { "properties": { "title": { "description": "Title", "type": "string" }, "trailer": { "$ref": "#/components/schemas/trailer" } }, "type": "object" } }, "episodes": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "title": { "description": "Title", "type": "string" }, "episode": { "description": "Episode", "type": "string" }, "images": { "$ref": "#/components/schemas/common_images" } }, "type": "object" } }, "music_videos": { "type": "array", "items": { "properties": { "title": { "description": "Title", "type": "string" }, "video": { "$ref": "#/components/schemas/trailer" }, "meta": { "properties": { "title": { "type": "string", "nullable": true }, "author": { "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" } } }, "type": "object" } }, "type": "object" }, "character_anime": { "description": "Character casted in anime", "properties": { "data": { "type": "array", "items": { "properties": { "role": { "description": "Character's Role", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" } } }, "type": "object" }, "characters_search": { "description": "Characters Search Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/character" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination_plus" } ] }, "character_full": { "description": "Character Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/character_images" }, "name": { "description": "Name", "type": "string" }, "name_kanji": { "description": "Name", "type": "string", "nullable": true }, "nicknames": { "description": "Other Names", "type": "array", "items": { "type": "string" } }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer" }, "about": { "description": "Biography", "type": "string", "nullable": true }, "anime": { "type": "array", "items": { "properties": { "role": { "description": "Character's Role", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" } }, "manga": { "type": "array", "items": { "properties": { "role": { "description": "Character's Role", "type": "string" }, "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" } }, "voices": { "type": "array", "items": { "properties": { "language": { "description": "Character's Role", "type": "string" }, "person": { "$ref": "#/components/schemas/person_meta" } }, "type": "object" } } }, "type": "object" }, "character_manga": { "description": "Character casted in manga", "properties": { "data": { "type": "array", "items": { "properties": { "role": { "description": "Character's Role", "type": "string" }, "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" } } }, "type": "object" }, "character": { "description": "Character Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/character_images" }, "name": { "description": "Name", "type": "string" }, "name_kanji": { "description": "Name", "type": "string", "nullable": true }, "nicknames": { "description": "Other Names", "type": "array", "items": { "type": "string" } }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer" }, "about": { "description": "Biography", "type": "string", "nullable": true } }, "type": "object" }, "character_voice_actors": { "description": "Character voice actors", "properties": { "data": { "type": "array", "items": { "properties": { "language": { "description": "Character's Role", "type": "string" }, "person": { "$ref": "#/components/schemas/person_meta" } }, "type": "object" } } }, "type": "object" }, "clubs_search": { "description": "Clubs Search Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/club" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "club_relations": { "description": "Club Relations", "properties": { "data": { "properties": { "anime": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "manga": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "characters": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" } }, "type": "object" }, "club": { "description": "Club Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "name": { "description": "Club name", "type": "string" }, "url": { "description": "Club URL", "type": "string" }, "images": { "$ref": "#/components/schemas/common_images" }, "members": { "description": "Number of club members", "type": "integer" }, "category": { "description": "Club Category", "type": "string", "enum": [ "actors & artists", "anime", "characters", "cities & neighborhoods", "companies", "conventions", "games", "japan", "manga", "music", "others", "schools" ] }, "created": { "description": "Date Created ISO8601", "type": "string" }, "access": { "description": "Club access", "type": "string", "enum": [ "public", "private", "secret" ] } }, "type": "object" }, "club_staff": { "description": "Club Staff Resource", "properties": { "data": { "type": "array", "items": { "properties": { "url": { "description": "User URL", "type": "string" }, "username": { "description": "User's username", "type": "string" } }, "type": "object" } } }, "type": "object" }, "trailer": { "description": "Youtube Details", "type": "object", "allOf": [ { "$ref": "#/components/schemas/trailer_base" }, { "$ref": "#/components/schemas/trailer_images" } ] }, "trailer_base": { "description": "Youtube Details", "properties": { "youtube_id": { "description": "YouTube ID", "type": "string", "nullable": true }, "url": { "description": "YouTube URL", "type": "string", "nullable": true }, "embed_url": { "description": "Parsed Embed URL", "type": "string", "nullable": true } }, "type": "object" }, "trailer_images": { "description": "Youtube Images", "properties": { "images": { "properties": { "image_url": { "description": "Default Image Size URL (120x90)", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image Size URL (640x480)", "type": "string", "nullable": true }, "medium_image_url": { "description": "Medium Image Size URL (320x180)", "type": "string", "nullable": true }, "large_image_url": { "description": "Large Image Size URL (480x360)", "type": "string", "nullable": true }, "maximum_image_url": { "description": "Maximum Image Size URL (1280x720)", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "daterange": { "description": "Date range", "properties": { "from": { "description": "Date ISO8601", "type": "string", "nullable": true }, "to": { "description": "Date ISO8601", "type": "string", "nullable": true }, "prop": { "description": "Date Prop", "properties": { "from": { "description": "Date Prop From", "properties": { "day": { "description": "Day", "type": "integer", "nullable": true }, "month": { "description": "Month", "type": "integer", "nullable": true }, "year": { "description": "Year", "type": "integer", "nullable": true } }, "type": "object" }, "to": { "description": "Date Prop To", "properties": { "day": { "description": "Day", "type": "integer", "nullable": true }, "month": { "description": "Month", "type": "integer", "nullable": true }, "year": { "description": "Year", "type": "integer", "nullable": true } }, "type": "object" }, "string": { "description": "Raw parsed string", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "broadcast": { "description": "Broadcast Details", "properties": { "day": { "description": "Day of the week", "type": "string", "nullable": true }, "time": { "description": "Time in 24 hour format", "type": "string", "nullable": true }, "timezone": { "description": "Timezone (Tz Database format https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)", "type": "string", "nullable": true }, "string": { "description": "Raw parsed broadcast string", "type": "string", "nullable": true } }, "type": "object" }, "mal_url": { "description": "Parsed URL Data", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "type": { "description": "Type of resource", "type": "string" }, "name": { "description": "Resource Name/Title", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" } }, "type": "object" }, "mal_url_2": { "description": "Parsed URL Data", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "type": { "description": "Type of resource", "type": "string" }, "title": { "description": "Resource Name/Title", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" } }, "type": "object" }, "entry_meta": { "description": "Entry Meta data", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "image_url": { "description": "Image URL", "type": "string" }, "name": { "description": "Entry Name/Title", "type": "string" } }, "type": "object" }, "relation": { "description": "Related resources", "properties": { "relation": { "description": "Relation type", "type": "string" }, "entry": { "description": "Related entries", "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" }, "pagination": { "properties": { "pagination": { "properties": { "last_visible_page": { "type": "integer" }, "has_next_page": { "type": "boolean" } }, "type": "object" } }, "type": "object" }, "pagination_plus": { "properties": { "pagination": { "properties": { "last_visible_page": { "type": "integer" }, "has_next_page": { "type": "boolean" }, "items": { "properties": { "count": { "type": "integer" }, "total": { "type": "integer" }, "per_page": { "type": "integer" } }, "type": "object" } }, "type": "object" } }, "type": "object" }, "user_meta": { "properties": { "username": { "description": "MyAnimeList Username", "type": "string" }, "url": { "description": "MyAnimeList Profile URL", "type": "string" }, "images": { "$ref": "#/components/schemas/user_images" } }, "type": "object" }, "user_by_id": { "description": "User Meta By ID", "properties": { "url": { "description": "MyAnimeList URL", "type": "string" }, "username": { "description": "MyAnimeList Username", "type": "string" } }, "type": "object" }, "user_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true } }, "type": "object" }, "webp": { "description": "Available images in WEBP", "properties": { "image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "anime_meta": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/anime_images" }, "title": { "description": "Entry title", "type": "string" } }, "type": "object" }, "manga_meta": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/manga_images" }, "title": { "description": "Entry title", "type": "string" } }, "type": "object" }, "character_meta": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/character_images" }, "name": { "description": "Entry name", "type": "string" } }, "type": "object" }, "person_meta": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/people_images" }, "name": { "description": "Entry name", "type": "string" } }, "type": "object" }, "anime_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL JPG", "type": "string", "nullable": true }, "large_image_url": { "description": "Image URL JPG", "type": "string", "nullable": true } }, "type": "object" }, "webp": { "description": "Available images in WEBP", "properties": { "image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL WEBP", "type": "string", "nullable": true }, "large_image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "manga_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL JPG", "type": "string", "nullable": true }, "large_image_url": { "description": "Image URL JPG", "type": "string", "nullable": true } }, "type": "object" }, "webp": { "description": "Available images in WEBP", "properties": { "image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL WEBP", "type": "string", "nullable": true }, "large_image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "character_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL JPG", "type": "string", "nullable": true } }, "type": "object" }, "webp": { "description": "Available images in WEBP", "properties": { "image_url": { "description": "Image URL WEBP", "type": "string", "nullable": true }, "small_image_url": { "description": "Small Image URL WEBP", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "people_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "common_images": { "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "title": { "properties": { "type": { "description": "Title type", "type": "string" }, "title": { "description": "Title value", "type": "string" } }, "type": "object" }, "external_links": { "description": "External links", "properties": { "data": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "forum": { "description": "Forum Resource", "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "title": { "description": "Title", "type": "string" }, "date": { "description": "Post Date ISO8601", "type": "string" }, "author_username": { "description": "Author MyAnimeList Username", "type": "string" }, "author_url": { "description": "Author Profile URL", "type": "string" }, "comments": { "description": "Comment count", "type": "integer" }, "last_comment": { "description": "Last comment details", "properties": { "url": { "description": "Last comment URL", "type": "string" }, "author_username": { "description": "Author MyAnimeList Username", "type": "string" }, "author_url": { "description": "Author Profile URL", "type": "string" }, "date": { "description": "Last comment date posted ISO8601", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" } } }, "type": "object" }, "genres": { "description": "Genres Collection Resource", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/genre" } } }, "type": "object" }, "genre": { "description": "Genre Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "name": { "description": "Genre Name", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "count": { "description": "Genre's entry count", "type": "integer" } }, "type": "object" }, "magazines": { "description": "Magazine Collection Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/magazine" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "magazine": { "description": "Magazine Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "name": { "description": "Magazine Name", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "count": { "description": "Magazine's manga count", "type": "integer" } }, "type": "object" }, "manga_characters": { "description": "Manga Characters Resource", "properties": { "data": { "type": "array", "items": { "properties": { "character": { "$ref": "#/components/schemas/character_meta" }, "role": { "description": "Character's Role", "type": "string" } }, "type": "object" } } }, "type": "object" }, "manga_search": { "description": "Manga Search Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/manga" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination_plus" } ] }, "manga_full": { "description": "Manga Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/manga_images" }, "approved": { "description": "Whether the entry is pending approval on MAL or not", "type": "boolean" }, "titles": { "description": "All Titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "title": { "description": "Title", "type": "string", "deprecated": true }, "title_english": { "description": "English Title", "type": "string", "nullable": true, "deprecated": true }, "title_japanese": { "description": "Japanese Title", "type": "string", "nullable": true, "deprecated": true }, "title_synonyms": { "description": "Other Titles", "type": "array", "items": { "type": "string" }, "deprecated": true }, "type": { "description": "Manga Type", "type": "string", "enum": [ "Manga", "Novel", "Light Novel", "One-shot", "Doujinshi", "Manhua", "Manhwa", "OEL" ], "nullable": true }, "chapters": { "description": "Chapter count", "type": "integer", "nullable": true }, "volumes": { "description": "Volume count", "type": "integer", "nullable": true }, "status": { "description": "Publishing status", "type": "string", "enum": [ "Finished", "Publishing", "On Hiatus", "Discontinued", "Not yet published" ] }, "publishing": { "description": "Publishing boolean", "type": "boolean" }, "published": { "$ref": "#/components/schemas/daterange" }, "score": { "description": "Score", "type": "number", "format": "float", "nullable": true }, "scored_by": { "description": "Number of users", "type": "integer", "nullable": true }, "rank": { "description": "Ranking", "type": "integer", "nullable": true }, "popularity": { "description": "Popularity", "type": "integer", "nullable": true }, "members": { "description": "Number of users who have added this entry to their list", "type": "integer", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer", "nullable": true }, "synopsis": { "description": "Synopsis", "type": "string", "nullable": true }, "background": { "description": "Background", "type": "string", "nullable": true }, "authors": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "serializations": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "explicit_genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "themes": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "demographics": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "relations": { "type": "array", "items": { "properties": { "relation": { "description": "Relation type", "type": "string" }, "entry": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" } }, "external": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "manga": { "description": "Manga Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/manga_images" }, "approved": { "description": "Whether the entry is pending approval on MAL or not", "type": "boolean" }, "titles": { "description": "All Titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "title": { "description": "Title", "type": "string", "deprecated": true }, "title_english": { "description": "English Title", "type": "string", "nullable": true, "deprecated": true }, "title_japanese": { "description": "Japanese Title", "type": "string", "nullable": true, "deprecated": true }, "type": { "description": "Manga Type", "type": "string", "enum": [ "Manga", "Novel", "Light Novel", "One-shot", "Doujinshi", "Manhua", "Manhwa", "OEL" ], "nullable": true }, "chapters": { "description": "Chapter count", "type": "integer", "nullable": true }, "volumes": { "description": "Volume count", "type": "integer", "nullable": true }, "status": { "description": "Publishing status", "type": "string", "enum": [ "Finished", "Publishing", "On Hiatus", "Discontinued", "Not yet published" ] }, "publishing": { "description": "Publishing boolean", "type": "boolean" }, "published": { "$ref": "#/components/schemas/daterange" }, "score": { "description": "Score", "type": "number", "format": "float", "nullable": true }, "scored_by": { "description": "Number of users", "type": "integer", "nullable": true }, "rank": { "description": "Ranking", "type": "integer", "nullable": true }, "popularity": { "description": "Popularity", "type": "integer", "nullable": true }, "members": { "description": "Number of users who have added this entry to their list", "type": "integer", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer", "nullable": true }, "synopsis": { "description": "Synopsis", "type": "string", "nullable": true }, "background": { "description": "Background", "type": "string", "nullable": true }, "authors": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "serializations": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "explicit_genres": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "themes": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } }, "demographics": { "type": "array", "items": { "$ref": "#/components/schemas/mal_url" } } }, "type": "object" }, "manga_statistics": { "description": "Manga Statistics Resource", "properties": { "data": { "properties": { "reading": { "description": "Number of users reading the resource", "type": "integer" }, "completed": { "description": "Number of users who have completed the resource", "type": "integer" }, "on_hold": { "description": "Number of users who have put the resource on hold", "type": "integer" }, "dropped": { "description": "Number of users who have dropped the resource", "type": "integer" }, "plan_to_read": { "description": "Number of users who have planned to read the resource", "type": "integer" }, "total": { "description": "Total number of users who have the resource added to their lists", "type": "integer" }, "scores": { "type": "array", "items": { "properties": { "score": { "description": "Scoring value", "type": "integer" }, "votes": { "description": "Number of votes for this score", "type": "integer" }, "percentage": { "description": "Percentage of votes for this score", "type": "number", "format": "float" } }, "type": "object" } } }, "type": "object" } }, "type": "object" }, "moreinfo": { "description": "More Info Resource", "properties": { "data": { "properties": { "moreinfo": { "description": "Additional information on the entry", "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" }, "news": { "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "title": { "description": "Title", "type": "string" }, "date": { "description": "Post Date ISO8601", "type": "string" }, "author_username": { "description": "Author MyAnimeList Username", "type": "string" }, "author_url": { "description": "Author Profile URL", "type": "string" }, "forum_url": { "description": "Forum topic URL", "type": "string" }, "images": { "$ref": "#/components/schemas/common_images" }, "comments": { "description": "Comment count", "type": "integer" }, "excerpt": { "description": "Excerpt", "type": "string" } }, "type": "object" } } }, "type": "object" }, "person_anime": { "description": "Person anime staff positions", "properties": { "data": { "type": "array", "items": { "properties": { "position": { "description": "Person's position", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" } } }, "type": "object" }, "people_search": { "description": "People Search", "allOf": [ { "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/person" } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination_plus" } ] }, "person_full": { "description": "Person Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "website_url": { "description": "Person's website URL", "type": "string", "nullable": true }, "images": { "$ref": "#/components/schemas/people_images" }, "name": { "description": "Name", "type": "string" }, "given_name": { "description": "Given Name", "type": "string", "nullable": true }, "family_name": { "description": "Family Name", "type": "string", "nullable": true }, "alternate_names": { "description": "Other Names", "type": "array", "items": { "type": "string" } }, "birthday": { "description": "Birthday Date ISO8601", "type": "string", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer" }, "about": { "description": "Biography", "type": "string", "nullable": true }, "anime": { "type": "array", "items": { "properties": { "position": { "description": "Person's position", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" } }, "manga": { "type": "array", "items": { "properties": { "position": { "description": "Person's position", "type": "string" }, "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" } }, "voices": { "type": "array", "items": { "properties": { "role": { "description": "Person's Character's role in the anime", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" }, "character": { "$ref": "#/components/schemas/character_meta" } }, "type": "object" } } }, "type": "object" }, "person_manga": { "description": "Person's mangaography", "properties": { "data": { "type": "array", "items": { "properties": { "position": { "description": "Person's position", "type": "string" }, "manga": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" } } }, "type": "object" }, "person": { "description": "Person Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "website_url": { "description": "Person's website URL", "type": "string", "nullable": true }, "images": { "$ref": "#/components/schemas/people_images" }, "name": { "description": "Name", "type": "string" }, "given_name": { "description": "Given Name", "type": "string", "nullable": true }, "family_name": { "description": "Family Name", "type": "string", "nullable": true }, "alternate_names": { "description": "Other Names", "type": "array", "items": { "type": "string" } }, "birthday": { "description": "Birthday Date ISO8601", "type": "string", "nullable": true }, "favorites": { "description": "Number of users who have favorited this entry", "type": "integer" }, "about": { "description": "Biography", "type": "string", "nullable": true } }, "type": "object" }, "person_voice_acting_roles": { "description": "Person's voice acting roles", "properties": { "data": { "type": "array", "items": { "properties": { "role": { "description": "Person's Character's role in the anime", "type": "string" }, "anime": { "$ref": "#/components/schemas/anime_meta" }, "character": { "$ref": "#/components/schemas/character_meta" } }, "type": "object" } } }, "type": "object" }, "pictures": { "description": "Pictures Resource", "properties": { "data": { "type": "array", "items": { "properties": { "images": { "$ref": "#/components/schemas/anime_images" } }, "type": "object" } } }, "type": "object" }, "pictures_variants": { "description": "Pictures Resource", "properties": { "data": { "type": "array", "items": { "properties": { "images": { "$ref": "#/components/schemas/common_images" } }, "type": "object" } } }, "type": "object" }, "producers": { "description": "Producers Collection Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/producer" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "producer_full": { "description": "Producers Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "titles": { "description": "All titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "images": { "$ref": "#/components/schemas/common_images" }, "favorites": { "description": "Producers's member favorites count", "type": "integer" }, "count": { "description": "Producers's anime count", "type": "integer" }, "established": { "description": "Established Date ISO8601", "type": "string", "nullable": true }, "about": { "description": "About the Producer", "type": "string", "nullable": true }, "external": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "producer": { "description": "Producers Resource", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "titles": { "description": "All titles", "type": "array", "items": { "$ref": "#/components/schemas/title" } }, "images": { "$ref": "#/components/schemas/common_images" }, "favorites": { "description": "Producers's member favorites count", "type": "integer" }, "count": { "description": "Producers's anime count", "type": "integer" }, "established": { "description": "Established Date ISO8601", "type": "string", "nullable": true }, "about": { "description": "About the Producer", "type": "string", "nullable": true } }, "type": "object" }, "user_about": { "properties": { "data": { "type": "array", "items": { "properties": { "about": { "description": "User About. NOTE: About information is customizable by users through BBCode on MyAnimeList. This means users can add multimedia content, different text sizes, etc. Due to this freeform, Jikan returns parsed HTML. Validate on your end!", "type": "string", "nullable": true } }, "type": "object" } } }, "type": "object" }, "user_favorites": { "properties": { "anime": { "description": "Favorite Anime", "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "type": { "type": "string" }, "start_year": { "type": "integer" } }, "type": "object" }, { "$ref": "#/components/schemas/anime_meta" } ] } }, "manga": { "description": "Favorite Manga", "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "type": { "type": "string" }, "start_year": { "type": "integer" } }, "type": "object" }, { "$ref": "#/components/schemas/manga_meta" } ] } }, "characters": { "description": "Favorite Characters", "type": "array", "items": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/character_meta" }, { "$ref": "#/components/schemas/mal_url_2" } ] } }, "people": { "description": "Favorite People", "type": "array", "items": { "$ref": "#/components/schemas/character_meta" } } }, "type": "object" }, "user_profile_full": { "description": "Transform the resource into an array.", "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer", "nullable": true }, "username": { "description": "MyAnimeList Username", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/user_images" }, "last_online": { "description": "Last Online Date ISO8601", "type": "string", "nullable": true }, "gender": { "description": "User Gender", "type": "string", "nullable": true }, "birthday": { "description": "Birthday Date ISO8601", "type": "string", "nullable": true }, "location": { "description": "Location", "type": "string", "nullable": true }, "joined": { "description": "Joined Date ISO8601", "type": "string", "nullable": true }, "statistics": { "properties": { "anime": { "description": "Anime Statistics", "properties": { "days_watched": { "description": "Number of days spent watching Anime", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "watching": { "description": "Anime Watching", "type": "integer" }, "completed": { "description": "Anime Completed", "type": "integer" }, "on_hold": { "description": "Anime On-Hold", "type": "integer" }, "dropped": { "description": "Anime Dropped", "type": "integer" }, "plan_to_watch": { "description": "Anime Planned to Watch", "type": "integer" }, "total_entries": { "description": "Total Anime entries on User list", "type": "integer" }, "rewatched": { "description": "Anime re-watched", "type": "integer" }, "episodes_watched": { "description": "Number of Anime Episodes Watched", "type": "integer" } }, "type": "object" }, "manga": { "description": "Manga Statistics", "properties": { "days_read": { "description": "Number of days spent reading Manga", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "reading": { "description": "Manga Reading", "type": "integer" }, "completed": { "description": "Manga Completed", "type": "integer" }, "on_hold": { "description": "Manga On-Hold", "type": "integer" }, "dropped": { "description": "Manga Dropped", "type": "integer" }, "plan_to_read": { "description": "Manga Planned to Read", "type": "integer" }, "total_entries": { "description": "Total Manga entries on User list", "type": "integer" }, "reread": { "description": "Manga re-read", "type": "integer" }, "chapters_read": { "description": "Number of Manga Chapters Read", "type": "integer" }, "volumes_read": { "description": "Number of Manga Volumes Read", "type": "integer" } }, "type": "object" } }, "type": "object" }, "external": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "user_history": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/history" } } }, "type": "object" }, "history": { "description": "Transform the resource into an array.", "properties": { "entry": { "$ref": "#/components/schemas/mal_url" }, "increment": { "description": "Number of episodes/chapters watched/read", "type": "integer" }, "date": { "description": "Date ISO8601", "type": "string" } }, "type": "object" }, "user_updates": { "properties": { "data": { "properties": { "anime": { "description": "Last updated Anime", "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "entry": { "$ref": "#/components/schemas/anime_meta" } }, "type": "object" }, { "properties": { "score": { "type": "integer", "nullable": true }, "status": { "type": "string" }, "episodes_seen": { "type": "integer", "nullable": true }, "episodes_total": { "type": "integer", "nullable": true }, "date": { "description": "ISO8601 format", "type": "string" } }, "type": "object" } ] } }, "manga": { "description": "Last updated Manga", "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "entry": { "$ref": "#/components/schemas/manga_meta" } }, "type": "object" }, { "properties": { "score": { "type": "integer", "nullable": true }, "status": { "type": "string" }, "chapters_read": { "type": "integer", "nullable": true }, "chapters_total": { "type": "integer", "nullable": true }, "volumes_read": { "type": "integer", "nullable": true }, "volumes_total": { "type": "integer", "nullable": true }, "date": { "description": "ISO8601 format", "type": "string" } }, "type": "object" } ] } } }, "type": "object" } }, "type": "object" }, "user_profile": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer", "nullable": true }, "username": { "description": "MyAnimeList Username", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "$ref": "#/components/schemas/user_images" }, "last_online": { "description": "Last Online Date ISO8601", "type": "string", "nullable": true }, "gender": { "description": "User Gender", "type": "string", "nullable": true }, "birthday": { "description": "Birthday Date ISO8601", "type": "string", "nullable": true }, "location": { "description": "Location", "type": "string", "nullable": true }, "joined": { "description": "Joined Date ISO8601", "type": "string", "nullable": true } }, "type": "object" }, "users_temp": { "description": "Transform the resource into an array.", "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "username": { "description": "MyAnimeList Username", "type": "string" }, "url": { "description": "MyAnimeList URL", "type": "string" }, "images": { "description": "Images", "properties": { "jpg": { "description": "Available images in JPG", "properties": { "image_url": { "description": "Image URL JPG (225x335)", "type": "string" } }, "type": "object" }, "webp": { "description": "Available images in WEBP", "properties": { "image_url": { "description": "Image URL WEBP (225x335)", "type": "string" } }, "type": "object" } }, "type": "object" }, "last_online": { "description": "Last Online Date ISO8601", "type": "string" }, "gender": { "description": "User Gender", "type": "string" }, "birthday": { "description": "Birthday Date ISO8601", "type": "string" }, "location": { "description": "Location", "type": "string" }, "joined": { "description": "Joined Date ISO8601", "type": "string" }, "anime_stats": { "description": "Anime Stats", "properties": { "days_watched": { "description": "Number of days spent watching Anime", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "watching": { "description": "Anime Watching", "type": "integer" }, "completed": { "description": "Anime Completed", "type": "integer" }, "on_hold": { "description": "Anime On-Hold", "type": "integer" }, "dropped": { "description": "Anime Dropped", "type": "integer" }, "plan_to_watch": { "description": "Anime Planned to Watch", "type": "integer" }, "total_entries": { "description": "Total Anime entries on User list", "type": "integer" }, "rewatched": { "description": "Anime re-watched", "type": "integer" }, "episodes_watched": { "description": "Number of Anime Episodes Watched", "type": "integer" } }, "type": "object" }, "manga_stats": { "description": "Manga Stats", "properties": { "days_read": { "description": "Number of days spent reading Manga", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "reading": { "description": "Manga Reading", "type": "integer" }, "completed": { "description": "Manga Completed", "type": "integer" }, "on_hold": { "description": "Manga On-Hold", "type": "integer" }, "dropped": { "description": "Manga Dropped", "type": "integer" }, "plan_to_read": { "description": "Manga Planned to Read", "type": "integer" }, "total_entries": { "description": "Total Manga entries on User list", "type": "integer" }, "reread": { "description": "Manga re-read", "type": "integer" }, "chapters_read": { "description": "Number of Manga Chapters Read", "type": "integer" }, "volumes_read": { "description": "Number of Manga Volumes Read", "type": "integer" } }, "type": "object" }, "favorites": { "description": "Favorite entries", "properties": { "anime": { "description": "Favorite Anime", "type": "array", "items": { "$ref": "#/components/schemas/entry_meta" } }, "manga": { "description": "Favorite Manga", "type": "array", "items": { "$ref": "#/components/schemas/entry_meta" } }, "characters": { "description": "Favorite Characters", "type": "array", "items": { "$ref": "#/components/schemas/entry_meta" } }, "people": { "description": "Favorite People", "type": "array", "items": { "$ref": "#/components/schemas/entry_meta" } } }, "type": "object" }, "about": { "description": "User About. NOTE: About information is customizable by users through BBCode on MyAnimeList. This means users can add multimedia content, different text sizes, etc. Due to this freeform, Jikan returns parsed HTML. Validate on your end!", "type": "string" } }, "type": "object" } } }, "type": "object" }, "user_statistics": { "properties": { "data": { "properties": { "anime": { "description": "Anime Statistics", "properties": { "days_watched": { "description": "Number of days spent watching Anime", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "watching": { "description": "Anime Watching", "type": "integer" }, "completed": { "description": "Anime Completed", "type": "integer" }, "on_hold": { "description": "Anime On-Hold", "type": "integer" }, "dropped": { "description": "Anime Dropped", "type": "integer" }, "plan_to_watch": { "description": "Anime Planned to Watch", "type": "integer" }, "total_entries": { "description": "Total Anime entries on User list", "type": "integer" }, "rewatched": { "description": "Anime re-watched", "type": "integer" }, "episodes_watched": { "description": "Number of Anime Episodes Watched", "type": "integer" } }, "type": "object" }, "manga": { "description": "Manga Statistics", "properties": { "days_read": { "description": "Number of days spent reading Manga", "type": "number", "format": "float" }, "mean_score": { "description": "Mean Score", "type": "number", "format": "float" }, "reading": { "description": "Manga Reading", "type": "integer" }, "completed": { "description": "Manga Completed", "type": "integer" }, "on_hold": { "description": "Manga On-Hold", "type": "integer" }, "dropped": { "description": "Manga Dropped", "type": "integer" }, "plan_to_read": { "description": "Manga Planned to Read", "type": "integer" }, "total_entries": { "description": "Total Manga entries on User list", "type": "integer" }, "reread": { "description": "Manga re-read", "type": "integer" }, "chapters_read": { "description": "Number of Manga Chapters Read", "type": "integer" }, "volumes_read": { "description": "Number of Manga Volumes Read", "type": "integer" } }, "type": "object" } }, "type": "object" } }, "type": "object" }, "recommendations": { "description": "Recommendations", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "mal_id": { "description": "MAL IDs of recommendations is both of the MAL ID's with a `-` delimiter", "type": "string" }, "entry": { "description": "Array of 2 entries that are being recommended to each other", "type": "array", "items": { "type": "object", "anyOf": [ { "$ref": "#/components/schemas/anime_meta" }, { "$ref": "#/components/schemas/manga_meta" } ] } }, "content": { "description": "Recommendation context provided by the user", "type": "string" }, "user": { "$ref": "#/components/schemas/user_by_id" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "entry_recommendations": { "description": "Entry Recommendations Resource", "properties": { "data": { "properties": { "url": { "description": "Recommendation MyAnimeList URL", "type": "string" }, "votes": { "description": "Number of users who have recommended this entry", "type": "integer" } }, "type": "array", "items": { "properties": { "entry": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/anime_meta" }, { "$ref": "#/components/schemas/manga_meta" } ] } }, "type": "object" } } }, "type": "object" }, "manga_review": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList review URL", "type": "string" }, "type": { "description": "Entry type", "type": "string" }, "reactions": { "description": "User reaction count on the review", "properties": { "overall": { "description": "Overall reaction count", "type": "integer" }, "nice": { "description": "Nice reaction count", "type": "integer" }, "love_it": { "description": "Love it reaction count", "type": "integer" }, "funny": { "description": "Funny reaction count", "type": "integer" }, "confusing": { "description": "Confusing reaction count", "type": "integer" }, "informative": { "description": "Informative reaction count", "type": "integer" }, "well_written": { "description": "Well written reaction count", "type": "integer" }, "creative": { "description": "Creative reaction count", "type": "integer" } }, "type": "object" }, "date": { "description": "Review created date ISO8601", "type": "string" }, "review": { "description": "Review content", "type": "string" }, "score": { "description": "Number of user votes on the Review", "type": "integer" }, "tags": { "description": "Review tags", "type": "array", "items": { "type": "string" } }, "is_spoiler": { "description": "The review contains spoiler", "type": "boolean" }, "is_preliminary": { "description": "The review was made before the entry was completed", "type": "boolean" } }, "type": "object" }, "anime_review": { "properties": { "mal_id": { "description": "MyAnimeList ID", "type": "integer" }, "url": { "description": "MyAnimeList review URL", "type": "string" }, "type": { "description": "Entry type", "type": "string" }, "reactions": { "description": "User reaction count on the review", "properties": { "overall": { "description": "Overall reaction count", "type": "integer" }, "nice": { "description": "Nice reaction count", "type": "integer" }, "love_it": { "description": "Love it reaction count", "type": "integer" }, "funny": { "description": "Funny reaction count", "type": "integer" }, "confusing": { "description": "Confusing reaction count", "type": "integer" }, "informative": { "description": "Informative reaction count", "type": "integer" }, "well_written": { "description": "Well written reaction count", "type": "integer" }, "creative": { "description": "Creative reaction count", "type": "integer" } }, "type": "object" }, "date": { "description": "Review created date ISO8601", "type": "string" }, "review": { "description": "Review content", "type": "string" }, "score": { "description": "Number of user votes on the Review", "type": "integer" }, "tags": { "description": "Review tags", "type": "array", "items": { "type": "string" } }, "is_spoiler": { "description": "The review contains spoiler", "type": "boolean" }, "is_preliminary": { "description": "The review was made before the entry was completed", "type": "boolean" }, "episodes_watched": { "description": "Number of episodes watched", "type": "integer" } }, "type": "object" }, "anime_reviews": { "description": "Anime Reviews Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/anime_review" } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "manga_reviews": { "description": "Manga Reviews Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "type": "object", "allOf": [ { "properties": { "user": { "$ref": "#/components/schemas/user_meta" } }, "type": "object" }, { "$ref": "#/components/schemas/manga_review" } ] } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "streaming_links": { "description": "Streaming links", "properties": { "data": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } } }, "type": "object" }, "anime_userupdates": { "description": "Anime User Updates Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "user": { "$ref": "#/components/schemas/user_meta" }, "score": { "description": "User Score", "type": "integer", "nullable": true }, "status": { "description": "User list status", "type": "string" }, "episodes_seen": { "description": "Number of episodes seen", "type": "integer", "nullable": true }, "episodes_total": { "description": "Total number of episodes", "type": "integer", "nullable": true }, "date": { "description": "Last updated date ISO8601", "type": "string" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] }, "manga_userupdates": { "description": "Manga User Updates Resource", "allOf": [ { "properties": { "data": { "type": "array", "items": { "properties": { "user": { "$ref": "#/components/schemas/user_meta" }, "score": { "description": "User Score", "type": "integer", "nullable": true }, "status": { "description": "User list status", "type": "string" }, "volumes_read": { "description": "Number of volumes read", "type": "integer" }, "volumes_total": { "description": "Total number of volumes", "type": "integer" }, "chapters_read": { "description": "Number of chapters read", "type": "integer" }, "chapters_total": { "description": "Total number of chapters", "type": "integer" }, "date": { "description": "Last updated date ISO8601", "type": "string" } }, "type": "object" } } }, "type": "object" }, { "$ref": "#/components/schemas/pagination" } ] } }, "responses": { "400": { "description": "Error: Bad request. When required parameters were not supplied." } }, "parameters": { "continuing": { "name": "continuing", "in": "query", "description": "This is a flag. When supplied it will include entries which are continuing from previous seasons. MAL includes these items on the seasons view in the ″TV (continuing)″ section. (Example: https://myanimelist.net/anime/season/2024/winter)
Example usage: `?continuing`", "required": false, "schema": { "type": "boolean" } }, "kids": { "name": "kids", "in": "query", "description": "This is a flag. When supplied it will include entries with the Kids genres in specific endpoints that filter them out by default. You do not need to pass a value to it. e.g usage: `?kids`", "required": false, "schema": { "type": "boolean" } }, "limit": { "name": "limit", "in": "query", "schema": { "type": "integer" } }, "page": { "name": "page", "in": "query", "schema": { "type": "integer" } }, "preliminary": { "name": "preliminary", "in": "query", "description": "Any reviews left during an ongoing anime/manga, those reviews are tagged as preliminary. NOTE: Preliminary reviews are not returned by default so if the entry is airing/publishing you need to add this otherwise you will get an empty list. e.g usage: `?preliminary=true`", "required": false, "schema": { "type": "boolean" } }, "sfw": { "name": "sfw", "in": "query", "description": "'Safe For Work'. This is a flag. When supplied it will filter out entries according to the SFW Policy. You do not need to pass a value to it. e.g usage: `?sfw`", "required": false, "schema": { "type": "boolean" } }, "spoilers": { "name": "spoilers", "in": "query", "description": "Any reviews that are tagged as a spoiler. Spoiler reviews are not returned by default. e.g usage: `?spoiler=true`", "required": false, "schema": { "type": "boolean" } }, "unapproved": { "name": "unapproved", "in": "query", "description": "This is a flag. When supplied it will include entries which are unapproved. Unapproved entries on MyAnimeList are those that are user submitted and have not yet been approved by MAL to show up on other pages. They will have their own specifc pages and are often removed resulting in a 404 error. You do not need to pass a value to it. e.g usage: `?unapproved`", "required": false, "schema": { "type": "boolean" } } } }, "externalDocs": { "description": "About", "url": "https://jikan.moe" } }