Skip to main content

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 for players by name

Response

players
array
Array of ranked players with their statistics
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
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.

Build docs developers (and LLMs) love