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

Language	Wrappers
JavaScript	JikanJS by Zuritor
Java	Jikan4java by Doomsdayrs reactive-jikan by Sandro Marques
Python	JikanPy by Abhinav Kasamsetty
Node.js	jikan-node by xy137 jikan-nodejs by ribeirogab
TypeScript	jikants by Julien Broyard jikan-client by Javier Blanco
PHP	jikan-php by Jan Vernieuwe
.NET	Jikan.net by Ervie
Elixir	JikanEx by Sean Breckenridge
Go	jikan-go by Daren Liang jikan2go by nokusukun
Ruby	Jikan.rb by Zerocchi
Dart	jikan-dart by Rafal Wachol
Kotlin	JikanKt by Ganedra Afrasya

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

apip-luki/jikan