Hero leaderboard

GET

/api/v1/heroes/leaderboard/{query}

Heroes

Maintainer:Alastor

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.

Request

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

Successful response with the hero leaderboard data

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/leaderboard/?platform' \
--header 'x-api-key;'

Response Example

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

Modified at 2025-07-23 14:35:31

Hero stats

List costumes