For all the superhero data you've needed.
Powerstats. Biography.
Appearance. Work. Connections. Images.
From both the universe, and more.
Introduction
What is this?
The superhero API, is a quantified and programmatically accessible data source of all superheroes from both the comic universe. 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 documentation 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 GitHub account to get your access token. You can generate your access token below
API References
BASE URLhttps://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
https://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": "httpss://www.superherodb.com/pictures2/portraits/10/100/639.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
https://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 :
https://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
https://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
https://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
https://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
https://superheroapi.com/api/access-token/character-id/image
{
"response": "success",
"id": "70",
"name": "Batman",
"url": "https://www.superherodb.com/pictures2/portraits/10/100/639.jpg"
}
/search/name
This API call helps you in finding the character-id of a character by searching it's name.
https://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": "https://www.superherodb.com/pictures2/portraits/10/100/10441.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": "https://www.superherodb.com/pictures2/portraits/10/100/639.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": "https://www.superherodb.com/pictures2/portraits/10/100/1496.jpg"
}
}
]
}