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

Sample Call Reference:
HTTP
 http							https://superheroapi.com/api/access-token/character-id
						

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
 http							https://superheroapi.com/api/access-token/character-id/powerstats
						

/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
     http							https://superheroapi.com/api/access-token/character-id/biography
    						

    /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
     http							https://superheroapi.com/api/access-token/character-id/appearance
    						

    /id/work

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

    • Occupation
    • Base of operation

    Sample Call Reference:
    HTTP
     http							https://superheroapi.com/api/access-token/character-id/work
    						

    /id/connections

    This call lists out the connections of the character.

    • Group Affiliation
    • Relatives

    Sample Call Reference:
    HTTP
     http							https://superheroapi.com/api/access-token/character-id/connections
    						

    /id/image

    This provides the image for the character, if exists.

    • image
    Sample Call Reference:
    HTTP
     httphttps://superheroapi.com/api/access-token/character-id/image

    /search/name

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

    Sample Call Reference:
    HTTP
     http							https://superheroapi.com/api/access-token/search/name