Download Latest Version Jikan v5.0.0 source code.zip (596.7 kB)
Home / v5.0.0
Name Modified Size InfoDownloads / Week
Parent folder
Jikan v5.0.0 source code.tar.gz 2026-10-19 259.3 kB
Jikan v5.0.0 source code.zip 2026-10-19 596.7 kB
README.md 2026-10-19 28.8 kB
Totals: 3 Items   884.7 kB 1

The first stable release of the ^5 line. The code is identical to 5.0.0-rc.2. jikan-rest validated it on its Laravel 13 migration branch (403 tests, a 114-route crawl, and the news and "recently updated" endpoints that rc.1 had broken), and a live check of 14 MyAnimeList pages found no markup drift.

Upgrading from v4? Read UPGRADING.md (github.com). It lists every change to your code, and was checked by running v4 and v5 against the same 85 recorded pages. The sections below it record each pre-release in full.

Breaking (from v4)

  • PHP 8.4.4 or later — you must run it; Composer will not install on older versions. PHP 8.4.0–8.4.3 have an HTML5 parser bug that corrupts some emoji and rare characters. (#642)
  • The HTTP layer is Symfony's instead of fabpot/goutte — you must run composer update. new MalClient($client) still takes a Symfony\Contracts\HttpClient\HttpClientInterface. (#607)
  • Removed: AnimeCard::getLicensors() and SeasonalAnime::getLicensors() (read Anime::getLicensors()), Model\Manga\MangaReviewer, Parser\Manga\MangaReviewerParser, Parser\Manga\MangaReviewScoresParser, Jikan\Goutte\GoutteWrapper (now Jikan\Http\HttpClientWrapper), and NewsListItemParser::getImage() and getIntro(). (#643)
  • Many getters can return null where a missing field used to be a TypeError — you must handle null. The list is in UPGRADING.md §3. (#658)
  • getNewsList() returns Model\News\ResourceNewsList; the getters have the same names. (#630)
  • Constants::SEARCH_MANGA_NOVEL is now 8 (it was 2, which MyAnimeList reads as Light Novel); use SEARCH_MANGA_LIGHT_NOVEL for 2. (#653)

Added

  • 11 content endpoints: getArticle, getArticleSearch, getArticleTags, getArticlesByTag, getNews, getNewsByTag, getNewsSearch, getNewsTags, getPinnedArticles, getRecentArticles and getRecentNews, each with its Jikan\Request\* class. (#607)
  • Search constants for the anime types CM, PV and TV Special, the manga type Light Novel, and the manga statuses On Hiatus and Discontinued. (#653)
  • Jikan\Helper\Time: relative and partial dates resolve against a PSR-20 clock (the system clock by default; pin it in tests with Symfony\Component\Clock\Clock::set()). (#643)

Changed

  • Anime-card start dates (getAiringStart() on genre, producer, seasonal and schedule cards) are UTC midnight of the day shown, like Anime::getAired() and the episode dates. They were midnight in Japan converted to UTC, so "Oct 2, 2026" gave 2026-10-01T15:00:00+00:00 and a year-only "2027" gave 2026-12-31T15:00:00+00:00, the previous year. The instant is 9 hours later; if you read the date part, it is now the day shown. Text that carries a broadcast time still converts from Japan time. (#666)
  • AnimeEpisode::getAired() (from getAnimeEpisode()) is UTC midnight of the printed day, like the episode list and Anime::getAired(). It was midnight in Japan (1999-10-20T00:00:00+09:00), because the page prints "Aired: Oct 20, 1999(JST)" and PHP read the "(JST)" as a UTC+9 offset, so the same episode had two different dates depending on the endpoint (jikan-rest#567). The calendar date is unchanged; the instant is 9 hours later. If you compared timestamps between the two endpoints, they are now equal. A new check in the snapshot tests fails on any date that is not UTC. (#664)
  • getHelpfulCount() on anime and manga reviews returns the review's total reactions. MyAnimeList's 2022 review redesign replaced "helpful" votes with reactions (Nice, Love it, Funny, Confusing, Informative, Well-written, Creative), and this is their total. It counts every reaction, not only approving ones; use getReactions() for the breakdown. Before this, the anime version always returned 0 and the manga version failed looking for the removed vote count. (#662)
  • symfony/dom-crawler is now a declared requirement (^7.4 || ^8.0). The library has always used it directly but only received it through symfony/browser-kit, so nothing changes in your tree — no action needed unless you were excluding it. (#642)
  • A seasonal page parses roughly 3x faster (about 1.2 s down to 0.4 s in our benchmark). The marker for "continuing" shows was found by reading the text of the whole season section once per anime card; it is now read once per section. The returned Seasonal model is identical. (#642)
  • An anime card with no member count now raises ParserException from MalClient (a RuntimeException from AnimeCardParser::getMembers()), where it used to raise an uncaught \TypeError that catch (\Exception) and catch (ParserException) both missed. If you caught \TypeError around client calls to work around this, catch ParserException instead. (#642)
  • Jikan\Model\User\Friend::getFriendsSince() returns ?\DateTimeImmutable: null when MyAnimeList shows no "Friends since" date. It used to declare a non-null date and throw a TypeError in that case. (#642)
  • Test suite relocated from test/JikanTest to test/unit; tests stay hermetic against recorded fixtures (composer link-fixtures) and never hit the live site. (#607)
  • composer test now runs the PHPUnit suite directly (PHPUnit via paratest ^7 — the old phpunit ~9 dev constraint was dropped), grumphp moved to ^2, php-parallel-lint to ^1.4. (#607)

Fixed

  • getNewsList() returns the articles on an anime's or manga's news page again (AnimeNewsRequest, MangaNewsRequest; jikan#661). Those pages have their own layout (no div.news-unit), which the parser stopped reading when it was realigned to the main news index in v5.0.0-beta, so it returned an empty list. Each article has its title, /news/{id} URL, date, author, discussion link, comment count, excerpt and image, with absolute links. Anything fetched through these requests since v5.0.0-beta was empty. (#668)
  • getNewsList() pagination: getLastVisiblePage() was always 1, even when hasNextPage() was true. It is the furthest page the links reach. And hasNextPage() no longer counts the "News" tab, which links to the page you're on, so the last page of a long news list no longer claims a next page. (#668)
  • "Recently updated by users" for anime and manga (getAnimeRecentlyUpdatedByUsers(), getMangaRecentlyUpdatedByUsers(); jikan#663):
  • Crashes on a bare -. MyAnimeList prints a progress cell as just - for many users (39 of 75 rows on manga 2). The total getters assumed a read/total pair and raised Undefined array key 1; where warnings become exceptions (Laravel does), a catch-all in getResults() then returned no rows at all for the page. Those cells now read as unknown.
  • An unknown total is null, not 0. 5/? (the series is still running) gave a total of 0; it is null. If you treated 0 as "unknown", check for null.
  • A row that cannot be parsed is an error, reported as ParserException, instead of an empty page next to a hasNextPage() that could be true. A page without the table still has no rows. (#668)
  • getUserReviews() pagination: hasNextPage() was always true and getLastVisiblePage() always 1, so paging through a user's reviews never ended. MyAnimeList shows 10 reviews per page and links only the next page ("More Reviews"), so hasNextPage() now reports that link and getLastVisiblePage() is the next page when there is one. (#659)
  • getAnimeScores() and getMangaScores() on anime reviews, manga reviews and reviewers return the reviewer's overall rating. They always failed: the anime one called a parser that had been deleted, and the manga one read a score table that no longer exists. MyAnimeList's 2022 review redesign dropped the per-category ratings, so getOverall() is the "Reviewer's Rating" and the category getters (getStory(), getAnimation(), getArt() and so on) return null. AnimeReviewScores/MangaReviewScores are built with fromOverall(); their fromParser() and Jikan\Parser\Manga\MangaReviewScoresParser, which could not work, are removed. (#658)
  • Anime cards (genre, producer, seasonal and schedule pages; AnimeCard/SeasonalAnime) now read their type and start date from fields MyAnimeList puts on every card. This fixes four problems:
  • Year-only start dates: getAiringStart() gave today's date for a card that shows only a year ("2027"), because the year was read as the time 20:27 today. It now gives 1 January of that year.
  • Schedule page types: getType() gave the day of the week ("Friday", "Other") instead of the type.
  • Producer pages: getType() and getAiringStart() were always null.
  • Genre pages: getAiringStart() was always null. An unknown month or day falls on the 1st, as it already did for "Oct 2027". TV Specials on seasonal pages now report "TV Special" instead of the "Special" heading they are listed under, matching getAnime(). (#656)
  • getAnimeGenres()/getMangaGenres() item names keep their commas. The parser removed commas from the whole name as well as from the count. No genre name has a comma today, so current results are unchanged. (#652)
  • getUserProfile() last updates with nothing read or watched yet ("On-Hold -/355" on MyAnimeList) now give status "On-Hold", progress 0 and total 355. They gave status "On-Hold -" with progress and total null. (#651)
  • Related entries (getAnime(), getManga(), getNews(), getArticle()) no longer include MyAnimeList's empty links (<a href="..."></a>, for example a removed entry) as entries with an empty name. The code meant to skip them removed them from the page after the list of links had already been read, so they were kept. (#651)
  • getMangaStats() scores: a score nobody voted for (MyAnimeList leaves its row out) is filled in with 0 votes, but its getScore() returned 0 instead of the score itself. The 1–10 keys were right. Anime stats were not affected. (#651)
  • ResourceArticle::getRelatedEntries() from getArticle() returns the article's "Related Database Entries" (anime and manga links grouped by type). It always returned an empty list, because the HTML5 parser puts table rows inside <tbody> and the lookup didn't expect it. (#651)
  • Reading getSmallImageUrl()/getLargeImageUrl()/WebP image URLs on an entity whose image is a MyAnimeList placeholder (normalized to null) no longer throws "typed property must not be accessed before initialization" — those getters now return null, matching the ?string image contract (jikan#488). (#621)
  • Anime/manga detail pages with no cover no longer surface the MAL site icon (og:image → /img/sp/icon/apple-touch-icon-256.png) as the entity's image — it is now treated as a placeholder and resolved to null (jikan#488). (#624)
  • Jikan\Model\Watch\EpisodeListItem::getEpisodes() returns the aired episode links as an array — every call previously threw a TypeError because the declared return type was RecentEpisodeListItem. (#624)
  • getAnimeGenres()/getMangaGenres() no longer read the wrong page section when MAL prepends extra genre-link blocks before the genre lists (e.g. the "adapted from" block on manga.php) — the four sections are now anchored by content, not position. (#624)
  • getNewsList() now parses the current MAL news index (div.news-unit items, ad placements filtered out) — the previous js-scrollfix-bottom-rel layout selector matched nothing on today's markup and returned an empty list (jikan#629). (#630)
  • ResourceArticle::getViews() returns null instead of throwing when an article page has no view count — its type is now ?int (jikan#629). (#630)
  • News-item and article getDate() no longer mutate the shared DOM, so reading other info getters (author, views, comments) after the date on the same parser instance no longer fails (jikan#629). (#630)
  • Calling getModel() a second time on the same parser (or reading getters in a different order) no longer fails with "The current node list is empty" for 14 parsers, including AnimeParser, MangaParser, CharacterParser, the genre, club, news, recommendation and review parsers. Jikan\Helper\Parser::removeChildNodes() stripped elements out of the shared page, so whatever was read after it saw a changed page; it now works on a copy. Getters that ran after a mutating one now see the original markup. (#642)
  • MalClient::getNewsList() no longer fails before sending its request — it referenced a $this->ghoutte property left over from the old Goutte client. (#642)
  • Casting a PersonImageResource\Jpg or UserImageResource\Jpg to string returns its image URL (an empty string when it is a placeholder) instead of throwing "call to undefined method getJpg()". (#642)
  • Jikan\Http\HttpClientWrapper no longer records browser history. It kept one entry per request for the lifetime of the client (about 2.5 KB each), so a long-running process that reused one MalClient grew without bound. request() now defaults $changeHistory to false. (#642)
  • Two-digit years in anime/manga search results and user list dates are no longer read as the 2040s–2060s: "Kaguya-hime" (1961) came back as 2061. A year more than 10 years in the future is now read as 19xx; this also corrects isAiring() for those titles. (#642)
  • Anime and manga search with no matches return an empty result (getResults() is []) instead of throwing BadResponseException. MyAnimeList answers those searches with a 404 page. (#643)
  • Person search with no matches returns an empty result instead of throwing ParserException. MyAnimeList shows a "No results returned" row there. (#643)
  • Character and person search no longer turn a non-404 HTTP error, such as a 429 or 500, into a TypeError. The BadResponseException now reaches you. (#643)
  • Anime and manga genre lists report pagination again: hasNextPage() was always false and getLastVisiblePage() always 1, though a genre spans many pages (20 for Action). A positional selector no longer matched MyAnimeList's layout. (#643)
  • News lists, featured-article lists and "recently updated by users" (anime and manga) report pagination instead of a hard-coded false/1. For "recently updated by users" the page only links the next page, so getLastVisiblePage() is the next page when there is one. (#643)
  • Person::getPublishedManga() lists a person's manga, for example 14 for Hayao Miyazaki. It was always empty because the selector expected table rows without the <tbody> that HTML5 parsing inserts. (#643)
  • Manga related entries include the related-entries table (Side Story, Spin-Off, Alternative Version, Character and so on), not only the related tiles. The table was skipped for the same <tbody> reason. (#643)
  • Anime and manga cards (genre, producer, magazine and seasonal lists) fill getType() again, for example "TV" or "Manga". Seasonal cards take it from their section header. Manga cards fill getAuthors() and getSerialization(). All three had been stubbed to null/empty after an earlier layout change, and MyAnimeList shows them again. (#643)
  • Top characters and top people fill getNameKanji(), for example "ルルーシュ・ランペルージ". It was always null because the name moved to a div. (#643)
  • Profile::getAbout() returns null instead of "" when the user wrote nothing. (#643)
  • A user profile's last anime and manga updates keep the episode or chapter count when the total is not known yet ("Reading 92/?"). It used to be null, because the progress was only read when both numbers were present. (#643)
  • getAnime() and getManga() no longer fail when a page has no "Aired:" or "Published:" row. getAired()/getPublished() return an empty range, both dates null, which is what MyAnimeList shows as "Not available". (#644)
  • Helper\Parser::parseDate() returns null instead of failing with a TypeError on text such as "Unknown, 2026". parseDateMDYReadable() returns null instead of throwing on the same text, and stringIdFromUrl() no longer warns on a URL without a path. (#644)
  • Opening/ending theme lists no longer include empty entries — current MAL markup interleaves empty <td> cells with the real theme rows, so a one-theme title used to return ['', theme, '']. Parser now filters them (jikan#593). (#616)
  • Episode title_romanji / title_japanese no longer end with a trailing non-breaking space — the episodes-list parser now cleanses the captured titles exactly like the single-episode parser does (jikan#564). (#616)
  • AnimeCardtype no longer TypeErrors on cards without a type — AnimeCardParser::getType() returns ?string but the model declared string; on pages with no card type the assignment would fatal. type is now ?string, matching the source (malId/type consistency sweep). (#637)
  • Date ranges preserve precision — a year-only or month-only date (1989, May, 1979) no longer surfaces as January 1 of the year; from_prop/to_prop month/day are null when the source date omitted them (jikan#486). (#620)
  • getAnimeSearchAlt() no longer references a non-existent model class — its declared return type pointed at Model\Search\AnimeSearchAlt, which did not exist, so calling it would fatal; it now declares what the shared parser actually returns (Model\Search\AnimeSearch). Found by the new endpoint-manifest gate. (#619)
  • Placeholder images are no longer parsed (jikan#488) — MyAnimeList's "no image" placeholder assets (questionmark_23.gif, questionmark_50.gif, qm_50.gif, company/placeholder.png, na.gif, na_series_*.png|json) are now surfaced as null instead of the placeholder URL for characters, people/voice actors, anime/manga, users, clubs and producers without artwork. Both …->getImages()->getJpg()->getImageUrl() resource getters and the raw string getImageUrl()/getImage() getters return null; the raw string getters and the affected image-resource properties are now ?string. (#617)

What's Changed

New Contributors

Full Changelog: https://github.com/jikan-me/jikan/compare/v4.0.13...v5.0.0

Source: README.md, updated 2026-10-19