Superhero API (akabab) Characters API
Full character records and the consolidated dataset.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/superheroes-characters-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Superhero API (akabab) Appearance Characters API
description: 'Open-source static REST API exposing 731 superheroes and villains from
multiple comic universes (Marvel, DC, Dark Horse, Image, and more) as
pre-built JSON files served from GitHub Pages and the jsDelivr CDN.
All endpoints are unauthenticated GETs.
'
version: 0.3.0
contact:
name: akabab/superhero-api
url: https://github.com/akabab/superhero-api
license:
name: MIT
url: https://github.com/akabab/superhero-api/blob/master/LICENSE
servers:
- url: https://akabab.github.io/superhero-api/api
description: Primary origin (GitHub Pages)
- url: https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api
description: jsDelivr CDN mirror
tags:
- name: Characters
description: Full character records and the consolidated dataset.
paths:
/all.json:
get:
operationId: listAllCharacters
summary: List All Characters
description: Returns every character record in the dataset as a single JSON array of 731 entries.
tags:
- Characters
responses:
'200':
description: A JSON array of all character records.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Character'
/id/{id}.json:
get:
operationId: getCharacterById
summary: Get Character By Id
description: Returns the complete record for a single character keyed by numeric id (1..731).
tags:
- Characters
parameters:
- $ref: '#/components/parameters/CharacterId'
responses:
'200':
description: A single character record.
content:
application/json:
schema:
$ref: '#/components/schemas/Character'
'404':
description: No character with the supplied id exists.
components:
schemas:
Connections:
type: object
description: Group affiliations and family connections.
properties:
groupAffiliation:
type: string
description: Group/team affiliations.
relatives:
type: string
description: Known relatives.
Powerstats:
type: object
description: Six-axis powerstats vector scored 0-100 (null if unknown).
properties:
intelligence:
type:
- integer
- 'null'
minimum: 0
maximum: 100
strength:
type:
- integer
- 'null'
minimum: 0
maximum: 100
speed:
type:
- integer
- 'null'
minimum: 0
maximum: 100
durability:
type:
- integer
- 'null'
minimum: 0
maximum: 100
power:
type:
- integer
- 'null'
minimum: 0
maximum: 100
combat:
type:
- integer
- 'null'
minimum: 0
maximum: 100
Appearance:
type: object
description: Physical appearance attributes.
properties:
gender:
type: string
description: Reported gender or "-" if unknown.
race:
type:
- string
- 'null'
description: Species / race designation (e.g. Human, Kryptonian, Mutant).
height:
type: array
description: Height pair — imperial then metric.
items:
type: string
example:
- 6'8
- 203 cm
weight:
type: array
description: Weight pair — imperial then metric.
items:
type: string
example:
- 980 lb
- 441 kg
eyeColor:
type: string
description: Eye color or "-" if unknown.
hairColor:
type: string
description: Hair color or "-" / "No Hair" if unknown / bald.
Biography:
type: object
description: Biographical information.
properties:
fullName:
type: string
description: Real name where known.
alterEgos:
type: string
description: Comma-separated alter egos, or "No alter egos found.".
aliases:
type: array
description: Known aliases.
items:
type: string
placeOfBirth:
type: string
firstAppearance:
type: string
description: First appearance in canonical comics / media.
publisher:
type: string
description: Originating publisher (Marvel Comics, DC Comics, etc.).
alignment:
type: string
description: Moral alignment of the character.
enum:
- good
- bad
- neutral
- '-'
Character:
type: object
description: A complete superhero or villain record.
required:
- id
- name
- slug
- powerstats
- appearance
- biography
- work
- connections
- images
properties:
id:
type: integer
description: Numeric identifier, 1..731.
example: 1
name:
type: string
description: Display name of the character.
example: A-Bomb
slug:
type: string
description: URL-safe slug in `{id}-{name}` form.
example: 1-a-bomb
powerstats:
$ref: '#/components/schemas/Powerstats'
appearance:
$ref: '#/components/schemas/Appearance'
biography:
$ref: '#/components/schemas/Biography'
work:
$ref: '#/components/schemas/Work'
connections:
$ref: '#/components/schemas/Connections'
images:
$ref: '#/components/schemas/Images'
Work:
type: object
description: Occupational record.
properties:
occupation:
type: string
description: Occupation(s), or "-" if unknown.
base:
type: string
description: Base of operations, or "-" if unknown.
Images:
type: object
description: Image URLs at four sizes.
required:
- xs
- sm
- md
- lg
properties:
xs:
type: string
format: uri
sm:
type: string
format: uri
md:
type: string
format: uri
lg:
type: string
format: uri
parameters:
CharacterId:
name: id
in: path
required: true
description: Numeric character id, 1..731.
schema:
type: integer
minimum: 1
maximum: 731