Ranking endpoints

Access global and country player rankings, including medal rankings

Get Player Ranking

Retrieve paginated player rankings with optional country and search filters.

GET /ranking/:page

page · number · required

Page number for pagination (1-indexed)

country · string

Filter by country code (e.g., “US”, “GB”, “JP”)

search · string

Search for players by name

Response

players · array

Array of ranked players with their statistics

Show Player object

id · string

ScoreSaber player ID

name · string

Player name

rank · number

Global rank

countryRank · number

Country-specific rank

pp · number

Performance points

country · string

Country code

total · number

Total number of players matching the query

page · number

Current page number

Example Request

curl "https://ssr-api.fascinated.cc/ranking/1?country=US"

Example Response

{
  "players": [
    {
      "id": "76561198059961776",
      "name": "BaconEggs",
      "rank": 1,
      "countryRank": 1,
      "pp": 15234.56,
      "country": "US"
    }
  ],
  "total": 12500,
  "page": 1
}

Get Medal Ranking

Retrieve paginated medal rankings with optional country filter.

GET /ranking/medals/:page

page · number · required

Page number for pagination (1-indexed)

country · string

Filter by country code (e.g., “US”, “GB”, “JP”)

Response

players · array

Array of players ranked by medal count

Show Player object

id · string

ScoreSaber player ID

name · string

Player name

rank · number

Medal ranking position

countryRank · number

Country-specific medal rank

medals · number

Total medal count

country · string

Country code

total · number

Total number of players in the medal ranking

page · number

Current page number

Example Request

curl "https://ssr-api.fascinated.cc/ranking/medals/1?country=GB"

Example Response

{
  "players": [
    {
      "id": "76561198059961776",
      "name": "TopPlayer",
      "rank": 1,
      "countryRank": 1,
      "medals": 1250,
      "country": "GB"
    }
  ],
  "total": 8500,
  "page": 1
}

Medal rankings are calculated based on top 10 leaderboard positions. See the Medals feature documentation for how medals are earned.