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 stats

GET
/api/v1/player/{query}
Player StatsFreePremium
Maintainer:Alastor
This endpoint retrieves player data for a specific player identified by uid or username.
IMPORTANT: Searching player stats by username is a new feature and is not always reliable. Searching player stats by player uid is more stable.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marvelrivalsapi.com/api/v1/player/?season' \
--header 'x-api-key;'
Response Response Example
200 - Success
{
    "uid": 543511984,
    "name": "ToernB",
    "updates": {
        "info_update_time": "5/7/2025, 3:29:57 PM",
        "last_history_update": "7/22/2025, 7:32:54 AM",
        "last_inserted_match": "7/22/2025, 6:50:22 AM",
        "last_update_request": "7/22/2025, 2:03:19 PM"
    },
    "player": {
        "uid": 543511984,
        "level": "43",
        "name": "ToernB",
        "icon": {
            "player_icon_id": "31027204",
            "player_icon": "/players/heads/player_head_31027204.png"
        },
        "rank": {
            "rank": "Silver II",
            "image": "/ranked/silver.png",
            "color": "#7B9196"
        },
        "team": {
            "club_team_id": "934_80",
            "club_team_mini_name": "TWOFID",
            "club_team_type": "0"
        },
        "info": {
            "completed_achievements": "102",
            "login_os": "PC",
            "rank_game_season": {
                "1001001": {
                    "rank_game_id": 1,
                    "level": 10,
                    "rank_score": 3894.3651498707495,
                    "max_level": 10,
                    "max_rank_score": 3999.657859194941,
                    "update_time": 1736452160,
                    "win_count": 96,
                    "protect_score": 0,
                    "diff_score": -11.9277523497949
                },
                "1001002": {
                    "rank_game_id": 2,
                    "level": 11,
                    "rank_score": 4007.0633661602137,
                    "max_level": 12,
                    "max_rank_score": 4111.801296371733,
                    "update_time": 1739993667,
                    "win_count": 112,
                    "protect_score": 0,
                    "diff_score": -21.95033149810024
                },
                "1001003": {
                    "rank_game_id": 3,
                    "level": 13,
                    "rank_score": 4229.917649646161,
                    "max_level": 13,
                    "max_rank_score": 4229.917649646161,
                    "update_time": 1742684552,
                    "win_count": 9,
                    "protect_score": 0,
                    "diff_score": 33.70900847638222
                },
                "1001004": {
                    "rank_game_id": 4,
                    "level": 8,
                    "rank_score": 3680.757168414914,
                    "max_level": 8,
                    "max_rank_score": 3738.8533679365632,
                    "update_time": 1747238399,
                    "win_count": 29,
                    "protect_score": 0,
                    "diff_score": -21.507109301622677
                },
                "1001005": {
                    "rank_game_id": 5,
                    "level": 7,
                    "rank_score": 3645.419398799876,
                    "max_level": 8,
                    "max_rank_score": 3758.8646823447457,
                    "update_time": 1751639090,
                    "win_count": 8,
                    "protect_score": 2,
                    "diff_score": -22.433479474959313
                },
                "1001006": {
                    "rank_game_id": 6,
                    "level": 5,
                    "rank_score": 3440.2259335209114,
                    "max_level": 5,
                    "max_rank_score": 3441.7012746847704,
                    "update_time": 1753182074,
                    "win_count": 20,
                    "protect_score": 3,
                    "diff_score": 32.19930621460708
                }
            }
        }
    },
    "isPrivate": false,
    "overall_stats": {
        "total_matches": 55,
        "total_wins": 20,
        "unranked": {
            "total_matches": 0,
            "total_wins": 0,
            "total_assists": 0,
            "total_deaths": 0,
            "total_kills": 0,
            "total_time_played": "0m 0s",
            "total_time_played_raw": 0,
            "total_mvp": 0,
            "total_svp": 0
        },
        "ranked": {
            "total_matches": 55,
            "total_wins": 20,
            "total_assists": 266,
            "total_deaths": 458,
            "total_kills": 867,
            "total_time_played": "9h 39m 40s",
            "total_time_played_raw": 34780.11118102074,
            "total_mvp": 0,
            "total_svp": 3
        }
    },
    "match_history": [
        {
            "match_uid": "6711581_1753181422_1272091_11001_22",
            "map_id": 1272,
            "map_thumbnail": "/rivals/maps/map_1272.png",
            "duration": 480.09607696533203,
            "season": 5,
            "winner_side": 1,
            "mvp_uid": 2081021746,
            "svp_uid": 1364024944,
            "match_time_stamp": 1753182074,
            "play_mode_id": 0,
            "game_mode_id": 2,

Request

Path Params
query
string 
required
The unique identifier of the player (could be uid or username).
Example:
player1234
Query Params
season
integer 
optional
The season number for which the stats are retrieved (defaults to season 1).
Example:
2
Header Params
x-api-key
string 
required
The API key for authorization. It is necessary to provide a valid API key to access the data.
Example:
your-api-key-here

Responses

🟢200OK
application/json
Successful response with player data
Body
uid
integer 
required
The unique identifier for the player.
name
string 
required
The player's name.
updates
object 
required
Information about the player's updates.
info_update_time
string 
required
last_history_update
string 
required
last_inserted_match
string 
required
last_update_request
string 
required
player
object 
required
The processed player data.
uid
integer 
required
level
string 
required
name
string 
required
icon
object 
required
rank
object 
required
team
object 
required
info
object 
required
player_id
string 
optional
The player ID.
Example:
player1234
nickname
string 
optional
The player's nickname.
Example:
Player One
isPrivate
boolean 
optional
Whether the player's profile is private.
Example:
false
isPrivate
boolean 
required
overall_stats
object 
required
The overall statistics of the player.
total_matches
integer 
required
total_wins
integer 
required
unranked
object 
required
ranked
object 
required
match_history
array [object {19}] 
required
List of the player's match history.
match_uid
string 
required
map_id
integer 
required
map_thumbnail
string 
required
duration
number 
required
season
integer 
required
winner_side
integer 
required
mvp_uid
integer 
required
svp_uid
integer 
required
match_time_stamp
integer 
required
play_mode_id
integer 
required
game_mode_id
integer 
required
score_info
object 
required
player_performance
object 
required
match_id
string 
optional
The unique identifier for the match.
Example:
match123
date
string 
optional
The date the match was played.
Example:
2024-02-10T15:30:00Z
result
string 
optional
The result of the match (e.g., win, loss).
Example:
win
kills
integer 
optional
The number of kills made by the player in the match.
Example:
5
deaths
integer 
optional
The number of deaths the player had in the match.
Example:
3
assists
integer 
optional
The number of assists made by the player in the match.
Example:
2
rank_history
array [object {6}] 
required
List of the player's rank history.
match_time_stamp
integer 
required
level_progression
object 
required
score_progression
object 
required
season
integer 
optional
The season number.
Example:
2
rank
string 
optional
The player's rank in the season.
Example:
Gold
points
integer 
optional
The points the player had in the season.
Example:
1500
hero_matchups
array [object {7}] 
required
The list of hero matchups for the player.
hero_id
integer 
required
The hero's unique ID.
hero_name
string 
required
hero_class
string 
required
hero_thumbnail
string 
required
matches
integer 
required
wins
integer 
required
win_rate
string 
required
The player's win rate with this hero.
team_mates
array [object {6}] 
required
The player's teammates in recent matches.
player_info
object 
required
matches
integer 
required
wins
integer 
required
win_rate
string 
required
teammate_id
string 
optional
The unique ID of the teammate.
Example:
player5678
nickname
string 
optional
The teammate's nickname.
Example:
Teammate One
heroes_ranked
array [object {15}] 
required
The player's ranked heroes.
hero_id
integer 
required
hero_name
string 
required
hero_thumbnail
string 
required
matches
integer 
required
wins
integer 
required
mvp
integer 
required
svp
integer 
required
kills
integer 
required
deaths
integer 
required
assists
integer 
required
play_time
number 
required
damage
number  | integer 
required
heal
integer  | number 
required
damage_taken
number  | integer 
required
main_attack
object 
required
heroes_unranked
array[string]
required
The player's unranked heroes.
maps
array [object {8}] 
required
Map statistics for the player.
map_id
integer 
required
map_thumbnail
string 
required
matches
integer 
required
wins
integer 
required
kills
integer 
required
deaths
integer 
required
assists
integer 
required
play_time
number 
required
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
🔴500Server Error
Modified at 2025-07-24 14:15:15
Previous
Search player
Next
Player stats v2
Built with