Jikan (MyAnimeList)

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.…

Media & content#openapi

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

DurationRequests
DailyUnlimited
Per Minute60 requests
Per Second3 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 score property whose value does not exist or is undetermined, will be 0.
  • 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.

HeaderRemarks
ExpiresCache expiry date
Last-ModifiedCache set date
X-Request-FingerprintUnique 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.

ExceptionHTTP StatusRemarks
N/A200 - OKThe request was successful
N/A304 - Not ModifiedYou have the latest data (Cache Validation response)
BadRequestException,ValidationException400 - Bad RequestYou've made an invalid request. Recheck documentation
BadResponseException404 - Not FoundThe resource was not found or MyAnimeList responded with a 404
BadRequestException405 - Method Not AllowedRequested Method is not supported for resource. Only GET requests are allowed
RateLimitException429 - Too Many RequestYou are being rate limited by Jikan or MyAnimeList is rate-limiting our servers (specified in the error response)
UpstreamException,ParserException,etc.500 - Internal Server ErrorSomething 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
ServiceUnavailableException503 - Service UnavailableIn 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..."
  }
PropertyRemarks
statusReturned HTTP Status Code
typeThrown Exception
messageHuman-readable error message
errorError response and trace from the API
report_urlClicking this would redirect you to a generated GitHub issue

Cache Validation

  • All requests return a ETag header 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-Match in your next request header
  • You will get a HTTP 304 - Not Modified response if the content has not changed
  • If the content has changed, you'll get a HTTP 200 - OK response 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

How to test the Jikan API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Jikan API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. 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.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.