rl404 / mal-scraper-api
Very easy and simple REST API setup get MyAnimeList.net data by using my Mal-Scraper as data parser.
Installs: 4
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 1
Forks: 1
Open Issues: 0
Type:project
Requires
- rl404/mal-scraper: ~1.0
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
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
git clone https://github.com/rl404/MAL-Scraper-API.git
cd MAL-Scraper-API
composer install
- That's it.
With Docker
git clone https://github.com/rl404/MAL-Scraper-API.git
cd MAL-Scraper-API
docker-compose up
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