https://github.com/st4rchaser/maimaidx-songs-database
MaiMaiDX Songs Database is an API using ExpressJS
https://github.com/st4rchaser/maimaidx-songs-database
arcade arcade-game maimai maimai-dx maimaidx maimainet sega
Last synced: 10 days ago
JSON representation
MaiMaiDX Songs Database is an API using ExpressJS
- Host: GitHub
- URL: https://github.com/st4rchaser/maimaidx-songs-database
- Owner: ST4RCHASER
- License: gpl-3.0
- Created: 2020-10-25T13:40:57.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-01-07T05:04:50.000Z (almost 5 years ago)
- Last Synced: 2025-07-12T07:32:16.416Z (3 months ago)
- Topics: arcade, arcade-game, maimai, maimai-dx, maimaidx, maimainet, sega
- Language: JavaScript
- Homepage:
- Size: 117 KB
- Stars: 13
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MaiMaiDX Songs Database
MaiMaiDX Songs Database is an API using expressJS
### LiveServer (Heroku)
- You can use latest version at: https://maimaidx.herokuapp.com/maimai
### Response structure
The following JSON data is returned in the response body.
| Property | Description | Type |
| ------ | ------ | ------ |
| status | Give the result of the request that it's success or not. | Boolean |
| code | Request status code. | Integer |
| message | Message summary | String |
| jp_total | Total songs in japanese version | Intenger |
| en_total | Total songs in international version | Intenger |
| data | Provide useful data for processing | Any (Optional) |
### GET all songs
HTTP Request:
```sh
GET /songs
```
Example: https://maimaidx.herokuapp.com/maimai/songs
### Using filters
HTTP Request:
```sh
GET /songs?category=niconico&artist=livetune
#Search for Category niconicoボーカロイド and Artist kz(livetune)
GET /songs?title=PANDORA%20PARADOXXX
#Search for song PANDORA PARADOXXX only
```
Example:
https://maimaidx.herokuapp.com/maimai/songs?category=niconico&artist=livetune
https://maimaidx.herokuapp.com/maimai/songs?title=PANDORA%20PARADOXXX
### Available filters
Available filters can use in GET url
| Query | Description |
| ------ | ------ |
| title | Normal Song title |
| title_kana | Kana song title |
| artist | Artist name |
| category | Category name |
### Available category
Available category you can use in category fillter
| Value | Description |
| ------ | ------ |
| chunithm,ongeki | オンゲキCHUNITHM |
| touhou,touhou_project | 東方Project |
| pop,anime | POPSアニメ |
| niconico,vocaloid | niconicoボーカロイド |
| game,variety | ゲームバラエティ |
| maimai | maimai original |
### Video database
Feel free to help me add [video database (like chart music etc.)](https://github.com/ST4RCHASER/maimaidx-songs-database/blob/main/database/json/video.json) if you want to add you can make pull request i will migrate it!
Thanks for help me :3
### License
----
[GNU AGPL 3.0](https://www.gnu.org/licenses/agpl-3.0.en.html)