Hero leaderboard - MarvelRivalsAPI.com

This endpoint retrieves the leaderboard for a specific hero based on their name or ID, and allows filtering the leaderboard by platform (PC, PS, Xbox). The leaderboard data is fetched from an external API and processed for easy consumption.

{ "hero_name": "Ironman", "platform": "pc", "leaderboard": [ { "rank": 1, "player_name": "PlayerOne", "score": 10000, "platform": "pc" } ] }

Request

Path Params

query

string

required

The name or ID of the hero to fetch the leaderboard for.

Example:

ironman

Query Params

platform

enum<string>

optional

The platform for the leaderboard. Options are 'pc', 'ps', 'xbox'. If not provided, defaults to 'pc'.

Allowed values:

pcpsxbox

Example:

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 the hero leaderboard data

Body

hero_name

string

optional

The name of the hero.

Example:

Ironman

platform

string

optional

The platform for which the leaderboard is fetched.

Example:

leaderboard

array [object {4}]

optional

rank

integer

optional

The rank of the player on the leaderboard.

Example:

player_name

string

optional

The name of the player.

Example:

PlayerOne

score

integer

optional

The player's score.

Example:

10000

platform

string

optional

The platform of the player.

Example:

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error