jikan-me / jikan

v5.0.0-rc.2 2026-10-15 19:53 UTC

Requires

• php: ^8.4.4
• ext-json: *
• symfony/browser-kit: ^8.0
• symfony/clock: ^7.4 || ^8.0
• symfony/css-selector: ^8.0
• symfony/dom-crawler: ^7.4 || ^8.0
• symfony/http-client: ^8.0

Requires (Dev)

• brianium/paratest: ^7.3
• friendsofphp/php-cs-fixer: ^3.8
• infection/infection: ^0.35.7
• jikan-me/jikan-fixtures: dev-master
• php-parallel-lint/php-parallel-lint: ^1.4
• phpro/grumphp: ^2
• phpstan/phpstan: ^2.3

MIT

• Nekomata

Published on Packagist.org on 2026-10-15 19:53 UTC

README

Jikan - Unofficial MyAnimeList.net PHP API

Jikan is a PHP API for MyAnimeList.net. It scrapes the website to satisfy the need for API functionality that MyAnimeList.net 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.

Status: active development is on master — the v5 line, currently 5.0.0-rc.2. The v4 line is end of life and no longer supported. Jikan is a PHP library, not a hosted service; a self-hosted REST API exists as a separate project.

Getting Started

Version	Support	PHP	Lumen/Laravel
^5 (master · 5.0.0-rc.2)	🚧 Release candidate · API frozen, bug fixes only		^11,^12
^4	❌ End of life — no longer supported		^9,^10
^3	❌ No longer maintained or supported		^8, ^9
^2	❌ No longer maintained or supported		^6
~1	❌ No longer maintained or supported		5.5.*

1. composer require jikan-me/jikan "^5.0@RC"
2. Coming from v4? Read the upgrade guide.
3. Read the Repository docs below — this repo holds the canonical documentation.

Repository docs

• Contributing — the endpoint spine, hermetic-fixture workflow, pre-commit gates
• Changelog — what changed per version, written for consumers
• Upgrading from v4 — what to change in your code, checked against a side-by-side run of both versions
• Decision log — why things are the way they are
• Deprecations — the running deprecation ledger
• API standard — conventions every public entry point must follow

Usage

use Jikan\MyAnimeList\MalClient;
use Jikan\Request\Anime\AnimeRequest;
use Jikan\Request\Search\AnimeSearchRequest;

$client = new MalClient(); // or new MalClient(HttpClientInterface $http) to inject the client

$anime = $client->getAnime(new AnimeRequest(1));          // Cowboy Bebop
$results = $client->getAnimeSearch(new AnimeSearchRequest())->getResults();

Every public endpoint is one MalClient method taking one Jikan\Request\* value object; the method list, the class-per-endpoint surface, and the conventions each must follow are documented in readme (conceptually), API-STANDARD.md (requirements) and CONTRIBUTING.md §3 (how to add one). The full machine-readable catalog lives in llm.txt (and .backend-suite/endpoints.json) — derived, regenerated with composer endpoints:write. On every change that touches the surface, run composer endpoints:write and composer endpoints:check.

REST API (self-hosted)

The library powers a separate, self-hostable REST API project: jikan-me/jikan-rest.

No hosted/public instance of the REST API is provided.

Wrappers

Language	Wrappers
JavaScript	JikanJS by Zuritor
Java	Jikan4java by Doomsdayrs reactive-jikan by Sandro Marques Jaikan by ShindouMihou
Python	JikanPy by Abhinav Kasamsetty
Deno	Jikan.js by RPDJF
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
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

View RoadMap

Running Tests

composer quality   # everything at once: php-cs-fixer dry-run + endpoint-manifest check + tests
composer test      # PHPUnit via paratest — hermetic against recorded fixtures

Quality gates run automatically on every commit (grumphp: php-cs-fixer, php-parallel-lint, git blacklist, paratest; plus the backend-suite error_handling/test_network_coupling audits). The same composer quality gate is enforced in CI. Full workflow: CONTRIBUTING.md.

Backers

A huge thank you to all our Patrons! 🙏 This project wouldn't be running without your support.

If you'd like to support the project, you can become a Patron!

Sugoi (すごい) Patrons

• Jared Allard (jaredallard)
• hugonun (hug_onun)

Patrons

• Aaron Treinish
• Abdelhafid Achtaou
• Aika Fujiwara
• Bobby Williams
• Cesar Irad Mendoza
• CrafterSama
• Fro116
• Jason Weatherly
• Jesse
• Kundan Chintamaneni
• Kururin
• Purplepinapples
• Ryo Ando
• Sakamotodesu
• TeraNovaLP

Development

	Jikan's development is powered by JetBrain's Open Source License

A shoutout to their amazing products and for supporting Jikan since early versions!

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