jikan-me/jikan

Jikan is an unofficial MyAnimeList API

v1.15.9 2018-05-13 22:15 UTC

README

Jikan

Jikan - The Unofficial MyAnimeList.net PHP API

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

Jikan is a depenency free, 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

REST DOCUMENTATION

See which apps are using JikanREST

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.15.12 stable - May 16, 18

  • [Seasonal]
    • Add type for anime item type (e.g "TV", "Movie", etc) - 1.15.10
    • Add boolean continued for whether the TV show has been continuing from last season - 1.15.11
  • [Search]
    • Add support for NULL queries. Read more at issue #142
      • Only supported for ANIME and MANGA type searches

Read More

Usage

Contributions

I would like to thank these 3 for graciously hosting Jikan REST for free!

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