rl404/mal-scraper-api

This package is abandoned and no longer maintained. No replacement package was suggested.

Very easy and simple REST API setup get MyAnimeList.net data by using my Mal-Scraper as data parser.

dev-master 2020-06-29 02:25 UTC

This package is not auto-updated.

Last update: 2020-07-03 13:44:22 UTC


README

Go here for a better and more updated version.

MAL-Scraper-API 68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344352e342d3838393242462e737667 StyleCI Status Codacy Status Scrutinizer Score License

Easy setup, Easy use, Easy life

Mal-Scraper-API is a very easy and simple REST API setup to get MyAnimeList.net data by using my Mal-Scraper as data parser.

Features

  • Get general information of anime, manga, charater (from anime and manga), or people (voice actor, author, staff, etc)
  • Get additional information of anime or manga character and staff, statistic and score, or picture
  • Get list of anime or manga of selected studio/producer, magazine, or genre
  • Get list of all anime or manga genre, anime studio/producer or manga magazine
  • Get list of character and staff involved in an anime or manga
  • Get result of searching, anime, manga, character, people or user (pagination supported)
  • Get seasonal anime
  • Get list of top anime from various categories (all, airing, upcoming, etc) (pagination supported)
  • Get list of top manga from various categories (all, manga, novel, etc) (pagination supported)
  • Get list of most favorited character and people (pagination supported)
  • Get information of user profile, friends, history, and anime/manga list
  • Caching (using Simple-PHP-Cache library) (data cached for 1 day as default)
  • Return with HTTP response
  • (Bonus) Get all anime/manga cover from user list
  • (Another bonus) htaccess included for easier call

More will be coming soon...

Installation

  1. git clone https://github.com/rl404/MAL-Scraper-API.git
  2. cd MAL-Scraper-API
  3. composer install
  4. That's it.

With Docker

  1. git clone https://github.com/rl404/MAL-Scraper-API.git
  2. cd MAL-Scraper-API
  3. docker-compose up
  4. http://localhost:8000 is ready to use.

Dependencies

  • PHP 5.4+
  • rl404/mal-scraper >= 1.3.0

Usage

General Methods

  • Info - Get anime or manga general information.
    • /info?t=anime&id=1
    • /info?t=manga&id=1
  • Character - Get anime or manga character information.
    • /character?id=1
  • People - Get person information.
    • /people?id=1
  • Studio/Producer - Get studio or producer information.
    • /studio-producer?id=1
    • /studioproducer?id=1
  • Magazine - Get list of books published by the magazine.
    • /magazine?id=1
  • Genre - Get list of anime or manga that has the genre.
    • /genre?t=anime&id=1
    • /genre?t=manga&id=1
  • Review - Get review of anime or manga.
    • /review?id=1
  • Recommendation - Get recommendation of anime or manga.
    • /recommendation?t=anime&id1=1&id2=205
    • /recommendation?t=manga&id1=1&id2=21

Additional Methods

  • Character and Staff - Get complete list of characters and staffs involved in anime or manga.
    • /character-staff?t=anime&id=1
    • /characterstaff?t=manga&id=1
  • Statistics - Get detail statistics information of anime or manga.
    • /stat?t=anime&id=1
    • /stat?t=manga&id=1
  • Pictures - Get list of additional anime or manga pictures.
    • /picture?t=anime&id=1
    • /picture?t=manga&id=1
  • Character Pictures - Get list of additional character pictures.
    • /character-picture?id=1
    • /characterpicture?id=1
  • People Pictures - Get list of additional people pictures.
    • /people-picture?id=1
    • /peoplepicture?id=1
  • Video - Get list of additional anime video list.
    • /video?id=1
    • /video?id=1&p=2
  • Episode - Get list of additional anime episode list.
    • /episode?id=1
    • /episode?id=1&p=2
  • Review - Get list of additional anime or manga review list.
    • /anime-review?id=1
    • /animereview?id=1&p=2
    • /manga-review?id=1
    • /mangareview?id=1&p=2
  • Recommendation - Get list of additional anime or manga recommendation list.
    • /anime-recommendation?id=1
    • /animerecommendation?id=1
    • /manga-recommendation?id=1
    • /mangarecommendation?id=1

List Methods

  • All Anime Genre - Get list of all anime genre.
    • /all-anime-genre
    • /allanimegenre
  • All Manga Genre - Get list of all manga genre.
    • /all-manga-genre
    • /allmangagenre
  • All Studio and Producer - Get list of all studio and producer.
    • /all-studio-producer
    • /allstudioproducer
  • All Magazine - Get list of all magazine.
    • /all-magazine
    • /allmagazine
  • All Review - Get list of all review.
    • /all-review?t=anime
    • /allreview?t=manga&p=2
  • All Recommendation - Get list of all recommendation.
    • /all-recommendation?t=anime
    • /allrecommendation?t=manga&p=2

Search Methods

  • Search Anime - Get list of anime search result.
    • /search-anime?q=clannad
    • /searchanime?q=clannad
  • Search Manga - Get list of manga search result.
    • /search-manga?q=berserk
    • /searchmanga?q=berserk
  • Search Character - Get list of character search result.
    • /search-character?q=luffy
    • /searchcharacter?q=luffy
  • Search People - Get list of people search result.
    • /search-people?q=hana
    • /searchpeople?q=hana
  • Search User - Get list of user search result.
    • /search-user?q=rl404
    • /searchuser?q=rl404

Seasonal Methods

  • Season - Get list of anime of the season.
    • /season
    • /season?y=2018
    • /season?s=spring
    • /season?s=summer
    • /season?s=winter
    • /season?s=fall
    • /season?s=spring&y=2017

Top List Methods

  • Top Anime - Get list of top anime.
    • /top-anime
    • /topanime
    • /topanime?p=2
    • /topanime?t=2
    • /topanime?t=3&p=4
  • Top Manga - Get list of top manga.
    • /top-manga
    • /topmanga
    • /topmanga?p=2
    • /topmanga?t=2
    • /topmanga?t=3&p=4
  • Top Character - Get list of most favorited character.
    • /top-character
    • /topcharacter
    • /topcharacter?p=2
  • Top People - Get list of most favorited people.
    • /top-people
    • /toppeople
    • /toppeople?p=2

User Methods

  • User - Get user profile information
    • /user?u=rl404
  • User Friends - Get list of user's friends.
    • /user-friend?u=r404
    • /userfriend?u=rl404
  • User History - Get list of user's anime or manga update history.
    • /user-history?u=rl404
    • /userhistory?u=rl404&t=anime
    • /userhistory?u=rl404&t=manga
  • User List - Get list of user's anime or manga.
    • /user-list?u=rl404
    • /userlist?u=rl404&t=anime
    • /userlist?u=rl404&t=manga
    • /userlist?u=rl404&st=1
    • /userlist?u=rl404&t=manga&st=2
  • User List Cover - Get CSS file for anime or manga list cover. Please go here for more info. And don't forget to convert your style to url using this.
    • /user-cover?u=rl404
    • /usercover?u=rl404&t=manga
    • /usercover?u=rl404&q=%23more%7Bid%7D+.borderRBL+div%7Bbackground-image%3Aurl%28%7Burl%7D%29%7D

For more information about the methods, params, and output, you can read the code by yourself (it should be easy to read and understand) or you can go to the wiki library.

Try it yourself

If you want to try, use mal-scraper.000webhostapp.com or mal-scraper.epizy.com/api as the domain.

Disclamer

All data (including anime, manga, people, etc) and MyAnimeList logos belong to their respective copyrights owners. Mal-Scraper does not have any affliation with content providers.

License

MIT License

Copyright (c) rl404