Jikan API
[Jikan](https://jikan.moe) is an Unofficial MyAnimeList API. It scrapes the website to satisfy the need for a complete API - which MyAnimeList lacks.…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Jikan is an Unofficial MyAnimeList API.
It scrapes the website to satisfy the need for a complete API - which MyAnimeList lacks.
Information
⚡ Jikan is powered by its awesome backers - 🙏 Become a backer
Rate Limiting
| 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.
JSON Notes
- Any property (except arrays or objects) whose value does not exist or is undetermined, will be
null. - Any array or object property whose value does not exist or is undetermined, will be empty.
- Any
scoreproperty whose value does not exist or is undetermined, will be0. - All dates and timestamps are returned in ISO8601 format and in UTC timezone
Caching
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.
Allowed HTTP(s) requests
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.
HTTP Responses
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. |
JSON Error Response
{
"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 |
Cache Validation
- All requests return a
ETagheader which is an MD5 hash of the response - You can use this hash to verify if there's new or updated content by suppliying it as the value for the
If-None-Matchin your next request header - You will get a HTTP
304 - Not Modifiedresponse if the content has not changed - If the content has changed, you'll get a HTTP
200 - OKresponse with the updated JSON response
Disclaimer
- Jikan is not affiliated with MyAnimeList.net.
- Jikan is a free, open-source API. Please use it responsibly.
By using the API, you are agreeing to Jikan's terms of use policy.
v3 Documentation - Wrappers/SDKs - Report an issue - Host your own server
Endpoints 100
anime
- GETgetAnimeFullById
/anime/:id/full - GETgetAnimeById
/anime/:id - GETgetAnimeCharacters
/anime/:id/characters - GETgetAnimeStaff
/anime/:id/staff - GETgetAnimeEpisodes
/anime/:id/episodes?page=0 - GETgetAnimeEpisodeById
/anime/:id/episodes/:episode - GETgetAnimeNews
/anime/:id/news?page=0 - GETgetAnimeForum
/anime/:id/forum?filter=all - GETgetAnimeVideos
/anime/:id/videos - GETgetAnimeVideosEpisodes
/anime/:id/videos/episodes?page=0 - GETgetAnimePictures
/anime/:id/pictures - GETgetAnimeStatistics
/anime/:id/statistics - GETgetAnimeMoreInfo
/anime/:id/moreinfo - GETgetAnimeRecommendations
/anime/:id/recommendations - GETgetAnimeUserUpdates
/anime/:id/userupdates?page=0 - GETgetAnimeReviews
/anime/:id/reviews?page=0&preliminary=true&spoilers=true - GETgetAnimeRelations
/anime/:id/relations - GETgetAnimeThemes
/anime/:id/themes - GETgetAnimeExternal
/anime/:id/external - GETgetAnimeStreaming
/anime/:id/streaming - GETgetAnimeSearch
/anime?unapproved=true&page=0&limit=0&q=string&type=TV&score=0.0&min_score=0.0&max_score=0.0&status=airing&rating=g&sfw=true&genres=string&genres_exclude=string&order_by=mal_id&sort=desc&letter=string&producers=string&start_date=string&end_date=string
characters
- GETgetCharacterFullById
/characters/:id/full - GETgetCharacterById
/characters/:id - GETgetCharacterAnime
/characters/:id/anime - GETgetCharacterManga
/characters/:id/manga - GETgetCharacterVoiceActors
/characters/:id/voices - GETgetCharacterPictures
/characters/:id/pictures - GETgetCharactersSearch
/characters?page=0&limit=0&q=string&order_by=mal_id&sort=desc&letter=string
clubs
- GETgetClubsById
/clubs/:id - GETgetClubMembers
/clubs/:id/members?page=0 - GETgetClubStaff
/clubs/:id/staff - GETgetClubRelations
/clubs/:id/relations - GETgetClubsSearch
/clubs?page=0&limit=0&q=string&type=public&category=anime&order_by=mal_id&sort=desc&letter=string
genres
- GETgetAnimeGenres
/genres/anime?filter=genres - GETgetMangaGenres
/genres/manga?filter=genres
magazines
- GETgetMagazines
/magazines?page=0&limit=0&q=string&order_by=mal_id&sort=desc&letter=string
manga
- GETgetMangaFullById
/manga/:id/full - GETgetMangaById
/manga/:id - GETgetMangaCharacters
/manga/:id/characters - GETgetMangaNews
/manga/:id/news?page=0 - GETgetMangaTopics
/manga/:id/forum?filter=all - GETgetMangaPictures
/manga/:id/pictures - GETgetMangaStatistics
/manga/:id/statistics - GETgetMangaMoreInfo
/manga/:id/moreinfo - GETgetMangaRecommendations
/manga/:id/recommendations - GETgetMangaUserUpdates
/manga/:id/userupdates?page=0 - GETgetMangaReviews
/manga/:id/reviews?page=0&preliminary=true&spoilers=true - GETgetMangaRelations
/manga/:id/relations - GETgetMangaExternal
/manga/:id/external - GETgetMangaSearch
/manga?unapproved=true&page=0&limit=0&q=string&type=manga&score=0.0&min_score=0.0&max_score=0.0&status=publishing&sfw=true&genres=string&genres_exclude=string&order_by=mal_id&sort=desc&letter=string&magazines=string&start_date=string&end_date=string
people
- GETgetPersonFullById
/people/:id/full - GETgetPersonById
/people/:id - GETgetPersonAnime
/people/:id/anime - GETgetPersonVoices
/people/:id/voices - GETgetPersonManga
/people/:id/manga - GETgetPersonPictures
/people/:id/pictures - GETgetPeopleSearch
/people?page=0&limit=0&q=string&order_by=mal_id&sort=desc&letter=string
producers
- GETgetProducerById
/producers/:id - GETgetProducerFullById
/producers/:id/full - GETgetProducerExternal
/producers/:id/external - GETgetProducers
/producers?page=0&limit=0&q=string&order_by=mal_id&sort=desc&letter=string
random
- GETgetRandomAnime
/random/anime - GETgetRandomManga
/random/manga - GETgetRandomCharacters
/random/characters - GETgetRandomPeople
/random/people - GETgetRandomUsers
/random/users
recommendations
- GETgetRecentAnimeRecommendations
/recommendations/anime?page=0 - GETgetRecentMangaRecommendations
/recommendations/manga?page=0
reviews
- GETgetRecentAnimeReviews
/reviews/anime?page=0&preliminary=true&spoilers=true - GETgetRecentMangaReviews
/reviews/manga?page=0&preliminary=true&spoilers=true
schedules
- GETgetSchedules
/schedules?filter=monday&kids=true&sfw=true&unapproved=true&page=0&limit=0
users
- GETgetUsersSearch
/users?page=0&limit=0&q=string&gender=any&location=string&maxAge=0&minAge=0 - GETgetUserById
/users/userbyid/:id - GETgetUserFullProfile
/users/:username/full - GETgetUserProfile
/users/:username - GETgetUserStatistics
/users/:username/statistics - GETgetUserFavorites
/users/:username/favorites - GETgetUserUpdates
/users/:username/userupdates - GETgetUserAbout
/users/:username/about - GETgetUserHistory
/users/:username/history?type=anime - GETgetUserFriends
/users/:username/friends?page=0 - GETgetUserAnimelist
/users/:username/animelist?status=allDeprecated. User Anime lists have been discontinued since May 1st, 2022. <a… - GETgetUserMangaList
/users/:username/mangalist?status=allDeprecated. User Manga lists have been discontinued since May 1st, 2022. <a… - GETgetUserReviews
/users/:username/reviews?page=0 - GETgetUserRecommendations
/users/:username/recommendations?page=0 - GETgetUserClubs
/users/:username/clubs?page=0 - GETgetUserExternal
/users/:username/external
seasons
- GETgetSeasonNow
/seasons/now?filter=tv&sfw=true&unapproved=true&continuing=true&page=0&limit=0 - GETgetSeason
/seasons/:year/:season?filter=tv&sfw=true&unapproved=true&continuing=true&page=0&limit=0 - GETgetSeasonsList
/seasons - GETgetSeasonUpcoming
/seasons/upcoming?filter=tv&sfw=true&unapproved=true&continuing=true&page=0&limit=0
top
- GETgetTopAnime
/top/anime?type=TV&filter=airing&rating=g&sfw=true&page=0&limit=0 - GETgetTopManga
/top/manga?type=manga&filter=publishing&page=0&limit=0 - GETgetTopPeople
/top/people?page=0&limit=0 - GETgetTopCharacters
/top/characters?page=0&limit=0 - GETgetTopReviews
/top/reviews?page=0&type=anime&preliminary=true&spoilers=true
watch
- GETgetWatchRecentEpisodes
/watch/episodes - GETgetWatchPopularEpisodes
/watch/episodes/popular - GETgetWatchRecentPromos
/watch/promos?page=0 - GETgetWatchPopularPromos
/watch/promos/popular
API details
- Base URL
https://api.jikan.moe/v4- Authentication
- None declared in the description
- Operations
- 100 operations on 100 pathsGET 100
2 marked deprecated - Main resources
- anime 21users 16manga 14characters 7people 7clubs 5random 5top 5producers 4seasons 4
- Response formats
application/json- Description format
- OpenAPI 3.0.0, API version
4.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the Jikan API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Jikan API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “getAnimeFullById” (GET /anime/:id/full), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Jikan API?
[Jikan](https://jikan.moe) is an Unofficial MyAnimeList API. It scrapes the website to satisfy the need for a complete API - which MyAnimeList lacks.… It is listed under Media & content and has 100 endpoints.
Who publishes the Jikan API?
It is listed from Jikan (MyAnimeList)'s public API description (an OpenAPI document), not published by Jikan (MyAnimeList) on Swastik Codes. Anyone who controls jikan.moe can claim the profile by adding a DNS TXT record.
What is the base URL of the Jikan API?
Requests go to https://api.jikan.moe/v4. Endpoint paths are added to this base URL.
How do I authenticate with the Jikan API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Jikan API have?
100 operations on 100 paths (100 GET). The largest groups are anime, users, manga, characters.
Is forking the Jikan API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.