Hero

GET https://marvelrivalsapi.com/api/v1/heroes/hero/:query

This endpoint allows you to fetch detailed information about a hero from the MarvelRivalsAPI. You can either provide the hero's name or ID to retrieve their stats, abilities, and other relevant details.

Headers

Name	Value
Content-Type	application/json
x-api-key*	YOUR API KEY

Query Parameters

Name	Type	Required	Description
query*	string	✔️	The name or ID of the hero to retrieve.

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl", {
        headers: {
            "x-api-key": "YOUR_API_KEY"
        }
    });
    console.log(response.data);
} catch (error) {
    console.error("Error fetching balances:", error.response ? error.response.data : error.message);
}

Python

import requests

url = "https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error {response.status_code}: {response.text}")

Java

import java.net.http.*;
import java.net.URI;
import java.io.IOException;

public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl"))
            .header("x-api-key", "YOUR_API_KEY")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

Response

200

{
    "id": "1011",
    "name": "hulk",
    "real_name": "Bruce Banner",
    "imageUrl": "/rivals/heroes/card/hulk.png",
    "role": "Vanguard",
    "attack_type": "Melee Heroes",
    "team": [
        "Avengers"
    ],
    "difficulty": "4",
    "bio": "Brilliant scientist Dr. Bruce Banner has finally found a way to coexist with his monstrous alter ego, the Hulk. By accumulating gamma energy over transformations, he can become a wise and strong Hero Hulk or a fierce and destructive Monster Hulk – a true force of fury on the battlefield!",
    "lore": "Caught in the detonation of a powerful weapon of his own invention, Dr. Bruce Banner absorbed gamma radiation that transforms him into a massive green monster whenever his emotions rage out of control. As Banner, he's still a genius. But as the Hulk, he's the strongest one there is!\nBanner developed a special Gamma Belt to control his transformations and temper the Hulk's fury. But when the Timestream Entanglement transformed Los Diablos Missile Base into a demonic battleground, he realized that the best way to fight monsters was to let out the one within.",
    "transformations": [
        {
            "id": "0",
            "name": "Bruce Banner",
            "icon": "/heroes/transformations/bruce-banner-headbig-0.webp",
            "health": "200",
            "movement_speed": "6m/s"
        },
        {
            "id": "1",
            "name": "Hero Hulk",
            "icon": "/heroes/transformations/bruce-banner-headbig-1.webp",
            "health": null,
            "movement_speed": null
        },
    ],
    "costumes": [
        {
            "id": "1011001",
            "name": "Bruce Banner",
            "icon": "/costumes/bruce-banner-1011001.png",
            "quality": "NO_QUALITY",
            "description": "No description available",
            "appearance": "No appearance data available"
        },
    ],
    "abilities": [
        {
            "id": 101131,
            "icon": "/abilities/101131.webp",
            "name": "Puny Banner",
            "type": "Ultimate",
            "isCollab": false,
            "description": "Transform from Bruce Banner into Hero Hulk.",
            "additional_fields": {
                "Key": "Q",
                "Casting": "Transformation",
                "Energy Cost": "600",
                "Special Effect": "The caster is immobilized during the transformation process and gains Invincibility"
            },
            "transformation_id": "0"
        },
    ]
}

400

{
  "error": true,
  "message": "Invalid hero name or ID. The provided name or ID does not match any known hero.",
  "status": 400
}

401

{
  "error": true,
  "message": "Invalid or missing API key.",
  "status": 401
}

404

{
  "error": true,
  "message": "Hero not found. No hero matches the provided name or ID",
  "status": 404
}

500

{
  "error": true,
  "message": "An error occurred while fetching data.",
  "status": 500
}

Response Field Descriptions

Field	Type	Description
id	String	Unique hero ID.
name	String	Hero's display name.
real_name	String	The hero’s real-world identity.
imageUrl	String	URL or path to the hero's image.
role	String	The hero’s role (e.g., Vanguard, Support).
attack_type	String	Hero’s attack type (e.g., Melee Heroes).
team	Array<String>	Factions or affiliations the hero belongs to (e.g., Avengers).
difficulty	String	Difficulty rating of the hero (e.g., "4").
bio	String	Short biography of the hero.
lore	String	Extended lore/backstory of the hero.
transformations	Array<Object>	Different forms the hero can transform into.
transformations[].id	String	ID of the transformation.
transformations[].name	String	Name of the transformation (e.g., Bruce Banner).
transformations[].icon	String	Image path for the transformation.
transformations[].health	String | null	Health for the transformation (if available).
transformations[].movement_speed	String | null	Movement speed in meters per second (e.g., "6m/s").
costumes	Array<Object>	List of hero costumes/skins.
costumes[].id	String	ID of the costume.
costumes[].name	String	Name of the costume.
costumes[].icon	String	Icon path for the costume.
costumes[].quality	String	Quality level (e.g., NO_QUALITY).
costumes[].description	String	Description of the costume.
costumes[].appearance	String	Visual details about the costume appearance.
abilities	Array<Object>	List of the hero’s abilities.
abilities[].id	Number	Unique ability ID.
abilities[].icon	String	Icon path for the ability.
abilities[].name	String	Name of the ability.
abilities[].type	String	Type of the ability (e.g., Ultimate, Passive).
abilities[].isCollab	Boolean	Whether the ability is from a collaboration.
abilities[].description	String	Description of what the ability does.
abilities[].transformation_id	String	ID of the transformation this ability is tied to.
abilities[].additional_fields	Object	Dynamic key-value object with extra metadata. Keys vary per ability and may include: Key, Casting, Cooldown, Energy Cost, Special Effect, etc.