v1
maiscoreは、楽曲データやユーザーのスコアデータを取得できるAPIを提供しています。 本APIは個人利用・非商用利用を目的としたものであり、過度なアクセスやスクレイピングは禁止されています（利用規約をご確認ください）。
APIへのリクエストは、ホスト maiscore.net に対して、必ず HTTPS で行ってください。
IPアドレスごとに 10回/分、API全体で 500回/分 のリクエスト制限があります。 制限を超えた場合は 429 Too Many Requests が返却されます。
いずれのGETエンドポイントも、URLをWebブラウザのアドレスバーに直接入力して結果を確認できます。
公開プロフィール（visibility が PUBLIC）のユーザーに関する情報は、認証なしで取得できます。
非公開（PRIVATE）に設定したユーザー自身のデータを取得する場合は、 APIトークンを Authorization: Bearer <token> ヘッダーに付与してください。 APIトークンは ヘルプページ から確認できます。
/api/v1/music/show
指定した楽曲の情報と、各難易度の譜面情報を取得します。
id (必須)
楽曲ID（maiscoreの内部楽曲ID）
GET /api/v1/music/show?id=dx_3012b0903feb6e15
{
"data": {
"BAS": { "level": 4, "const": 4, "maxcombo": 356, "is_const_unknown": false },
"ADV": { "level": 8, "const": 8, "maxcombo": 621, "is_const_unknown": false },
"EXP": { "level": 12.5, "const": 12.5, "maxcombo": 1041, "is_const_unknown": false },
"MAS": { "level": 14, "const": 14, "maxcombo": 1225, "is_const_unknown": false }
},
"meta": {
"id": "dx_3012b0903feb6e15",
"title": "Ref:rain (for 7th Heaven)",
"genre": "maimai",
"artist": "カモメサノエレクトリックオーケストラ include Limonène",
"release": null,
"bpm": "188",
"kind": "dx",
"version": "PRiSM PLUS",
"imageHash": "3012b0903feb6e15"
}
}data の各キー（BAS / ADV / EXP / MAS / ReMAS）は、それぞれ Basic / Advanced / Expert / Master / Re:Master の譜面情報を表します。該当する難易度の譜面が存在しない場合、そのキーは含まれません。 const は精密なレベル値（不明な場合は null、その場合 is_const_unknown が true）、maxcombo は譜面のノーツ総数です。
/api/v1/music/showall
登録されている全楽曲の情報を、各難易度の譜面情報を含めて一括取得します。
GET /api/v1/music/showall
[
{
"data": {
"BAS": { "level": 6, "const": 6, "maxcombo": 298, "is_const_unknown": false },
"ADV": { "level": 9, "const": 9, "maxcombo": 451, "is_const_unknown": false },
"EXP": { "level": 12.9, "const": 12.9, "maxcombo": 713, "is_const_unknown": false },
"MAS": { "level": 14.8, "const": 14.8, "maxcombo": 1103, "is_const_unknown": false }
},
"meta": {
"id": "dx_48447c3e67a26b08",
"title": "ℝ∈Χ LUNATiCA",
"genre": "maimai",
"artist": "Kai",
"release": null,
"bpm": "230",
"kind": "dx",
"version": "BUDDiES PLUS",
"imageHash": "48447c3e67a26b08"
}
},
...
]/api/v1/records/profile
指定したユーザーのプロフィール情報を取得します。
user (必須)
ユーザー名 または ユーザーID
GET /api/v1/records/profile?user=nowadays
{
"numberId": 1,
"username": "nowadays",
"gameName": "ｍａｉｓｃｏｒｅ",
"title": "私たちの、青春の物語を！！",
"titleColor": "gold",
"dxRating": 15672,
"playCount": 1182,
"currentVersionPlayCount": 246,
"danLabel": "十段",
"classLabel": "B4",
"updatedAt": "2026-06-20T09:42:11.583Z"
}/api/v1/records/dxrating.json
指定したユーザーのDXレーティング対象楽曲（BEST 35・NEW 15）と、その合計レーティングを取得します。
user (必須)
ユーザー名 または ユーザーID
GET /api/v1/records/dxrating.json?user=nowadays
{
"best": [
{
"songId": "dx_11f607f1a79a3165",
"title": "SUPER AMBULANCE",
"artist": "AJURIKA",
"difficulty": "master",
"kind": "dx",
"level": "14",
"levelValue": 14.3,
"score": 1006286,
"dxScore": 2876,
"fc": "",
"fs": "Sync",
"imageHash": "11f607f1a79a3165",
"version": "FESTiVAL",
"rating": 321
},
...
],
"new": [
{
"songId": "dx_a9567047ac19c427",
"title": "キスキツネ",
"artist": "HIMEHINA",
"difficulty": "master",
"kind": "dx",
"level": "13+",
"levelValue": 13.8,
"score": 1007312,
"dxScore": 2102,
"fc": "FCp",
"fs": "FSp",
"imageHash": "a9567047ac19c427",
"version": "CiRCLE PLUS",
"rating": 310
},
...
],
"ratingSum": 15672,
"bestSum": 11023,
"newSum": 4649
}/api/v1/records/showall
指定したユーザーの全楽曲・全難易度のスコアを取得します。
user (必須)
ユーザー名 または ユーザーID
GET /api/v1/records/showall?user=nowadays
{
"records": [
{
"songId": "dx_11f607f1a79a3165",
"title": "SUPER AMBULANCE",
"artist": "AJURIKA",
"difficulty": "master",
"kind": "dx",
"level": "14",
"levelValue": 14.3,
"score": 1006286,
"dxScore": 2876,
"fc": "",
"fs": "Sync",
"imageHash": "11f607f1a79a3165",
"version": "FESTiVAL",
"rating": 321
},
...
]
}各フィールドの意味は /api/v1/records/dxrating.json の best / new 配列内の要素と同じです。
これらのAPIは予告なく変更・廃止される場合があります。継続的に利用するシステムを構築する場合はご注意ください。