Back to top

Chimu API

API V1

Resource Group

Get beatmap

Get beatmap
GET/v1/map/{map_id}

Gets a beatmap. if it fails it returns a simple JSON Serialized error including a message and error code.

Example URI

GET https://api.chimu.moe/v1/map/53
URI Parameters
HideShow
map_id
number (required) Example: 53

Beatmap Id

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "code": 0,
  "message": "",
  "data": {
    "BeatmapId": 53,
    "ParentSetId": 3,
    "DiffName": "-Crusin-",
    "FileMD5": "1d23c37a2fda439be752ae2bca06c0cd",
    "Mode": 0,
    "BPM": 172,
    "AR": 4,
    "OD": 4,
    "CS": 5,
    "HP": 3,
    "TotalLength": 83,
    "HitLength": 77,
    "Playcount": 101574,
    "Passcount": 47994,
    "MaxCombo": 124,
    "DifficultyRating": 1.86918,
    "OsuFile": "Ni-Ni - 1,2,3,4, 007 [Wipeout Series] (MCXD) [-Crusin-].osu",
    "DownloadPath": "/d/3"
  }
}
Response  404
HideShow
Headers
Content-Type: application/json
Body
null

Get beatmap set

Get beatmap set
GET/v1/set/{set_id}

Gets a beatmap set. if it fails it returns a simple JSON Serialized error including a message and error code.

Example URI

GET https://api.chimu.moe/v1/set/1
URI Parameters
HideShow
set_id
number (required) Example: 1

Beatmap set Id

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "code": 0,
  "message": "",
  "data": {
    "SetId": 1,
    "ChildrenBeatmaps": [
      {
        "BeatmapId": 75,
        "ParentSetId": 1,
        "DiffName": "Normal",
        "FileMD5": "a5b99395a42bd55bc5eb1d2411cbdf8b",
        "Mode": 0,
        "BPM": 119.999,
        "AR": 6,
        "OD": 6,
        "CS": 4,
        "HP": 6,
        "TotalLength": 142,
        "HitLength": 109,
        "Playcount": 467474,
        "Passcount": 57119,
        "MaxCombo": 314,
        "DifficultyRating": 2.40729,
        "OsuFile": "Kenji Ninuma - DISCO PRINCE (peppy) [Normal].osu",
        "DownloadPath": "/d/1"
      }
    ],
    "RankedStatus": 1,
    "ApprovedDate": "2007-10-06T17:46:31",
    "LastUpdate": "2007-10-06T17:46:31",
    "LastChecked": "2021-01-19T09:43:57",
    "Artist": "Kenji Ninuma",
    "Title": "DISCO PRINCE",
    "Creator": "peppy",
    "Source": "",
    "Tags": "katamari",
    "HasVideo": false,
    "Genre": 2,
    "Language": 3,
    "Favourites": 789,
    "Disabled": false
  }
}
Response  404
HideShow
Headers
Content-Type: application/json
Body
null

Download beatmap set

Download beatmap set
GET/v1/download/{set_id}

Downloads a beatmap set using given set id
NOTE: Chimu currently responses only with noVideo maps!

Example URI

GET https://api.chimu.moe/v1/download/1
URI Parameters
HideShow
set_id
number (required) Example: 1

Beatmap set Id

Response  200
HideShow
Headers
Content-Type: application/octet-stream
Response  400
HideShow
Headers
Content-Type: text/plain
Body
// Different type of errors
    "Malformed ID"
    "Could not fetch set"
    "Set not found"
    "The beatmap could not be downloaded right now"

Cheesegull> Get beatmap

Cheesegull> Get beatmap
GET/api/b/{map_id}

Gets a beatmap.

Example URI

GET https://api.chimu.moe/api/b/53
URI Parameters
HideShow
map_id
number (required) Example: 53

Beatmap Id

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "BeatmapID": 53,
  "ParentSetID": 3,
  "DiffName": "-Crusin-",
  "FileMD5": "1d23c37a2fda439be752ae2bca06c0cd",
  "Mode": 0,
  "BPM": 172,
  "AR": 4,
  "OD": 4,
  "CS": 5,
  "HP": 3,
  "TotalLength": 83,
  "HitLength": 77,
  "Playcount": 101574,
  "Passcount": 47994,
  "MaxCombo": 124,
  "DifficultyRating": 1.86918
}

Cheesegull> Get beatmap

Cheesegull> Get beatmap
GET/api/md5/{map_md5}

Gets a beatmap with specified md5 hash.

Example URI

GET https://api.chimu.moe/api/md5/1d23c37a2fda439be752ae2bca06c0cd
URI Parameters
HideShow
map_md5
string (required) Example: 1d23c37a2fda439be752ae2bca06c0cd

Beatmap md5

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "BeatmapID": 53,
  "ParentSetID": 3,
  "DiffName": "-Crusin-",
  "FileMD5": "1d23c37a2fda439be752ae2bca06c0cd",
  "Mode": 0,
  "BPM": 172,
  "AR": 4,
  "OD": 4,
  "CS": 5,
  "HP": 3,
  "TotalLength": 83,
  "HitLength": 77,
  "Playcount": 101574,
  "Passcount": 47994,
  "MaxCombo": 124,
  "DifficultyRating": 1.86918
}

Cheesegull> Get beatmapset

Cheesegull> Get beatmapset
GET/api/s/{set_id}

Gets a beatmap set.

Example URI

GET https://api.chimu.moe/api/s/1
URI Parameters
HideShow
set_id
number (required) Example: 1

Beatmapset Id

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "SetID": 1,
  "ChildrenBeatmaps": [
    {
      "BeatmapID": 75,
      "ParentSetID": 1,
      "DiffName": "Normal",
      "FileMD5": "a5b99395a42bd55bc5eb1d2411cbdf8b",
      "Mode": 0,
      "BPM": 119.999,
      "AR": 6,
      "OD": 6,
      "CS": 4,
      "HP": 6,
      "TotalLength": 142,
      "HitLength": 109,
      "Playcount": 467474,
      "Passcount": 57119,
      "MaxCombo": 314,
      "DifficultyRating": 2.40729
    }
  ],
  "RankedStatus": 1,
  "ApprovedDate": "2007-10-06T17:46:31Z",
  "LastUpdate": "2007-10-06T17:46:31Z",
  "LastChecked": "2021-01-19T09:43:57Z",
  "Artist": "Kenji Ninuma",
  "Title": "DISCO PRINCE",
  "Creator": "peppy",
  "Source": "",
  "Tags": "katamari",
  "HasVideo": false,
  "Genre": 2,
  "Language": 3,
  "Favourites": 789
}

Generated by aglio on 03 Apr 2022