Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hanivan/restapi-samehadaku
Unofficial restAPI Samehadaku
https://github.com/hanivan/restapi-samehadaku
anime rest-api
Last synced: about 1 month ago
JSON representation
Unofficial restAPI Samehadaku
- Host: GitHub
- URL: https://github.com/hanivan/restapi-samehadaku
- Owner: Hanivan
- License: mit
- Created: 2022-01-27T08:36:15.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-06T07:30:41.000Z (over 2 years ago)
- Last Synced: 2023-03-11T08:33:54.654Z (almost 2 years ago)
- Topics: anime, rest-api
- Language: JavaScript
- Homepage: https://samehadaku-api.herokuapp.com/api/home
- Size: 62.5 KB
- Stars: 2
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Samehadaku restAPI
This rest api is unofficial. So I am not responsible if there is incomplete/broken data.
**All data taken from**: [Samehadaku](https://194.163.183.129)
**Hi! Check out the frontend I've made**: [Yamiweb](https://yamiweb.herokuapp.com/)
### TODO
- [x] Home (Anime This Season)
- [x] Ongoing
- [x] Pagination
- [x] Schedule
- [x] Genre
- [x] Anime By Genre With Pagination
- [x] Anime
- [x] Pagination
- [x] Detail
- [x] Batch
- [x] Episode List
- [x] Anime Movie
- [x] Detail
- [x] Episode List
- [x] Batch
- [x] Detail
- [x] Download Link
- [x] Detail Episode
- [x] Pagination Per Episode
- [x] Streaming Link
- [x] Download Episode & Batch Link
- [x] Season
- [x] Anime By Season With Pagination
- [x] Studio
- [x] Anime By Studio With Pagination
- [x] Producer
- [x] Anime By Producer With Pagination
- [x] Search
- [ ] Refactor Code Anime & Batch Detail Functions (If it is possible)
- [ ] Handle If host site is error/down
### Usage
1. Clone this repository
```bash
mkdir -p ~/Documents/git && git clone --depth=1 https://github.com/Hanivan/restAPI-Samehadaku.git ~/Documents/git/restAPI-Samehadaku && cd ~/Documents/git/restAPI-Samehadaku
```
2. Install packages (use `yarn` or `npm`)
```bash
yarn install
```
3. Start server
```bash
yarn start
```
or
```
yarn dev (for development)
```
### API Documentation
**API Path**: [https://samehadaku-api.herokuapp.com/api](https://samehadaku-api.herokuapp.com/api)
**API Version**: v1
| Endpoint | Params | Description |
| ---------------------------- | ------------- | ------------------------------------ |
| /home | - | Homepage (Current Season) |
| /anime | - | List All Anime |
| /anime/page/${page} | pageNumber | Anime Pagination |
| /anime/${id} | id | Detail Anime |
| /ongoing | - | List All Ongoing Anime |
| /ongoing/page/${page} | pageNumber | Ongoing Pagination |
| /movie | - | List All Anime Movie |
| /movie/page/${page} | pageNumber | Anime Movie Pagination |
| /genres | - | List All Genre |
| /genres/${id} | id | Show Anime by Genre |
| /genres/${id}/page/${page} | id,pageNumber | ~~ Anime by Genre With Pagination |
| /batch | - | List All Anime Batch |
| /batch/page/${page} | pageNumber | Batch Pagination |
| /batch/${id} | id | Detail Anime Batch |
| /eps/${id} | id | ~~ Anime Episode |
| /schedule | - | Schedule Anime |
| /studio/${id} | id | Show Anime by Studio |
| /studio/${id}/page/${page} | id,pageNumber | ~~ Anime by Studio With Pagination |
| /producer/${id} | id | Show Anime by Producer |
| /producer/${id}/page/${page} | id,pageNumber | ~~ Anime by Producer With Pagination |
| /season/${id} | id | ~~ Anime by Season |
| /season/${id}/page/${page} | id,pageNumber | ~~ Anime by Season With Pagination |
| /search/${query} | query | Search Anime |
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## Development Details
**Start Work**: Sunday, 16 January 2022; 16:-- WIB
**Finished Work**: Thursday, 27 January 2022; 15:-- WIB
**Absence**: Monday, 24 January 2022
**Reason**: Learn GoLang
Thank you [ Kaede-No-Ki/otakudesu-rest-api](https://github.com/Kaede-No-Ki/otakudesu-rest-api) for the inspiration to make this app
Tools I used for making this application:
- node-fetch & cheerio (Web Scrapper). [Tutorial](https://www.youtube.com/watch?v=z6jwIkkc7ro)
- express
- mathjs
- dotenv
- cors
- [Zippy-DL](https://github.com/anasrar/Zippy-DL) (For Bypass Stream Link With Some Modification)