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

composer install
Documentation

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

Dependencies

Goutte
PHP 7.1-7.3

❗ PHP 7.4 is not fully tested yet.

Jikan REST API

A REST API service is available as well

Wrappers

[.NET] Jikan.net by Ervie
[Python] JikanPy by 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
[Node.js] jikan-nodejs by ribeirogab
[Dart] jikan-dart by Rafal Wachol
[TypeScript] jikants by Julien Broyard
[TypeScript] jikan-client by Javier Blanco
[Go] jikan-go by Daren Liang
[Elixir] JikanEx by Sean Breckenridge

Add your wrapper here

Features

Anime
- Main Information
- Characters & Staff
- Episodes
- Episode Details
- 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 Listing (All Anime by Genre)
- Anime Genre Listing (All Genres + metadata)
- Manga Listing (All Anime by Genre)
- Manga Genre Listing (All Genres + metadata)
Producer
- Anime Listing (All Anime by a Producer)
- Producers Listing (All Producers + metadata)
- Manga Listing (All Manga by a Producer)
- Magazines Listing (All Magazines + metadata)
User
- Profile
- Friends
  - Pagination support
- History
  - All
  - Anime
  - Manga
- Anime & Manga Lists
  - Pagination Support
Club
- Main Information
- User List

View RoadMap

Running Tests

PHPUnit

php vendor/bin/phpunit

GrumPHP

PHPCS, PHPLint & PHPUnit

php vendor/bin/grumphp run

Sugoi (すごい) Backers

Thank you to all our Sugoi (すごい) backers! 🙏 [Become a sugoi backer]

Backers

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

Sponsors

Thank you to all our sponsors! [Become a sponsor]

Hibiki Matsujo

Release Changelog

2.16.0 - Jan 27, 20

Added Top Reviews(Anime, Manga & Best Voted (includes both)) parsing #251

/**
 * Type Constants
 * Anime: \Jikan\Helper\Constants::TOP_REVIEW_ANIME
 * Manga: \Jikan\Helper\Constants::TOP_REVIEW_MANGA
 * Best Voted (Anime + Manga): \Jikan\Helper\Constants::TOP_REVIEW_BEST_VOTED
 */
$type = \Jikan\Helper\Constants::TOP_REVIEW_ANIME;
$page = 1;

$topReviews = $jikan->getTopReviews(
    new \Jikan\Request\Top\TopReviewsRequest($type, $page)
);

Bug fixes #249, #250, #259

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

AdityaAgrawal1 / jikan