Skip to content
Unofficial MyAnimeList PHP+REST API which provides functions other than the official API
Branch: master
Clone or download
Pull request Compare This branch is even with jikan-me:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Jun 1, 2019
src
test convert studio/magazine name to canonical for URLs Apr 29, 2019
.gitattributes
.gitignore
.travis.yml
LICENSE update file mode Mar 22, 2018
appveyor.yml
changelog.md
composer.json
grumphp.yml
phpunit.xml Update code coverage config Jul 29, 2018
phpunit.xml.dist Update code coverage config Jul 29, 2018
readme.md

readme.md

Jikan

Jikan - Unofficial MyAnimeList.net PHP API

build build stable Average time to resolve an issue Percentage of issues still open stable Discord Server

Jikan is a PHP API for MyAnimeList.net. It scrapes the website to satisfy the need for an API - which MyAnimeList lacks.

The raison d'être of Jikan is to assist developers easily get the data they need for their apps and projects without having to depend on the lackluster official API, unstable APIs, or sidetracking their projects to develop parsers.

The word Jikan literally translates to Time in Japanese (時間). And that's what this API saves you of. ;)

Notice: Jikan does not support authenticated requests. You can not update your lists.

Getting Started

  1. composer require jikan-me/jikan
  2. Documentation

❗️ Version ~1.0 is no longer maintained, it's required you use ^2.0.

Dependencies

Jikan REST API

A REST API service is available as well

Wrappers

Add your wrapper here

Features

  • Anime
    • Main Information
    • Characters & Staff
    • Episodes
    • News
    • Videos/PV/Episodes
    • Pictures
    • Stats
    • Forum Topics
    • More Info
    • Recommendations
    • Reviews
    • Recent List Updates By Users
  • Manga
    • Main Information
    • Characters
    • News
    • Stats
    • Pictures
    • Forum Topics
    • More Info
    • Recommendations
    • Reviews
    • Recent List Updates By Users
  • Character
    • Main Information
    • Pictures
  • People
    • Main Information
    • Pictures
  • Search
    • Anime
    • Manga
    • Character
    • Person
    • Pagination Support
    • Advanced Search
      • Filters
      • Order By
      • Sorting (Ascending/Descending)
  • Seasonal Anime (Season + Year)
  • Season List/Archive
  • Anime Scheduling (for current season)
  • Top
    • Anime
    • Manga
    • Characters
    • People
    • Sub Types & Pagination Support
  • Genre
    • Anime
    • Manga
  • Producers (Anime Listing by a Producer)
  • Magazines (Manga Listing by a Magazine)
  • User
    • Profile
    • Friends
      • Pagination support
    • History
      • All
      • Anime
      • Manga
    • Anime & Manga Lists
      • Pagination Support
  • Club
    • Main Information
    • User List

View RoadMap

Running Tests

composer require jikan-me/jikan --dev

This will download Fixtures as well.

PHPUnit

php vendor/bin/phpunit

GrumPHP

PHPCS, PHPLint & PHPUnit

php vendor/bin/grumphp run


Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Thank you to all our sponsors! You will recieve advertisement/promotive perks. [Become a sponsor]


Release Changelog

v2.8.0 - Apr 30, 19

  • [User List : Anime|Manga]
    • Throw BadResponseException instead of ParserException when the request fails #217
    • Add list filtering & sorting jikan-rest#49
    • Replace StudioMeta, LicensorMeta & MagazineMeta with MalUrl intead
      • This will further provide properties like type, url
  • [Search : Anime|Manga]

v2.7.0 - Apr 14, 19

  • [Anime|Manga]
    • EpisodeListItem aired property to return DateTimeImmutable instead of DateRange
    • [Bug Fix] Stats Score refactoring; returns AnimeStatsScore/MangaStatsScore object instead of array now - #216
    • Fix AnimeListItem/MangaListItem parsing date formats incorrectly
  • [Helper] fix parseDateMDY returning incorrect date
  • [Jikan.php]
    • fix PersonSearchincorrect Request class hinting
    • add UserMangaList
  • [MalClient.php]
    • getAnimeEpisodes with no episodes return empty episodes array now instead of BadResponseException (404)
    • getPersonSearch with no results returns empty array now instead of BadResponseException (404)
    • getCharacterSearch with no results returns empty array now instead of BadResponseException (404)
    • getCharacter returns BadResponseException (404) now if invalid ID is provided
    • Fix guzzle dep injection being overriden in some cases
  • [User]
    • Fix UserProfileParser's getUsername() returning the URL instead of the username
  • Added default values to some models
  • Other minor code and bug fixes

Read More

DISCLAIMER

  • Jikan is not affiliated with MyAnimeList.net
  • You are responsible for the usage of this API. Please be respectful towards MyAnimeList's Terms Of Service
You can’t perform that action at this time.