| Name | Modified | Size | Downloads / 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 runcomposer update.new MalClient($client)still takes aSymfony\Contracts\HttpClient\HttpClientInterface. (#607) - Removed:
AnimeCard::getLicensors()andSeasonalAnime::getLicensors()(readAnime::getLicensors()),Model\Manga\MangaReviewer,Parser\Manga\MangaReviewerParser,Parser\Manga\MangaReviewScoresParser,Jikan\Goutte\GoutteWrapper(nowJikan\Http\HttpClientWrapper), andNewsListItemParser::getImage()andgetIntro(). (#643) - Many getters can return
nullwhere a missing field used to be aTypeError— you must handlenull. The list is inUPGRADING.md§3. (#658) getNewsList()returnsModel\News\ResourceNewsList; the getters have the same names. (#630)Constants::SEARCH_MANGA_NOVELis now8(it was2, which MyAnimeList reads as Light Novel); useSEARCH_MANGA_LIGHT_NOVELfor2. (#653)
Added
- 11 content endpoints:
getArticle,getArticleSearch,getArticleTags,getArticlesByTag,getNews,getNewsByTag,getNewsSearch,getNewsTags,getPinnedArticles,getRecentArticlesandgetRecentNews, each with itsJikan\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 withSymfony\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, likeAnime::getAired()and the episode dates. They were midnight in Japan converted to UTC, so "Oct 2, 2026" gave2026-10-01T15:00:00+00:00and a year-only "2027" gave2026-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()(fromgetAnimeEpisode()) is UTC midnight of the printed day, like the episode list andAnime::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; usegetReactions()for the breakdown. Before this, the anime version always returned0and the manga version failed looking for the removed vote count. (#662)symfony/dom-crawleris now a declared requirement (^7.4 || ^8.0). The library has always used it directly but only received it throughsymfony/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
Seasonalmodel is identical. (#642) - An anime card with no member count now raises
ParserExceptionfromMalClient(aRuntimeExceptionfromAnimeCardParser::getMembers()), where it used to raise an uncaught\TypeErrorthatcatch (\Exception)andcatch (ParserException)both missed. If you caught\TypeErroraround client calls to work around this, catchParserExceptioninstead. (#642) Jikan\Model\User\Friend::getFriendsSince()returns?\DateTimeImmutable:nullwhen MyAnimeList shows no "Friends since" date. It used to declare a non-null date and throw aTypeErrorin that case. (#642)- Test suite relocated from
test/JikanTesttotest/unit; tests stay hermetic against recorded fixtures (composer link-fixtures) and never hit the live site. (#607) composer testnow runs the PHPUnit suite directly (PHPUnit via paratest^7— the oldphpunit ~9dev 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 (nodiv.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 always1, even whenhasNextPage()wastrue. It is the furthest page the links reach. AndhasNextPage()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 aread/totalpair and raisedUndefined array key 1; where warnings become exceptions (Laravel does), a catch-all ingetResults()then returned no rows at all for the page. Those cells now read as unknown. - An unknown total is
null, not0.5/?(the series is still running) gave a total of0; it isnull. If you treated0as "unknown", check fornull. - A row that cannot be parsed is an error, reported as
ParserException, instead of an empty page next to ahasNextPage()that could betrue. A page without the table still has no rows. (#668) getUserReviews()pagination:hasNextPage()was alwaystrueandgetLastVisiblePage()always1, so paging through a user's reviews never ended. MyAnimeList shows 10 reviews per page and links only the next page ("More Reviews"), sohasNextPage()now reports that link andgetLastVisiblePage()is the next page when there is one. (#659)getAnimeScores()andgetMangaScores()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, sogetOverall()is the "Reviewer's Rating" and the category getters (getStory(),getAnimation(),getArt()and so on) returnnull.AnimeReviewScores/MangaReviewScoresare built withfromOverall(); theirfromParser()andJikan\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()andgetAiringStart()were alwaysnull. - Genre pages:
getAiringStart()was alwaysnull. 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, matchinggetAnime(). (#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", progress0and total355. They gave status"On-Hold -"with progress and totalnull. (#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 itsgetScore()returned0instead of the score itself. The 1–10 keys were right. Anime stats were not affected. (#651)ResourceArticle::getRelatedEntries()fromgetArticle()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 tonull) no longer throws "typed property must not be accessed before initialization" — those getters now returnnull, matching the?stringimage 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 tonull(jikan#488). (#624) Jikan\Model\Watch\EpisodeListItem::getEpisodes()returns the aired episode links as an array — every call previously threw aTypeErrorbecause the declared return type wasRecentEpisodeListItem. (#624)getAnimeGenres()/getMangaGenres()no longer read the wrong page section when MAL prepends extragenre-linkblocks before the genre lists (e.g. the "adapted from" block onmanga.php) — the four sections are now anchored by content, not position. (#624)getNewsList()now parses the current MAL news index (div.news-unititems, ad placements filtered out) — the previousjs-scrollfix-bottom-rellayout selector matched nothing on today's markup and returned an empty list (jikan#629). (#630)ResourceArticle::getViews()returnsnullinstead 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, includingAnimeParser,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->ghoutteproperty left over from the old Goutte client. (#642)- Casting a
PersonImageResource\JpgorUserImageResource\Jpgto string returns its image URL (an empty string when it is a placeholder) instead of throwing "call to undefined methodgetJpg()". (#642) Jikan\Http\HttpClientWrapperno 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 oneMalClientgrew without bound.request()now defaults$changeHistorytofalse. (#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 throwingBadResponseException. 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. TheBadResponseExceptionnow reaches you. (#643) - Anime and manga genre lists report pagination again:
hasNextPage()was alwaysfalseandgetLastVisiblePage()always1, 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, sogetLastVisiblePage()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 fillgetAuthors()andgetSerialization(). All three had been stubbed tonull/empty after an earlier layout change, and MyAnimeList shows them again. (#643) - Top characters and top people fill
getNameKanji(), for example "ルルーシュ・ランペルージ". It was alwaysnullbecause the name moved to adiv. (#643) Profile::getAbout()returnsnullinstead 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()andgetManga()no longer fail when a page has no "Aired:" or "Published:" row.getAired()/getPublished()return an empty range, both datesnull, which is what MyAnimeList shows as "Not available". (#644)Helper\Parser::parseDate()returnsnullinstead of failing with aTypeErroron text such as "Unknown, 2026".parseDateMDYReadable()returnsnullinstead of throwing on the same text, andstringIdFromUrl()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_japaneseno 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) - AnimeCard
typeno longer TypeErrors on cards without a type —AnimeCardParser::getType()returns?stringbut the model declaredstring; on pages with no card type the assignment would fatal.typeis 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 asJanuary 1 of the year;from_prop/to_propmonth/dayarenullwhen the source date omitted them (jikan#486). (#620) getAnimeSearchAlt()no longer references a non-existent model class — its declared return type pointed atModel\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 asnullinstead 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 stringgetImageUrl()/getImage()getters returnnull; the raw string getters and the affected image-resource properties are now?string. (#617)
What's Changed
- Industry News by @irfan-dahir in https://github.com/jikan-me/jikan/pull/543
- Add MAL Articles by @irfan-dahir in https://github.com/jikan-me/jikan/pull/563
- Add support Symfony 8 by @ToshY in https://github.com/jikan-me/jikan/pull/578
- Symfony 8 support by @irfan-dahir in https://github.com/jikan-me/jikan/pull/579
- Moved
phpro/grumphpto require-dev by @ToshY in https://github.com/jikan-me/jikan/pull/583 - chore: onboard backend-quality-suite for jikan by @irfan-dahir in https://github.com/jikan-me/jikan/pull/603
- chore: tighten grumphp blacklist; resolve API-standard sign-off decisions by @irfan-dahir in https://github.com/jikan-me/jikan/pull/610
- docs: land the backend-suite hardening + docs stack onto 5.0.0 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/611
- fix(model): make Manga::$status nullable (latent twin of jikan#599) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/612
- fix(parser): return [] when a theme-songs section has no rows by @irfan-dahir in https://github.com/jikan-me/jikan/pull/613
- fix(parser): drop empty cells from opening/ending theme lists (jikan#593) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/614
- fix(parser): cleanse episode title captures (NBSP) on the episodes list (jikan#564) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/615
- docs: review pass on CHANGELOG, CONTRIBUTING and readme by @irfan-dahir in https://github.com/jikan-me/jikan/pull/616
- fix: return null instead of MyAnimeList placeholder images (jikan#488) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/617
- docs: add AGENTS.md/CLAUDE.md navigation map; fix doc-role drift (LLM-friendly P1+P4) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/618
- feat: machine-readable endpoint catalog + llm.txt (LLM-friendly P2/P3) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/619
- fix(model): DateRange props preserve precision — null month/day for year/month-only (jikan#486) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/620
- fix(manifest): drift check ignores generatedAt and verification.commit stamps by @irfan-dahir in https://github.com/jikan-me/jikan/pull/622
- test: endpoint-parser coverage for Top ranking + AnimeSearch; fix placeholder image resources by @irfan-dahir in https://github.com/jikan-me/jikan/pull/621
- chore: beta-release preparation — survey/doctor gates green, beta install path by @irfan-dahir in https://github.com/jikan-me/jikan/pull/623
- test: coverage for genre/magazine/producer lists + Watch; fix apple-touch-icon and 2 latent bugs by @irfan-dahir in https://github.com/jikan-me/jikan/pull/624
- docs: modernize readme + master-line docs (v4 EOL, hosted API retired) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/625
- test: coverage for search family, user lists, username-by-id by @irfan-dahir in https://github.com/jikan-me/jikan/pull/626
- fix(helper): treat MAL's default kaomoji avatar as a placeholder (jikan#488 follow-up) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/627
- test: coverage for forum, reviews, pictures, moreinfo, characters/staff, recommendations by @irfan-dahir in https://github.com/jikan-me/jikan/pull/628
- feat: re-align News/Article parsers with current MAL markup (jikan#629) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/630
- ci: build recorded fixtures from source in CI (no packagist-snapshot lag) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/631
- feat(docs): wire the generate-docs pipeline through isolated phpDocumentor tooling by @irfan-dahir in https://github.com/jikan-me/jikan/pull/632
- feat(dx): composer quality one-command gate + live-drift review rule by @irfan-dahir in https://github.com/jikan-me/jikan/pull/633
- ci: enforce the composer quality gate in CI by @irfan-dahir in https://github.com/jikan-me/jikan/pull/638
- perf(ci): cut lint-job setup time (jikan#432) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/634
- fix(model): AnimeCard type nullability + RecommendationListItem malId typing by @irfan-dahir in https://github.com/jikan-me/jikan/pull/637
- docs: record na_series_ legacy status (no live witness, 2026-10 scans) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/639
- chore(toolchain): register endpoints:check as a natively-verified toolchain gate by @irfan-dahir in https://github.com/jikan-me/jikan/pull/635
- chore: declare tools/ (phpDocumentor tooling) for survey --check by @irfan-dahir in https://github.com/jikan-me/jikan/pull/640
- docs: surface composer quality as the one-command gate in the readme by @irfan-dahir in https://github.com/jikan-me/jikan/pull/641
- v5: parser hardening, benchmarks and performance foundations by @irfan-dahir in https://github.com/jikan-me/jikan/pull/642
- Test suite phase 2: clock, variant corpus, and the parser bugs it found by @irfan-dahir in https://github.com/jikan-me/jikan/pull/643
- Test suite phase 3: missing-field variants, mutation testing, helper property tests by @irfan-dahir in https://github.com/jikan-me/jikan/pull/644
- Enforce minMsi 85; cover escaped mutants and fix what they found by @irfan-dahir in https://github.com/jikan-me/jikan/pull/651
- build(deps): bump actions/cache from 4 to 6 by @dependabot[bot] in https://github.com/jikan-me/jikan/pull/647
- build(deps): bump actions/stale from 5.0.0 to 11.0.0 by @dependabot[bot] in https://github.com/jikan-me/jikan/pull/645
- Follow-ups: minMsi 88, weekly drift check, genre names, unused dev deps by @irfan-dahir in https://github.com/jikan-me/jikan/pull/652
- Align search filter constants with MyAnimeList's search form by @irfan-dahir in https://github.com/jikan-me/jikan/pull/653
- build(deps): bump actions/checkout from 2 to 7 by @dependabot[bot] in https://github.com/jikan-me/jikan/pull/646
- build(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in https://github.com/jikan-me/jikan/pull/649
- Align the drift workflow with the bumped action versions by @irfan-dahir in https://github.com/jikan-me/jikan/pull/654
- Remove the comment-run workflow by @irfan-dahir in https://github.com/jikan-me/jikan/pull/655
- Read anime card type and start date from the card's own fields by @irfan-dahir in https://github.com/jikan-me/jikan/pull/656
- Changelog for v5.0.0-beta.2 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/657
- RC blockers: nullable getters, getMembers() null, review scores by @irfan-dahir in https://github.com/jikan-me/jikan/pull/658
- RC sweep: user reviews pagination, dead imports, stale todos by @irfan-dahir in https://github.com/jikan-me/jikan/pull/659
- Changelog for v5.0.0-beta.3 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/660
- getHelpfulCount() returns the review's total reactions by @irfan-dahir in https://github.com/jikan-me/jikan/pull/662
- Anime-card start dates are UTC midnight of the day shown by @irfan-dahir in https://github.com/jikan-me/jikan/pull/666
- Single-episode air date is UTC, like the episode list (jikan-rest#567) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/664
- Add UPGRADING.md: the v4 to v5 guide by @irfan-dahir in https://github.com/jikan-me/jikan/pull/665
- Changelog and readme for v5.0.0-rc.1 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/667
- Fix anime/manga news pages (#661) and recently-updated progress cells (#663) by @irfan-dahir in https://github.com/jikan-me/jikan/pull/668
- Changelog and readme for v5.0.0-rc.2 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/669
- Documentation and changelog for v5.0.0 by @irfan-dahir in https://github.com/jikan-me/jikan/pull/670
New Contributors
- @dependabot[bot] made their first contribution in https://github.com/jikan-me/jikan/pull/647
Full Changelog: https://github.com/jikan-me/jikan/compare/v4.0.13...v5.0.0