jikan-me/jikan

Jikan is an unofficial MyAnimeList API

v1.16.2 2018-07-02 20:04 UTC

README

Jikan

Jikan - The Unofficial MyAnimeList.net PHP API

build stable Average time to resolve an issue Percentage of issues still open stable Discord Server

Jikan is a PHP API with easy-to-use syntax that scrapes and parses requests from MyAnimeList.net.

The raison d'être of Jikan is to help 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. ;)

Getting Started

  1. composer require jikan-me/jikan
  2. Documentation

Jikan REST API REST PHP

If you don't want to handle PHP, you're in luck! Jikan has it's own RESTful API service (CORS enabled + JSON response) hosted by Hibiki

WARNING: BULK REQUESTS

If your use of the API is NOT for an app/bot/etc that makes consistent amount of requests but rather for the sake of making bulk requests, keep in mind to have a 4 second delay between EACH request otherwise your IP will be blacklisted.

Remember, you're not the only one using the API. Be responsible.

Wrappers

Contributions to Jikan by making wrappers in programming languages of your choice are much appreciated! Do let me know if you've made one and I'll include it here.

Features

  • Anime Parsing

    • Characters & Staff
    • Episodes
    • News
    • Videos/PV/Episodes
    • Pictures
    • Stats
    • Forum Topics
    • More Info
  • Manga Parsing

    • Characters
    • News
    • Stats
    • Pictures
    • Forum Topics
    • More Info
  • Character Parsing

    • Pictures
  • People Parsing

    • Pictures
  • Search (Anime/Manga/Character/Person)

    • Filters (Advanced Search)
    • Pagination Support
    • No.# of pages
  • Seasonal Anime (Season + Year)

  • Anime Scheduling (for current season)

  • Top

    • Anime
    • Manga
    • Sub Types & Pagination Support
  • Modular scraping methods for developers to easily extend the API

  • JSON format! ლ( ͡⎚ ͜ʖ ͡⎚ ლ)

Roadmap

  • Most Favorited
    • Characters
    • People
  • User Profile
  • Command Line Usage
  • PThreads (Multi-threaded) Support (CLI ONLY!)

Changelog

1.16.2 stable - July 3, 17

  • Bug fix #163
  • Fix HTTP responses

Read More

Usage

Contributions

I would like to thank these people for hosting the Jikan REST service!

Dependencies

  • Guzzle

DISCLAIMER

  • Jikan is in no way affiliated with MyAnimeList.
  • I am not responsible for what you do with this library, so use it responsibly as per MyAnimeList's TOS
  • Use the REST API responsibly, bulk requesting data for building your own database/datasets is only allowed under conditions. Read More

Donate

If you found this useful, please feel free to donate to help with development!

Donate