MarvelRivalsAPI.com
  1. Heroes
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
        GET
      • Search hero
        GET
      • Hero stats
        GET
      • Hero leaderboard
        GET
      • List costumes
        GET
      • Search hero costume
        GET
    • 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
      • Player stats
      • Player stats v2
      • Update player
      • Player Leaderboard
  1. Heroes

Search hero

GET
/api/v1/heroes/hero/{query}
HeroesFreePremium
Maintainer:Alastor
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.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero/' \
--header 'x-api-key;'
Response Response Example
{
    "id": "1032",
    "name": "squirrel girl",
    "real_name": "Doreen Green",
    "imageUrl": "/rivals/heroes/card/squirrel-girl.png",
    "role": "Duelist",
    "attack_type": "Projectile Heroes",
    "team": [
        "Avengers"
    ],
    "difficulty": "1",
    "bio": "Possessing only the powers of a common squirrel, somehow Doreen Green manages to defeat seemingly invincible enemies in the most unexpected ways. Any foe who counts her out is bound to fall at the hands of the Unbeatable Squirrel Girl!",
    "lore": "Doreen Green is more than just a computer science student at Empire State University. She also happens to have the powers of a squirrel AND the powers of a girl! With her BFFF (Best Furry Friend Forever) Tippy-Toe by her side, Doreen eats nuts and kicks butts as the unbeatable Squirrel-Girl!\nAfter the Timestream Entanglement, things got weird…er. With all of New York City under attack by creatures of the night, Squirrel Girl assembled an adorable army to reclaim Central Park from the clutches of Dracula. Here’s hoping vampires don’t like the taste of squirrel!",
    "transformations": [
        {
            "id": "0",
            "name": "Squirrel Girl",
            "icon": "/heroes/transformations/squirrel-girl-headbig-0.webp",
            "health": "275",
            "movement_speed": "6 m/s"
        }
    ],
    "costumes": [
        {
            "id": "1032001",
            "name": "Squirrel Girl",
            "icon": "/costumes/squirrel-girl-1032001.png",
            "quality": "NO_QUALITY",
            "description": "0",
            "appearance": "0"
        },
        {
            "id": "1032100",
            "name": "Arctic Lemmus",
            "icon": "/costumes/arctic-lemmus-1032100.png",
            "quality": "BLUE",
            "description": "\"Tippy-Toe has always been a standout with her fur, but it wasn't until I really asked her that she spilled the beans—she's actually an Arctic Squirrel! So for her birthday, I put on some polar gear to surprise her. I've never seen her so thrilled!\"",
            "appearance": "First Appears in Marvel Rivals Season 0"
        },
        {
            "id": "1032300",
            "name": "Nut Rocker",
            "icon": "/costumes/nut-rocker-1032300.png",
            "quality": "PURPLE",
            "description": "\"I can't recall how it all started, but the words of that Spider-Man, Hobie, still echo in my mind. His speech ignited a fire within me, and now Tippy-Toe and I are ready to rock out with punk spirit!\"",
            "appearance": "First Appears in Marvel Rivals Season 2"
        },
        {
            "id": "1032301",
            "name": "Cheerful Dragoness",
            "icon": "/costumes/cheerful-dragoness-1032301.png",
            "quality": "PURPLE",
            "description": "\"In the southern realm of K'un Lun lies a forest kingdom spanning hundreds of miles. Within it dwells a deity known as Cheerful Dragoness, who speaks the tongue of rodents and commands an unbeatable legion of squirrels.\"",
            "appearance": "First Appears in Marvel Rivals Season 0"
        },
        {
            "id": "1032302",
            "name": "Sunshine Squirrel",
            "icon": "/costumes/sunshine-squirrel-1032302.png",
            "quality": "PURPLE",
            "description": "\"You like the new outfit? I know everyone else is getting all gussied up for the Gala tonight, but I think hitting the beach is more my style.\"",
            "appearance": "First Appears in Marvel Rivals Season 2"
        },
        {
            "id": "1032500",
            "name": "Urban Hunter",
            "icon": "/costumes/urban-hunter-1032500.png",
            "quality": "PURPLE",
            "description": "\"My main power is I never give up and I never say die. So neither should you, okay?\"",
            "appearance": "First Appears in U.S.Avengers (2017) #1"
        },
        {
            "id": "1032501",
            "name": "Symbiote Squirrel",
            "icon": "/costumes/symbiote-squirrel-1032501.png",
            "quality": "ORANGE",
            "description": "\"Oh, wow! This will definitely solve my costume problem and not have any unforeseen consequences ever!\"",
            "appearance": "First Appears in The Unbeatable Squirrel Girl (2015) #5"
        }
    ],
    "abilities": [
        {
            "id": 103211,
            "icon": "/abilities/103211.webp",
            "name": "Burst Acorn",
            "type": "Weapon",
            "isCollab": false,
            "description": "Shoot bouncing Burst Acorns.",
            "additional_fields": {
                "Key": "Left Click",
                "Ammo": "12",
                "Casting": "Arced projectile that generates a spell field upon impact",
                "Fire Rate": "1.49 acorns per second",
                "Critical Hit": "No",
                "Damage Falloff": "70% falloff at 3m",
                "Projectile Speed": "80 m/s",
                "Spell Field Range": "3m spherical radius",
                "Spell Field Damage": "110"
            },
            "transformation_id": "0"
        },
        {
            "id": 103231,
            "icon": "/abilities/103231.webp",
            "name": "Tail Bounce",
            "type": "Normal",
            "isCollab": false,
            "description": "Rocket upwards with a bounce of her tail.",
            "additional_fields": {
                "Key": "SHIFT",
                "Cooldown": "8s",
                "Jump Height": "9m"
            },
            "transformation_id": "0"
        },
        {
            "id": 103241,
            "icon": "/abilities/103241.webp",
            "name": "Mammal Bond",
            "type": "Normal",
            "isCollab": false,
            "description": "Reload Burst Acorns and can use an ability without cooldown once in a short duration.",
            "additional_fields": {
                "Key": "E",
                "Cooldown": "10s",
                "Maximum Duration": "5s"
            },
            "transformation_id": "0"
        },
        {
            "id": 103221,
            "icon": "/abilities/103221.webp",
            "name": "Squirrel Blockade",
            "type": "Normal",
            "isCollab": false,
            "description": "Launch an acorn to unleash Squirrel Guards, <Debuff>Imprisoning</> the first hit enemy.",
            "additional_fields": {
                "Key": "Right Click",
                "Damage": "35",
                "Casting": "Charged projectile with an arced trajectory",
                "Cooldown": "8s",
                "Projectile Speed": "20 - 60 m/s (Maximum speed is achieved after 0.7s of charging)",
                "Imprison Duration": "1.33s",
                "Maximum Charge Time": "1.5s"
            },
            "transformation_id": "0"
        },
        {
            "id": 103251,
            "icon": "/abilities/103251.webp",
            "name": "Unbeatable Squirrel Tsunami",
            "type": "Ultimate",
            "isCollab": false,
            "description": "Summon a horde of squirrels to charge forward, dealing damage while bouncing against structures.",
            "additional_fields": {
                "Key": "Q",
                "Range": "Length: 3m, Width: 5m, Height: 1.75m",
                "Damage": "150",
                "Duration": "10s",
                "Energy Cost": "2800",
                "Special Mechanic": "The squirrels will rush towards the nearest enemy after bouncing instead of bouncing randomly",
                "Squirrel Horde Health": "300",
                "Squirrel Horde Movement Speed": "9 m/s"
            },
            "transformation_id": "0"
        },
        {
            "id": 103281,
            "icon": "/abilities/103281.webp",
            "name": "Squirrel Support",
            "type": "Normal",
            "isCollab": true,
            "transformation_id": "0"
        },
        {
            "id": 103291,
            "icon": "/abilities/103291.webp",
            "name": "Webbed Acorn",
            "type": "Normal",
            "isCollab": true,
            "description": "Spider-Man gives Squirrel Girl a web bomb. She can launch it to unleash an explosion upon contact with the environment or an enemy, briefly <Debuff>Immobilizing</> and damaging enemies caught in the blast.",
            "transformation_id": "0"
        },
        {
            "id": 103292,
            "icon": "/abilities/103292.webp",
            "name": "Squirrel Missile",
            "type": "Normal",
            "isCollab": true,
            "description": "When Iron Man, Ultron, and Squirrel Girl team up, Ultron's <Orange>Encephalo-Ray</> upgrades to <Orange>Nano-Ray</>, firing a beam that pierces through all characters, dealing continuous damage to foes while healing allies; Squirrel Girl gains the <Orange>Squirrel Missile</> ability. She directs a squirrel to ride Iron Man's nanotech glove as a homing missile. Upon hit, the squirrel flees just before a fiery explosion!",
            "additional_fields": {
                "Key": "C",
                "Damage": "75",
                "Cooldown": "20",
                "Damage Falloff": "Falloff begins at 4m, decreasing to 50% at 8m",
                "Special Effect": "Automatically track enemies within a horizontal angle of 60°, a vertical angle of 60°, and a maximum distance of 60m",
                "Explosion Range": "8m spherical radius spell field",
                "Projectile Speed": "40 m/s",
                "Projectile Radius": "0.5m"
            },
            "transformation_id": "0"
        }
    ],
    "badges": {
        "gold": "/premium/heroes/badges/gold/head_badge_gold_1032.png?expires=1753281474&signature=08617864524e12c29016c0539505dd92e96abe463f2595c73b1dde461d8ee815",
        "silver": "/premium/heroes/badges/silver/head_badge_silver_1032.png?expires=1753281474&signature=9b768bfde4c85523699631724526ad275183a2e7e583ddd5cd3c5834d4c206c8"
    },
    "ko": {
        "prompt_1": "/premium/heroes/ko/1032_ko_prompt_1.png?expires=1753281474&signature=57f6121f517beba74e5bb1834440720fa4f271b0cb31f0a967649489205d804e",
        "prompt_2": "/premium/heroes/ko/1032_ko_prompt_2.png?expires=1753281474&signature=add35b3f6088c4e33789aece9a50a01d1b80ab94642da7dd4eef7e6fb7563d26"
    },
    "story_card": "/premium/heroes/story/1032_story.png?expires=1753281474&signature=aa0ddbe54e7f743b21943c9b463c5541a8978ca8f2016545bfff24e68cd268a2",
    "hero_card": "/premium/banners/1032_banner.png?expires=1753281474&signature=386ff2de64c9af80c29fea5d83c91bc834d387a5348ddd05fda01b8c5b4944b2",
    "lore_card": "/premium/lore/1032_lore_banner.png?expires=1753281474&signature=9c59ff43f7c68e7256909053af19424f3f9aa911b87e2bdd5758e0282d4f605d"
}

Request

Path Params
query
string 
required
The name or ID of the hero to retrieve.
Example:
ironman
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 hero details
Body
id
string 
optional
The unique identifier of the hero.
name
string 
optional
The name of the hero.
real_name
string 
optional
The real name of the hero.
imageUrl
string 
optional
URL to the hero's profile image.
role
string 
optional
The role of the hero in the game (e.g., Tank, DPS, Support).
attack_type
string 
optional
The type of attack the hero uses (e.g., ranged, melee).
team
array[string]
optional
The team to which the hero belongs (e.g., Avengers).
difficulty
string 
optional
The difficulty level of the hero (e.g., easy, medium, hard).
bio
string 
optional
A short biography of the hero.
lore
string 
optional
The hero's lore or backstory.
transformations
array [object {5}] 
optional
List of possible transformations for the hero.
id
string 
optional
name
string 
optional
icon
string 
optional
health
string 
optional
movement_speed
string 
optional
costumes
array [object {6}] 
optional
List of available costumes for the hero.
id
string 
required
name
string 
required
icon
string 
required
quality
string 
required
description
string 
required
appearance
string 
required
abilities
array [object {8}] 
optional
List of hero abilities or powers.
id
integer 
required
icon
string 
required
name
string 
required
type
string 
required
isCollab
boolean 
required
description
string 
required
additional_fields
object 
required
transformation_id
string 
required
badges
object 
optional
The heroes head badges
gold
string 
optional
Gold head badge (Premium only)
silver
string 
optional
Silver head badge (Premium only)
ko
object 
optional
The heroes kill prompts (Premium only)
prompt_1
string 
optional
Kill prompt 1 (Premium only)
prompt_2
string 
optional
Kill prompt 2 (Premium only)
story_card
string 
optional
The heroes story card (Premium only)
hero_card
string 
optional
URL to the hero's card image (Premium only)
lore_card
string 
optional
URL to the lore card image (Premium only)
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
🔴500Server Error
Modified at 2025-07-23 14:35:31
Previous
List Heroes
Next
Hero stats
Built with