04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.

json

{
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 1/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 2/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 3/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 4/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 5/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 6/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
],
"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."
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 7/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"/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
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 8/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
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"
}
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 9/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 10/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 11/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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."
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 12/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"/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"
}
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 13/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 14/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 15/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
],
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 16/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 17/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 18/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 19/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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"
}
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 20/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 21/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 22/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 23/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
}
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 24/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 25/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 26/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 27/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 28/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 29/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 30/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 31/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
],
"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"
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 32/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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"
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 33/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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."
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 34/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"/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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 35/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"$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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 36/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 37/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 38/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 39/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
{
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 40/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
{
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 41/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 42/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
{
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 43/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 44/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"$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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 45/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 46/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 47/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 48/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
{
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 49/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"$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"
]
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 50/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
{
"$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"
],
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 51/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 52/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
{
"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"
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 53/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"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."
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 54/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"/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.",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 55/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 56/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 57/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 58/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 59/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 60/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 61/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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. <a
href='https://docs.google.com/document/d/1-6H-agSnqa8Mfmw802UYfGQrceIEnAaEh4uCXAPiX5A'>Read
more</a>",
"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. <a
href='https://docs.google.com/document/d/1-6H-agSnqa8Mfmw802UYfGQrceIEnAaEh4uCXAPiX5A'>Read
more</a>",
"operationId": "getUserMangaList",
"parameters": [
{
"name": "username",
"in": "path",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 62/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": [
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 63/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 64/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
}
},
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 65/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
],
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 66/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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."
}
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 67/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"/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<br><br><b>Ratings</b><br><ul><li>G -
All Ages</li><li>PG - Children</li><li>PG-13 - Teens 13 or older</li><li>R - 17+ (violence &
profanity)</li><li>R+ - Mild Nudity</li><li>Rx - Hentai</li></ul>",
"type": "string",
"enum": [
"g",
"pg",
"pg13",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 68/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
]
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 69/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 70/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
]
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 71/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 72/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 73/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 74/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
{
"$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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 75/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
}
},
"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"
}
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 76/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 77/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 78/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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"
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"description": "Promo Title",
"type": "string"
},
"entry": {
"$ref": "#/components/schemas/anime_meta"
},
"trailer": {
"$ref": "#/components/schemas/trailer"
}
}
}
}
}
}
]
},
"anime_characters": {
"description": "Anime Characters Resource",
"properties": {
"data": {
"type": "array",
"items": {
"properties": {
"character": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 79/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 80/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 81/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 82/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 83/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 84/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 85/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 86/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 87/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 88/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 89/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 90/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 91/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 92/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 93/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 94/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 95/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 96/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 97/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 98/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 99/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 100/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 101/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
"current_page": {
"type": "integer"
},
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 102/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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"
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 103/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 104/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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
}
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 105/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 106/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 107/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 108/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 109/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 110/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 111/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 112/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 113/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 114/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 115/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 116/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 117/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 118/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 119/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 120/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 121/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 122/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 123/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": [
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 124/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
{
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 125/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 126/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 127/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 128/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 129/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 130/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 131/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 132/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 133/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
}
},
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 134/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 135/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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": {
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 136/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 137/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 138/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 139/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
},
{
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 140/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"$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"
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 141/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
},
{
"$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."
}
},
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 142/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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 &#8243;TV
(continuing)&#8243; section. (Example: https://myanimelist.net/anime/season/2024/winter) <br
/>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`",
https://raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json 143/144
04/07/2025, 21:06 raw.githubusercontent.com/jikan-me/jikan-rest/master/storage/api-docs/api-docs.json
"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"
}
}