Jikan - Unofficial MyAnimeList.net PHP API

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

• Goutte
• PHP 7.1+

Jikan REST API

A REST service is available as well.

• REST DOCUMENTATION
• Apps/Projects using JikanREST
• Host your own instance of Jikan REST

Wrappers

• [.NET] Jikan.net by Ervie
• [Python] JikanPy by Andrew Conant & Abhinav Kasamsetty
• [Ruby] Jikan.rb by Zerocchi
• [JavaScript] JikanJS by Zuritor
• [Java] Jikan4java by Doomsdayrs
• [PHP] jikan-php by Jan Vernieuwe
• [Node.js] jikan-node by xy137

Add your own 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)
• 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)
• Magazines (Manga Listing)
• 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

Changelog

v2.7.0 - Apr 14, 18

• [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