⚡ Jikan is powered by its awesome backers - 🙏 Become a backer
Duration | Requests |
---|---|
Daily | Unlimited |
Per Minute | 60 requests |
Per Second | 3 requests |
Note: It's still possible to get rate limited from MyAnimeList.net instead.
null
.score
property whose value does not exist or is undetermined, will be 0
.By CACHING, we refer to the data parsed from MyAnimeList which is stored temporarily on our servers to provide better API performance.
All requests are cached for 24 hours.
The following response headers will detail cache information.
Header | Remarks |
---|---|
Expires |
Cache expiry date |
Last-Modified |
Cache set date |
X-Request-Fingerprint |
Unique request fingerprint (only for cachable requests, not queries) |
Note: X-Request-Fingerprint
will only be available on single resource requests and their child endpoints. e.g /anime/1
, /anime/1/relations
.
They won't be available on pages which perform queries, like /anime, or /top/anime, etc.
Jikan REST API does not provide authenticated requests for MyAnimeList. This means you can not use it to update your anime/manga list. Only GET requests are supported which return READ-ONLY data.
All error responses are accompanied by a JSON Error response.
Exception | HTTP Status | Remarks |
---|---|---|
N/A | 200 - OK |
The request was successful |
N/A | 304 - Not Modified |
You have the latest data (Cache Validation response) |
BadRequestException ,ValidationException |
400 - Bad Request |
You've made an invalid request. Recheck documentation |
BadResponseException |
404 - Not Found |
The resource was not found or MyAnimeList responded with a 404 |
BadRequestException |
405 - Method Not Allowed |
Requested Method is not supported for resource. Only GET requests are allowed |
RateLimitException |
429 - Too Many Request |
You are being rate limited by Jikan or MyAnimeList is rate-limiting our servers (specified in the error response) |
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 |
ServiceUnavailableException |
503 - Service Unavailable |
In most cases this is intentionally done if the service is down for maintenance. |
{
"status": 500,
"type": "InternalException",
"message": "Exception Message",
"error": "Exception Trace",
"report_url": "https://github.com..."
}
Property | Remarks |
---|---|
status |
Returned HTTP Status Code |
type |
Thrown Exception |
message |
Human-readable error message |
error |
Error response and trace from the API |
report_url |
Clicking this would redirect you to a generated GitHub issue |
ETag
header which is an MD5 hash of the responseIf-None-Match
in your next request header304 - Not Modified
response if the content has not changed200 - OK
response with the updated JSON responseBy using the API, you are agreeing to Jikan's terms of use policy.
v3 Documentation - Wrappers/SDKs - Report an issue - Host your own server
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "relations": [
- {
- "relation": "string",
- "entry": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "theme": {
- "openings": [
- "string"
], - "endings": [
- "string"
]
}, - "external": [
- {
- "name": "string",
- "url": "string"
}
], - "streaming": [
- {
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": [
- {
- "character": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string"
}, - "role": "string",
- "voice_actors": [
- {
- "person": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string"
}, - "language": "string"
}
]
}
]
}
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "title_japanese": "string",
- "title_romanji": "string",
- "aired": "string",
- "score": null,
- "filler": true,
- "recap": true,
- "forum_url": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "title_japanese": "string",
- "title_romanji": "string",
- "duration": 0,
- "aired": "string",
- "filler": true,
- "recap": true,
- "synopsis": "string"
}
}
{- "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}, - "data": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "date": "string",
- "author_username": "string",
- "author_url": "string",
- "forum_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "comments": 0,
- "excerpt": "string"
}
]
}
id required | integer |
filter | string Enum: "all" "episode" "other" Filter topics |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "date": "string",
- "author_username": "string",
- "author_url": "string",
- "comments": 0,
- "last_comment": {
- "url": "string",
- "author_username": "string",
- "author_url": "string",
- "date": "string"
}
}
]
}
{- "data": {
- "promo": [
- {
- "title": "string",
- "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string",
- "images": {
- "image_url": "string",
- "small_image_url": "string",
- "medium_image_url": "string",
- "large_image_url": "string",
- "maximum_image_url": "string"
}
}
}
], - "episodes": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "episode": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}
}
], - "music_videos": [
- {
- "title": "string",
- "video": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string",
- "images": {
- "image_url": "string",
- "small_image_url": "string",
- "medium_image_url": "string",
- "large_image_url": "string",
- "maximum_image_url": "string"
}
}, - "meta": {
- "title": "string",
- "author": "string"
}
}
]
}
}
{- "data": [
- {
- "mal_id": 0,
- "title": "string",
- "episode": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
{- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "score": 0,
- "status": "string",
- "episodes_seen": 0,
- "episodes_total": 0,
- "date": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
id required | integer |
page | integer |
preliminary | boolean 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: |
spoilers | boolean Any reviews that are tagged as a spoiler. Spoiler reviews are not returned by default. e.g usage: |
{- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "mal_id": 0,
- "url": "string",
- "type": "string",
- "reactions": {
- "overall": 0,
- "nice": 0,
- "love_it": 0,
- "funny": 0,
- "confusing": 0,
- "informative": 0,
- "well_written": 0,
- "creative": 0
}, - "date": "string",
- "review": "string",
- "score": 0,
- "tags": [
- "string"
], - "is_spoiler": true,
- "is_preliminary": true,
- "episodes_watched": 0
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
unapproved | boolean 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: |
page | integer |
limit | integer |
q | string |
type | string (anime_search_query_type) Enum: "tv" "movie" "ova" "special" "ona" "music" "cm" "pv" "tv_special" Available Anime types |
score | number |
min_score | number Set a minimum score for results. |
max_score | number Set a maximum score for results |
status | string (anime_search_query_status) Enum: "airing" "complete" "upcoming" Available Anime statuses |
rating | string (anime_search_query_rating) Enum: "g" "pg" "pg13" "r17" "r" "rx" Available Anime audience ratings
|
sfw | boolean Filter out Adult entries |
genres | string Filter by genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
genres_exclude | string Exclude genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
order_by | string (anime_search_query_orderby) Enum: "mal_id" "title" "start_date" "end_date" "episodes" "score" "scored_by" "rank" "popularity" "members" "favorites" Available Anime order_by properties |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
producers | string Filter by producer(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
start_date | string Filter by starting date. Format: YYYY-MM-DD. e.g |
end_date | string Filter by ending date. Format: YYYY-MM-DD. e.g |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "name_kanji": "string",
- "nicknames": [
- "string"
], - "favorites": 0,
- "about": "string",
- "anime": [
- {
- "role": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
], - "manga": [
- {
- "role": "string",
- "manga": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
], - "voices": [
- {
- "language": "string",
- "person": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string"
}
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "name_kanji": "string",
- "nicknames": [
- "string"
], - "favorites": 0,
- "about": "string"
}
}
{- "data": [
- {
- "role": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
{- "data": [
- {
- "role": "string",
- "manga": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
page | integer |
limit | integer |
q | string |
order_by | string (characters_search_query_orderby) Enum: "mal_id" "name" "favorites" Available Character order_by properties |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "name_kanji": "string",
- "nicknames": [
- "string"
], - "favorites": 0,
- "about": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}, - "data": [
- {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}
]
}
{- "data": {
- "anime": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "manga": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "characters": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
}
page | integer |
limit | integer |
q | string |
type | string (club_search_query_type) Enum: "public" "private" "secret" Club Search Query Type |
category | string (club_search_query_category) Enum: "anime" "manga" "actors_and_artists" "characters" "cities_and_neighborhoods" "companies" "conventions" "games" "japan" "music" "other" "schools" Club Search Query Category |
order_by | string (club_search_query_orderby) Enum: "mal_id" "name" "members_count" "created" Club Search Query OrderBy |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
{- "data": [
- {
- "mal_id": 0,
- "name": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "members": 0,
- "category": "actors & artists",
- "created": "string",
- "access": "public"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
page | integer |
limit | integer |
q | string |
order_by | string (magazines_query_orderby) Enum: "mal_id" "name" "count" Order by magazine data |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
{- "data": [
- {
- "mal_id": 0,
- "name": "string",
- "url": "string",
- "count": 0
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "Manga",
- "chapters": 0,
- "volumes": 0,
- "status": "Finished",
- "publishing": true,
- "published": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "authors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "serializations": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "relations": [
- {
- "relation": "string",
- "entry": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "external": [
- {
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "type": "Manga",
- "chapters": 0,
- "volumes": 0,
- "status": "Finished",
- "publishing": true,
- "published": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "authors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "serializations": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": [
- {
- "character": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string"
}, - "role": "string"
}
]
}
{- "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}, - "data": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "date": "string",
- "author_username": "string",
- "author_url": "string",
- "forum_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "comments": 0,
- "excerpt": "string"
}
]
}
id required | integer |
filter | string Enum: "all" "episode" "other" Filter topics |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "title": "string",
- "date": "string",
- "author_username": "string",
- "author_url": "string",
- "comments": 0,
- "last_comment": {
- "url": "string",
- "author_username": "string",
- "author_url": "string",
- "date": "string"
}
}
]
}
{- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
{- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "score": 0,
- "status": "string",
- "volumes_read": 0,
- "volumes_total": 0,
- "chapters_read": 0,
- "chapters_total": 0,
- "date": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
id required | integer |
page | integer |
preliminary | boolean 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: |
spoilers | boolean Any reviews that are tagged as a spoiler. Spoiler reviews are not returned by default. e.g usage: |
{- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "mal_id": 0,
- "url": "string",
- "type": "string",
- "reactions": {
- "overall": 0,
- "nice": 0,
- "love_it": 0,
- "funny": 0,
- "confusing": 0,
- "informative": 0,
- "well_written": 0,
- "creative": 0
}, - "date": "string",
- "review": "string",
- "score": 0,
- "tags": [
- "string"
], - "is_spoiler": true,
- "is_preliminary": true
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
unapproved | boolean 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: |
page | integer |
limit | integer |
q | string |
type | string (manga_search_query_type) Enum: "manga" "novel" "lightnovel" "oneshot" "doujin" "manhwa" "manhua" Available Manga types |
score | number |
min_score | number Set a minimum score for results. |
max_score | number Set a maximum score for results |
status | string (manga_search_query_status) Enum: "publishing" "complete" "hiatus" "discontinued" "upcoming" Available Manga statuses |
sfw | boolean Filter out Adult entries |
genres | string Filter by genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
genres_exclude | string Exclude genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
order_by | string (manga_search_query_orderby) Enum: "mal_id" "title" "start_date" "end_date" "chapters" "volumes" "score" "scored_by" "rank" "popularity" "members" "favorites" Available Manga order_by properties |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
magazines | string Filter by magazine(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3 |
start_date | string Filter by starting date. Format: YYYY-MM-DD. e.g |
end_date | string Filter by ending date. Format: YYYY-MM-DD. e.g |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "type": "Manga",
- "chapters": 0,
- "volumes": 0,
- "status": "Finished",
- "publishing": true,
- "published": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "authors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "serializations": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "website_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string",
- "given_name": "string",
- "family_name": "string",
- "alternate_names": [
- "string"
], - "birthday": "string",
- "favorites": 0,
- "about": "string",
- "anime": [
- {
- "position": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
], - "manga": [
- {
- "position": "string",
- "manga": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
], - "voices": [
- {
- "role": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "character": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string"
}
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "website_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string",
- "given_name": "string",
- "family_name": "string",
- "alternate_names": [
- "string"
], - "birthday": "string",
- "favorites": 0,
- "about": "string"
}
}
{- "data": [
- {
- "position": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
{- "data": [
- {
- "role": "string",
- "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "character": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string"
}
}
]
}
{- "data": [
- {
- "position": "string",
- "manga": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
}
]
}
page | integer |
limit | integer |
q | string |
order_by | string (people_search_query_orderby) Enum: "mal_id" "name" "birthday" "favorites" Available People order_by properties |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "website_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string",
- "given_name": "string",
- "family_name": "string",
- "alternate_names": [
- "string"
], - "birthday": "string",
- "favorites": 0,
- "about": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "images": {
- "jpg": {
- "image_url": "string"
}
}, - "favorites": 0,
- "count": 0,
- "established": "string",
- "about": "string"
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "images": {
- "jpg": {
- "image_url": "string"
}
}, - "favorites": 0,
- "count": 0,
- "established": "string",
- "about": "string",
- "external": [
- {
- "name": "string",
- "url": "string"
}
]
}
}
page | integer |
limit | integer |
q | string |
order_by | string (producers_query_orderby) Enum: "mal_id" "count" "favorites" "established" Producers Search Query Order By |
sort | string (search_query_sort) Enum: "desc" "asc" Search query sort direction |
letter | string Return entries starting with the given letter |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "images": {
- "jpg": {
- "image_url": "string"
}
}, - "favorites": 0,
- "count": 0,
- "established": "string",
- "about": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "type": "Manga",
- "chapters": 0,
- "volumes": 0,
- "status": "Finished",
- "publishing": true,
- "published": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "authors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "serializations": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "name_kanji": "string",
- "nicknames": [
- "string"
], - "favorites": 0,
- "about": "string"
}
}
{- "data": {
- "mal_id": 0,
- "url": "string",
- "website_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string",
- "given_name": "string",
- "family_name": "string",
- "alternate_names": [
- "string"
], - "birthday": "string",
- "favorites": 0,
- "about": "string"
}
}
{- "data": {
- "mal_id": 0,
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}, - "last_online": "string",
- "gender": "string",
- "birthday": "string",
- "location": "string",
- "joined": "string"
}
}
{- "data": [
- {
- "mal_id": "string",
- "entry": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
], - "content": "string",
- "user": {
- "url": "string",
- "username": "string"
}
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": [
- {
- "mal_id": "string",
- "entry": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
], - "content": "string",
- "user": {
- "url": "string",
- "username": "string"
}
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
page | integer |
preliminary | boolean 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: |
spoilers | boolean Any reviews that are tagged as a spoiler. Spoiler reviews are not returned by default. e.g usage: |
null
page | integer |
preliminary | boolean 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: |
spoilers | boolean Any reviews that are tagged as a spoiler. Spoiler reviews are not returned by default. e.g usage: |
null
filter | string Enum: "monday" "tuesday" "wednesday" "thursday" "friday" "saturday" "sunday" "unknown" "other" Filter by day |
kids | string Enum: "true" "false" When supplied, it will filter entries with the |
sfw | string Enum: "true" "false" 'Safe For Work'. When supplied, it will filter entries with the |
unapproved | boolean 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: |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
page | integer |
limit | integer |
q | string |
gender | string (users_search_query_gender) Enum: "any" "male" "female" "nonbinary" Users Search Query Gender. |
location | string |
maxAge | integer |
minAge | integer |
{- "data": [
- {
- "url": "string",
- "username": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}, - "last_online": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": {
- "mal_id": 0,
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}, - "last_online": "string",
- "gender": "string",
- "birthday": "string",
- "location": "string",
- "joined": "string",
- "statistics": {
- "anime": {
- "days_watched": 0,
- "mean_score": 0,
- "watching": 0,
- "completed": 0,
- "on_hold": 0,
- "dropped": 0,
- "plan_to_watch": 0,
- "total_entries": 0,
- "rewatched": 0,
- "episodes_watched": 0
}, - "manga": {
- "days_read": 0,
- "mean_score": 0,
- "reading": 0,
- "completed": 0,
- "on_hold": 0,
- "dropped": 0,
- "plan_to_read": 0,
- "total_entries": 0,
- "reread": 0,
- "chapters_read": 0,
- "volumes_read": 0
}
}, - "external": [
- {
- "name": "string",
- "url": "string"
}
]
}
}
{- "data": {
- "mal_id": 0,
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}, - "last_online": "string",
- "gender": "string",
- "birthday": "string",
- "location": "string",
- "joined": "string"
}
}
{- "data": {
- "anime": {
- "days_watched": 0,
- "mean_score": 0,
- "watching": 0,
- "completed": 0,
- "on_hold": 0,
- "dropped": 0,
- "plan_to_watch": 0,
- "total_entries": 0,
- "rewatched": 0,
- "episodes_watched": 0
}, - "manga": {
- "days_read": 0,
- "mean_score": 0,
- "reading": 0,
- "completed": 0,
- "on_hold": 0,
- "dropped": 0,
- "plan_to_read": 0,
- "total_entries": 0,
- "reread": 0,
- "chapters_read": 0,
- "volumes_read": 0
}
}
}
{- "data": {
- "anime": [
- {
- "type": "string",
- "start_year": 0,
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
], - "manga": [
- {
- "type": "string",
- "start_year": 0,
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
], - "characters": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "type": "string",
- "title": "string"
}
], - "people": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string"
}
]
}
}
{- "data": {
- "anime": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "score": 0,
- "status": "string",
- "episodes_seen": 0,
- "episodes_total": 0,
- "date": "string"
}
], - "manga": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "score": 0,
- "status": "string",
- "chapters_read": 0,
- "chapters_total": 0,
- "volumes_read": 0,
- "volumes_total": 0,
- "date": "string"
}
]
}
}
{- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "last_online": "string",
- "friends_since": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
User Anime lists have been discontinued since May 1st, 2022. Read more
username required | string |
status | string (user_anime_list_status_filter) Enum: "all" "watching" "completed" "onhold" "dropped" "plantowatch" User's anime list status filter options |
null
User Manga lists have been discontinued since May 1st, 2022. Read more
username required | string |
status | string (user_manga_list_status_filter) Enum: "all" "reading" "completed" "onhold" "dropped" "plantoread" User's anime list status filter options |
null
{- "data": {
- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "mal_id": 0,
- "url": "string",
- "type": "string",
- "reactions": {
- "overall": 0,
- "nice": 0,
- "love_it": 0,
- "funny": 0,
- "confusing": 0,
- "informative": 0,
- "well_written": 0,
- "creative": 0
}, - "date": "string",
- "review": "string",
- "score": 0,
- "tags": [
- "string"
], - "is_spoiler": true,
- "is_preliminary": true,
- "episodes_watched": 0
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
}
{- "data": [
- {
- "mal_id": "string",
- "entry": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}
], - "content": "string",
- "user": {
- "url": "string",
- "username": "string"
}
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
filter | string Enum: "tv" "movie" "ova" "special" "ona" "music" Entry types |
sfw | boolean '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: |
unapproved | boolean 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: |
continuing | boolean This is a flag. When supplied it will include entries which are continuing from previous seasons. MAL includes these items on the seasons view in the ″TV (continuing)″ section. (Example: https://myanimelist.net/anime/season/2024/winter) |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
year required | integer |
season required | string |
filter | string Enum: "tv" "movie" "ova" "special" "ona" "music" Entry types |
sfw | boolean '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: |
unapproved | boolean 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: |
continuing | boolean This is a flag. When supplied it will include entries which are continuing from previous seasons. MAL includes these items on the seasons view in the ″TV (continuing)″ section. (Example: https://myanimelist.net/anime/season/2024/winter) |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
filter | string Enum: "tv" "movie" "ova" "special" "ona" "music" Entry types |
sfw | boolean '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: |
unapproved | boolean 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: |
continuing | boolean This is a flag. When supplied it will include entries which are continuing from previous seasons. MAL includes these items on the seasons view in the ″TV (continuing)″ section. (Example: https://myanimelist.net/anime/season/2024/winter) |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
type | string (anime_search_query_type) Enum: "tv" "movie" "ova" "special" "ona" "music" "cm" "pv" "tv_special" Available Anime types |
filter | string (top_anime_filter) Enum: "airing" "upcoming" "bypopularity" "favorite" Top items filter types |
rating | string (anime_search_query_rating) Enum: "g" "pg" "pg13" "r17" "r" "rx" Available Anime audience ratings
|
sfw | boolean Filter out Adult entries |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "trailer": {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string"
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "title_synonyms": [
- "string"
], - "type": "TV",
- "source": "string",
- "episodes": 0,
- "status": "Finished Airing",
- "airing": true,
- "aired": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "duration": "string",
- "rating": "G - All Ages",
- "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "season": "summer",
- "year": 0,
- "broadcast": {
- "day": "string",
- "time": "string",
- "timezone": "string",
- "string": "string"
}, - "producers": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "licensors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "studios": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
type | string (manga_search_query_type) Enum: "manga" "novel" "lightnovel" "oneshot" "doujin" "manhwa" "manhua" Available Manga types |
filter | string (top_manga_filter) Enum: "publishing" "upcoming" "bypopularity" "favorite" Top items filter types |
page | integer |
limit | integer |
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "approved": true,
- "titles": [
- {
- "type": "string",
- "title": "string"
}
], - "title": "string",
- "title_english": "string",
- "title_japanese": "string",
- "type": "Manga",
- "chapters": 0,
- "volumes": 0,
- "status": "Finished",
- "publishing": true,
- "published": {
- "from": "string",
- "to": "string",
- "prop": {
- "from": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "to": {
- "day": 0,
- "month": 0,
- "year": 0
}, - "string": "string"
}
}, - "score": 0,
- "scored_by": 0,
- "rank": 0,
- "popularity": 0,
- "members": 0,
- "favorites": 0,
- "synopsis": "string",
- "background": "string",
- "authors": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "serializations": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "explicit_genres": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "themes": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
], - "demographics": [
- {
- "mal_id": 0,
- "type": "string",
- "name": "string",
- "url": "string"
}
]
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "website_url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}
}, - "name": "string",
- "given_name": "string",
- "family_name": "string",
- "alternate_names": [
- "string"
], - "birthday": "string",
- "favorites": 0,
- "about": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
{- "data": [
- {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string"
}
}, - "name": "string",
- "name_kanji": "string",
- "nicknames": [
- "string"
], - "favorites": 0,
- "about": "string"
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true,
- "items": {
- "count": 0,
- "total": 0,
- "per_page": 0
}
}
}
page | integer |
type | string (top_reviews_type_enum) Enum: "anime" "manga" The type of reviews to filter by. Defaults to anime. |
preliminary | boolean Whether the results include preliminary reviews or not. Defaults to true. |
spoilers | boolean Whether the results include reviews with spoilers or not. Defaults to true. |
{- "data": {
- "data": [
- {
- "user": {
- "username": "string",
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string"
}, - "webp": {
- "image_url": "string"
}
}
}, - "anime": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "mal_id": 0,
- "url": "string",
- "type": "string",
- "reactions": {
- "overall": 0,
- "nice": 0,
- "love_it": 0,
- "funny": 0,
- "confusing": 0,
- "informative": 0,
- "well_written": 0,
- "creative": 0
}, - "date": "string",
- "review": "string",
- "score": 0,
- "tags": [
- "string"
], - "is_spoiler": true,
- "is_preliminary": true,
- "episodes_watched": 0
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
}
{- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "episodes": [
- {
- "mal_id": "string",
- "url": "string",
- "title": "string",
- "premium": true
}
], - "region_locked": true
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "episodes": [
- {
- "mal_id": "string",
- "url": "string",
- "title": "string",
- "premium": true
}
], - "region_locked": true
}
], - "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}
}
{- "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}, - "title": "string",
- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "trailer": [
- {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string",
- "images": {
- "image_url": "string",
- "small_image_url": "string",
- "medium_image_url": "string",
- "large_image_url": "string",
- "maximum_image_url": "string"
}
}
]
}
]
}
{- "pagination": {
- "last_visible_page": 0,
- "has_next_page": true
}, - "title": "string",
- "data": [
- {
- "entry": {
- "mal_id": 0,
- "url": "string",
- "images": {
- "jpg": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}, - "webp": {
- "image_url": "string",
- "small_image_url": "string",
- "large_image_url": "string"
}
}, - "title": "string"
}, - "trailer": [
- {
- "youtube_id": "string",
- "url": "string",
- "embed_url": "string",
- "images": {
- "image_url": "string",
- "small_image_url": "string",
- "medium_image_url": "string",
- "large_image_url": "string",
- "maximum_image_url": "string"
}
}
]
}
]
}