Jikan - Unofficial MyAnimeList.net REST API

Jikan is a REST 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.

Index

• Getting Started
  • Requirements
  • 🐳 Docker
  • Installation Prerequisites
  • Installation
  • Configuration
  • Ignition
  • Configuring Cache Driver (optional)
  • Configuring Cache Method (optional)
  • Configuring Supervisord (optional)
• Troubleshooting
• Artisan Commands
• Information
• Wrappers
• Running Tests
• Backers
• Disclaimer

Getting Started

Requirements

• PHP

  ^7.4

• Composer
• Redis
• Supervisord (optional)

🐳 Docker

If you don't want to install it yourself, there are dockerized options available:

• JikanREST Docker by Fethi El Hassasna
• JikanDocerized by Zunjae

01. Installation Prerequisites

01A. Linux

This is specifically for Ubuntu, but other distributions should work similarly. 1. Install requirements: - Add PHP related packages:

sudo add-apt-repository -y ppa:ondrej/php

add-apt-repository

sudo apt install python-software-properties

sudo apt install software-properties-common

sudo apt update && sudo apt upgrade

sudo apt install curl git php redis unzip

php -v

sudo apt install php7.4

sudo update-alternatives --set php /usr/bin/php7.4

php-xml

php-mbstring

sudo apt install php7.4-xml php7.4-mbstring

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

sudo service redis start

01B. Mac

1. Install brew
2. Install requirements:

   brew install php composer redis

3. Start the redis server:

   brew services start redis

02. Installation

1. git clone https://github.com/jikan-me/jikan-rest.git

2. cd jikan-rest

3. cp .env.dist .env

4. composer install

   (Make sure Jikan's directory has write permissions)

03. Configuration

You're able to configure Jikan through the

.env

artisan

The first thing you need to do is generate an

APP_KEY

1. php artisan key:generate

2. Configure how Jikan caches
3. Configure how Jikan handles expired cache

04. Ignition

php artisan serve --port=8080

php -S localhost:8000 -t public

Jikan is now hosted on

http://localhost:8000/v3/

Alternatively, host it on Apache (or Nginx)

Create a virtual host and point it to

/public

/public

sudo a2enmod rewrite

/etc/apache/apache2.conf

AllowOverride None

AllowOverride All

/var/www

:information_source: If you wish to configure it for Nginx or anything else, you'll have to port the rewrite rules located at

public/.htaccess

05. Configuring how Jikan Caches (optional)

Jikan caches on file by default in

/storage/framework/cache

However, you can configure Jikan to cache on Redis instead:

php artisan cache:driver redis

Note: If you're currently running Jikan, you're required to stop it before running the above command.

06. Configuring how Jikan handles expired cache (optional)

Jikan handles cache in the

legacy

06A. Cache Method: Legacy

When a cache expires, it gets deleted. So if you make a request that has an expired cache, your request will take longer as Jikan has to fetch and parse the new data from MyAnimeList again.

06B. Cache Method: Queue

This is a newly introduced caching method to the API, it's what the public API runs on as well. It requires some further setup.

When a cache expires, it does not get deleted. Instead, if you make a request that has an expired cache, a job will be dispatched to the queue which handles updating the cache in the background. Therefore, the request will keep on providing stale cache until the job is complete and the cache is replaced with fresh data.

This method provides zero delay, and is highly recommended if you have immense traffic coming your way.

:information_source: Note: If you're currently running Jikan, you're required to stop it before running the above command. You're also required to clear any cache you've stored as well as anything on the Redis server.

1. php artisan cache:method queue

Next, you need to make sure that there's a service looking after the queue. This can be manually done by running a process through

php artisan queue:work --queue=high,low

But a recommended way is to install Supervisor and have it handle the queue automatically.

:informationsource: Note:

--queue=high,low

:informationsource: Note 2: Not all requests are queuable. Some are handled the

legacy

This reason for this is quite simple. User related requests such as anime/manga list can be frequently updated. They're cached by default for 5 minutes (you can change this in

.env

:information_source: Note 3: Note 1 & Note 2 are default behavior. You can obviously change them as per your needs.

Configuring Supervisord

Linux

1. Install supervisor
   • Linux:

     sudo apt install supervisor

   • Mac:

     brew install supervisor

2. sudo cp conf/supervisor/jikan-worker.conf /etc/supervisor/conf.d

   • A default supervisor configureation file is available in this repo

     conf/supervisor/jikan-worker.conf

   • Be sure to update to the correct directory in

     jikan-worker.conf

     for

     command

     and

     stdout_logfile

     to the directory of jikan!

Example: If I install Jikan in

/var/www/jikan-is-installed-here

jikan-worker.conf

...
command=php /var/www/jikan-is-installed-here/artisan queue:work --queue=high,low
...
stdout_logfile=/var/www/jikan-is-installed-here/storage/logs/worker.log
stderr_logfile=/var/www/jikan-is-installed-here/storage/logs/worker.error.log

1. sudo supervisorctl reread

2. sudo supervisorctl update

3. sudo supervisorctl start jikan-worker:*

Mac

1. Install Supervisor:

   brew install supervisor

2. supervisord -c /usr/local/etc/supervisord.ini

3. Copy

   conf/supervisor/jikan-worker.conf

   to

   /usr/local/etc/supervisor.d/

4. brew services start supervisor

5. sudo supervisorctl update

6. sudo supervisorctl start jikan-worker:*

Troubleshooting

Please read the troubleshooting guide. For any additional help, join our Discord server.

Artisan Commands

Please read the commands guide. For any additional help, join our Discord server.

Information

If you don't want to host your instance, there's a public API available.

• REST DOCUMENTATION
• Apps/Projects using JikanREST

Wrappers

See the list of wrappers here

Running Tests

php vendor/bin/phpunit tests

Note: Tests may fail due to rate limit from MyAnimeList (HTTP 429)

Backers

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

We have a free REST API service, if you wish to support us you can become a Patron!

Sugoi (すごい) Patrons

• Jared Allard (jaredallard)
• hugonun (hug_onun)

Patrons

• Aaron Treinish
• Cesar Irad Mendoza
• Jason Weatherly
• Jesse
• Kundan Chintamaneni
• Kururin
• Purplepinapples
• 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