For all the superhero data you've needed.
Powerstats. Biography. Appearance. Work. Connections. Images.
From both the universes, and more.

Introduction

What is this?
The superhero API, is a quantified and programatically accessible data source of all superheroes from different comic universes. We've taken all the stuff and put it together in a form that is easier to consume with software. Then we made an API so you can consume it in a hassle free manner.

How can I use it?
The data is accessible through a REST API. Consult our doucmentation if you'd like to get started. Helper libraries are also provided so you can consume the API in the choice of your language.

Getting your Access Token
You need a facebook account to get your access token. You can generate your access token below

Access Token Here

API References

BASE URLhttp://superheroapi.com/api/access-token
/id
  • /powerstats
  • /biography
  • /appearance
  • /work
  • /connections
  • /image
/search/name
Reference Method Purpose
/id GET Search by character id. Returns all information of the character.
/id/powerstats GET Returns JSON Array of all powerstats of given character.
/id/biography GET Returns JSON Array of character's biography.
/id/appearance GET Returns JSON Array of character's appearance.
/id/work GET Returns JSON Array of character's work i.e. occupation and operation base.
/id/connections GET Returns JSON Array of character's connections.
/id/image GET Returns image url of the character.
/name GET Search character by name. Returns character id.

/id

Sample Call Reference:
http://superheroapi.com/api/access-token/character-id
{
  "response": "success",
  "id": "70",
  "name": "Batman",
  "powerstats": {
    "intelligence": "100",
    "strength": "26",
    "speed": "27",
    "durability": "50",
    "power": "47",
    "combat": "100"
  },
  "biography": {
    "full-name": "Bruce Wayne",
    "alter-egos": "No alter egos found.",
    "aliases": [
      "Insider",
      "Matches Malone"
    ],
    "place-of-birth": "Crest Hill, Bristol Township; Gotham County",
    "first-appearance": "Detective Comics #27",
    "publisher": "DC Comics",
    "alignment": "good"
  },
  "appearance": {
    "gender": "Male",
    "race": "Human",
    "height": [
      "6'2",
      "188 cm"
    ],
    "weight": [
      "210 lb",
      "95 kg"
    ],
    "eye-color": "blue",
    "hair-color": "black"
  },
  "work": {
    "occupation": "Businessman",
    "base": "Batcave, Stately Wayne Manor, Gotham City; Hall of Justice, Justice League Watchtower"
  },
  "connections": {
    "group-affiliation": "Batman Family, Batman Incorporated, Justice League, Outsiders, Wayne Enterprises, Club of Heroes, formerly White Lantern Corps, Sinestro Corps",
    "relatives": "Damian Wayne (son), Dick Grayson (adopted son), Tim Drake (adopted son), Jason Todd (adopted son), Cassandra Cain (adopted ward)\nMartha Wayne (mother, deceased), Thomas Wayne (father, deceased), Alfred Pennyworth (former guardian), Roderick Kane (grandfather, deceased), Elizabeth Kane (grandmother, deceased), Nathan Kane (uncle, deceased), Simon Hurt (ancestor), Wayne Family"
  },
  "image": {
    "url": "http://www.superherodb.com/pictures/portraits/batman.jpg"
  }
}

You can find the character ids here.

/id/powerstats

This API call provides all powerstats for the given character. The powerstats are as follows :-

  • Intelligence
  • Strength
  • Speed
  • Durability
  • Power
  • Combat

Sample Call Reference:
http://superheroapi.com/api/access-token/character-id/powerstats
{
  "response": "success",
  "id": "70",
  "name": "Batman",
  "intelligence": "100",
  "strength": "26",
  "speed": "27",
  "durability": "50",
  "power": "47",
  "combat": "100"
}

/id/biography

This API call gives the biographical stats of the character. They are :

  • Full Name
  • Alter Egos
  • Aliases
  • Place of Birth
  • First Appearance
  • Publisher
  • Alignment
  • Sample Call Reference:
    http://superheroapi.com/api/access-token/character-id/biography
    {
      "response": "success",
      "id": "70",
      "name": "Batman",
      "full-name": "Bruce Wayne",
      "alter-egos": "No alter egos found.",
      "aliases": [
        "Insider",
        "Matches Malone"
      ],
      "place-of-birth": "Crest Hill, Bristol Township; Gotham County",
      "first-appearance": "Detective Comics #27",
      "publisher": "DC Comics",
      "alignment": "good"
    }

    /id/appearance

    This API call provides the appearance of the character. The various statistics are :

    • Gender
    • Race
    • Height
    • Weight
    • Eye Color
    • Hair Color

    Sample Call Reference:
    http://superheroapi.com/api/access-token/character-id/appearance
    {
      "response": "success",
      "id": "70",
      "name": "Batman",
      "gender": "Male",
      "race": "Human",
      "height": [
        "6'2",
        "188 cm"
      ],
      "weight": [
        "210 lb",
        "95 kg"
      ],
      "eye-color": "blue",
      "hair-color": "black"
    }

    /id/work

    This API lists the work/occupation of the character. They are:

    • Occupation
    • Base of operation

    Sample Call Reference:
    http://superheroapi.com/api/access-token/character-id/work
    {
      "response": "success",
      "id": "70",
      "name": "Batman",
      "occupation": "Businessman",
      "base": "Batcave, Stately Wayne Manor, Gotham City; Hall of Justice, Justice League Watchtower"
    }

    /id/connections

    This call lists out the connections of the character.

    • Group Affiliation
    • Relatives

    Sample Call Reference:
    http://superheroapi.com/api/access-token/character-id/connections
    {
      "response": "success",
      "id": "70",
      "name": "Batman",
      "group-affiliation": "Batman Family, Batman Incorporated, Justice League, Outsiders, Wayne Enterprises, Club of Heroes, formerly White Lantern Corps, Sinestro Corps",
      "relatives": "Damian Wayne (son), Dick Grayson (adopted son), Tim Drake (adopted son), Jason Todd (adopted son), Cassandra Cain (adopted ward)\nMartha Wayne (mother, deceased), Thomas Wayne (father, deceased), Alfred Pennyworth (former guardian), Roderick Kane (grandfather, deceased), Elizabeth Kane (grandmother, deceased), Nathan Kane (uncle, deceased), Simon Hurt (ancestor), Wayne Family"
    }

    /id/image

    This provides the image for the character, if exists.

    • image

    Sample Call Reference:
    http://superheroapi.com/api/access-token/character-id/image
    {
      "response": "success",
      "id": "70",
      "name": "Batman",
      "url": "http://www.superherodb.com/pictures/portraits/batman.jpg"
    }

    /search/name

    This API call helps you in finding the character-id of a character by searching it's name.

    Sample Call Reference:
    http://superheroapi.com/api/access-token/search/name
    {
      "response": "success",
      "results-for": "batman",
      "results": [
        {
          "id": "69",
          "name": "Batman",
          "powerstats": {
            "intelligence": "81",
            "strength": "40",
            "speed": "29",
            "durability": "55",
            "power": "63",
            "combat": "90"
          },
          "biography": {
            "full-name": "Terry McGinnis",
            "alter-egos": "No alter egos found.",
            "aliases": [
              "Batman II",
              "The Tomorrow Knight",
              "The second Dark Knight",
              "The Dark Knight of Tomorrow",
              "Batman Beyond"
            ],
            "place-of-birth": "Gotham City, 25th Century",
            "first-appearance": "Batman Beyond #1",
            "publisher": "DC Comics",
            "alignment": "good"
          },
          "appearance": {
            "gender": "Male",
            "race": "Human",
            "height": [
              "5'10",
              "178 cm"
            ],
            "weight": [
              "170 lb",
              "77 kg"
            ],
            "eye-color": "Blue",
            "hair-color": "Black"
          },
          "work": {
            "occupation": "-",
            "base": "21st Century Gotham City"
          },
          "connections": {
            "group-affiliation": "Batman Family, Justice League Unlimited",
            "relatives": "Bruce Wayne (biological father), Warren McGinnis (father, deceased), Mary McGinnis (mother), Matt McGinnis (brother)"
          },
          "image": {
            "url": "http://www.superherodb.com/pictures/portraits/batman-2.jpg"
          }
        },
        {
          "id": "70",
          "name": "Batman",
          "powerstats": {
            "intelligence": "100",
            "strength": "26",
            "speed": "27",
            "durability": "50",
            "power": "47",
            "combat": "100"
          },
          "biography": {
            "full-name": "Bruce Wayne",
            "alter-egos": "No alter egos found.",
            "aliases": [
              "Insider",
              "Matches Malone"
            ],
            "place-of-birth": "Crest Hill, Bristol Township; Gotham County",
            "first-appearance": "Detective Comics #27",
            "publisher": "DC Comics",
            "alignment": "good"
          },
          "appearance": {
            "gender": "Male",
            "race": "Human",
            "height": [
              "6'2",
              "188 cm"
            ],
            "weight": [
              "210 lb",
              "95 kg"
            ],
            "eye-color": "blue",
            "hair-color": "black"
          },
          "work": {
            "occupation": "Businessman",
            "base": "Batcave, Stately Wayne Manor, Gotham City; Hall of Justice, Justice League Watchtower"
          },
          "connections": {
            "group-affiliation": "Batman Family, Batman Incorporated, Justice League, Outsiders, Wayne Enterprises, Club of Heroes, formerly White Lantern Corps, Sinestro Corps",
            "relatives": "Damian Wayne (son), Dick Grayson (adopted son), Tim Drake (adopted son), Jason Todd (adopted son), Cassandra Cain (adopted ward)\nMartha Wayne (mother, deceased), Thomas Wayne (father, deceased), Alfred Pennyworth (former guardian), Roderick Kane (grandfather, deceased), Elizabeth Kane (grandmother, deceased), Nathan Kane (uncle, deceased), Simon Hurt (ancestor), Wayne Family"
          },
          "image": {
            "url": "http://www.superherodb.com/pictures/portraits/batman.jpg"
          }
        },
        {
          "id": "71",
          "name": "Batman II",
          "powerstats": {
            "intelligence": "88",
            "strength": "11",
            "speed": "33",
            "durability": "28",
            "power": "36",
            "combat": "100"
          },
          "biography": {
            "full-name": "Dick Grayson",
            "alter-egos": "Nightwing, Robin",
            "aliases": [
              "Dick Grayson"
            ],
            "place-of-birth": "-",
            "first-appearance": "-",
            "publisher": "Nightwing",
            "alignment": "good"
          },
          "appearance": {
            "gender": "Male",
            "race": "Human",
            "height": [
              "5'10",
              "178 cm"
            ],
            "weight": [
              "175 lb",
              "79 kg"
            ],
            "eye-color": "Blue",
            "hair-color": "Black"
          },
          "work": {
            "occupation": "-",
            "base": "Gotham City; formerly Bludhaven, New York City"
          },
          "connections": {
            "group-affiliation": "Justice League Of America, Batman Family",
            "relatives": "John Grayson (father, deceased), Mary Grayson (mother, deceased), Bruce Wayne / Batman (adoptive father), Damian Wayne / Robin (foster brother), Jason Todd / Red Hood (adoptive brother), Tim Drake / Red Robin (adoptive brother), Cassandra Cain / Batgirl IV (adoptive sister)"
          },
          "image": {
            "url": "http://www.superherodb.com/pictures/portraits/batman-grayson.jpg"
          }
        }
      ]
    }