API - christopher-dG/unnoticed GitHub Wiki

A public HTTP endpoint is provided for retrieving scores. It can be used like so:

• GET https://p9bztcmks6.execute-api.us-east-1.amazonaws.com/unnoticed/proxy?b=BEATMAP_ID
• GET https://p9bztcmks6.execute-api.us-east-1.amazonaws.com/unnoticed/proxy?b=ID1,ID2,ID3

If you're retrieving scores for multiple beatmaps, please make an effort to use the second form.

The response body comes in JSON format:

{
  "info": "",  # Might contain some extra info about errors
  "error": "",  # Fatal errors
  "nscores": 1,  # Number of retrieved scores
  "scores": {  # Contains one entry per beatmap
    "1181750": [  # Key is the beatmap ID in string form
      {
        "player_id": 1,  # Player's user ID
        "mode": 0,  # Game mode (0=Standard, 1=Taiko, 2=CTB, 3=Mania)
        "player": "username",  # Player's username
        "n300": 682,  # 300s
        "n100": 36,  # 100s in Standard, 150s in Taiko, 100s in CTB, 200s in Mania
        "n50": 1,  # 50s in Standard, small fruit in CTB, 50s in Mania
        "ngeki": 112,  # Gekis in Standard, Max 300s in Mania
        "nkatu": 16,  # Katus in Standard, 100s in Mania
        "nmiss": 8,  # Misses
        "score": 6159390,  # Total score
        "combo": 502,  # Max combo
        "fc": false,  # Perfect combo (missed sliderends turn this false)
        "mods": 0,  #  Bitwise combination of mods (https://github.com/ppy/osu-api/wiki#mods)
        "date": 1492835820,  # Unix timestamp of the play date
        "outdated": false,  # true if the beatmap was modified after this play
        "pp": 103.2453284323  # null if pp could not be calculated (Taiko, modded Mania and modded CTB)
      }
    ]
  }
}

Note that there is no limit on the number of scores by the same player that can be returned. Additionally, the beatmap ID keys inside scores are strings rather than integers (more information on why here).