MarvelRivalsAPI.com
  1. Player Stats
MarvelRivalsAPI.com
  • Introduction
  • Get Started
    • Authentication
    • Rate Limits
    • Errors
      • Status Codes
    • SDKs & Extentions
      • Community Libraries
  • Endpoints
    • Achievements
      • List achievements
      • Search achievement
    • Patch Notes
      • List balances
      • Search balance
      • List dev diaries
      • Search dev diary
      • List patch notes
      • Search patch note
      • List game versions
    • Battle Pass
      • Battlepass
    • Heroes
      • List Heroes
      • Search hero
      • Hero stats
      • Hero leaderboard
      • List costumes
      • Search hero costume
    • Items
      • List items
      • Search item
    • Maps
      • List maps
      • Search map
    • Player Match History
      • Search match
      • Player match history
      • Player match history v2
    • Player Stats
      • Search player
        GET
      • Player stats
        GET
      • Player stats v2
        GET
      • Update player
        GET
      • Player Leaderboard
        GET
  1. Player Stats

Player Leaderboard

GET
/api/v2/players/leaderboard
Player Stats
Maintainer:Alastor
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marvelrivalsapi.com/api/v2/players/leaderboard?page=&limit=&device=&season='
Response Response Example
{
    "page": 1,
    "limit": 25,
    "total_players": 500,
    "total_pages": 20,
    "players": [
        {
            "score": 2205113,
            "uid": "1362318547",
            "name": "pølly",
            "icon": {
                "player_icon_id": "31022203",
                "player_icon": "/players/heads/player_head_31022203.png"
            },
            "rank": {
                "rank": {
                    "rank": "Eternity",
                    "image": "/ranked/eternity.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "68.9%",
                "max_level": 23,
                "rank_score": 5113.6921849402,
                "protect_score": 0,
                "diff_score": 16.227694418965,
                "season_number": 2,
                "win_count": 73,
                "level": 22,
                "max_rank_score": 5113.6921849402,
                "season_max_level": 23,
                "battle_count": 106
            }
        },
        {
            "score": 2205109,
            "uid": "189146510",
            "name": "рokey",
            "icon": {
                "player_icon_id": "31016204",
                "player_icon": "/players/heads/player_head_31016204.png"
            },
            "rank": {
                "rank": {
                    "rank": "Eternity",
                    "image": "/ranked/eternity.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "65.7%",
                "max_level": 23,
                "rank_score": 5109.0443056035,
                "protect_score": 0,
                "diff_score": 12.498423710025,
                "season_number": 2,
                "win_count": 90,
                "level": 22,
                "max_rank_score": 5109.0443056035,
                "season_max_level": 23,
                "battle_count": 137
            }
        },
        {
            "score": 2205103,
            "uid": "1822797559",
            "name": "cооper",
            "icon": {
                "player_icon_id": "31038204",
                "player_icon": "/players/heads/player_head_31038204.png"
            },
            "rank": {
                "rank": {
                    "rank": "One Above All",
                    "image": "/ranked/one_above_all.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "72%",
                "max_level": 23,
                "rank_score": 5103.0905286786,
                "protect_score": 0,
                "diff_score": 11.902376239289,
                "season_number": 2,
                "win_count": 90,
                "level": 23,
                "max_rank_score": 5103.0905286786,
                "season_max_level": 23,
                "battle_count": 125
            }
        },
    ]
}

Request

Query Params
page
integer 
optional
The page number for pagination. Defaults to 1 if not specified.
limit
integer 
optional
The number of items per page. Defaults to 25 if not specified.
device
string 
optional
Filter results by device platform (pc
season
string 
optional
The season to filter results by (0

Responses

🟢200Success
application/json
Body
The leaderboard object
page
integer 
required
The current page
limit
integer 
required
The current limit
total_players
integer 
required
The total amout of players in the leaderboard
total_pages
integer 
required
The total amount of pages
players
array [object {5}] 
required
The player object
score
integer 
required
The players score
uid
string 
required
The players UID
name
string 
required
The players name
icon
object 
required
The players icon
rank
object 
required
The players rank
Modified at 2025-07-24 14:12:33
Previous
Update player
Built with