Superhero API (akabab)

aid: superheroes
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/superheroes.png
name: Superhero API (akabab)
description: Open-source REST API exposing 731 superheroes and villains drawn from multiple comic universes (Marvel, DC, Dark
  Horse, Image, and more) under a single, unauthenticated JSON surface. The dataset is rebuilt from the original superheroapi.com
  source, cleaned up, and republished as static JSON files served from GitHub Pages and the jsDelivr CDN. Each character includes
  powerstats, appearance, biography, work, connections, and a multi-resolution image set.
url: https://akabab.github.io/superhero-api/api/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-type: opensource
x-category: Games & Comics
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Games And Comics
- Superheroes
- Comic Books
- Open Source
- Static API
- GitHub Pages
- Public APIs
apis:
- aid: superheroes:superheroes-appearance-api
  name: Superhero API (akabab) Appearance API
  description: Per-character physical appearance slices.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Appearance
  properties:
  - type: OpenAPI
    url: openapi/superheroes-appearance-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-biography-api
  name: Superhero API (akabab) Biography API
  description: Per-character biographical slices.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Biography
  properties:
  - type: OpenAPI
    url: openapi/superheroes-biography-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-characters-api
  name: Superhero API (akabab) Characters API
  description: Full character records and the consolidated dataset.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Characters
  properties:
  - type: OpenAPI
    url: openapi/superheroes-characters-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-connections-api
  name: Superhero API (akabab) Connections API
  description: Per-character group affiliations and relatives.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Connections
  properties:
  - type: OpenAPI
    url: openapi/superheroes-connections-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-images-api
  name: Superhero API (akabab) Images API
  description: Multi-resolution character image assets.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Images
  properties:
  - type: OpenAPI
    url: openapi/superheroes-images-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-powerstats-api
  name: Superhero API (akabab) Powerstats API
  description: Per-character powerstats slices (intelligence, strength, etc.).
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Powerstats
  properties:
  - type: OpenAPI
    url: openapi/superheroes-powerstats-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
- aid: superheroes:superheroes-work-api
  name: Superhero API (akabab) Work API
  description: Per-character occupation and base slices.
  humanURL: https://akabab.github.io/superhero-api/api/
  baseURL: https://akabab.github.io/superhero-api/api
  tags:
  - Work
  properties:
  - type: OpenAPI
    url: openapi/superheroes-work-api-openapi.yml
  - type: Documentation
    url: https://akabab.github.io/superhero-api/api/
  - type: SourceCode
    url: https://github.com/akabab/superhero-api
common:
- type: AgenticAccess
  url: agentic-access/superheroes-agentic-access.yml
- type: DomainSecurity
  url: security/superheroes-domain-security.yml
- type: Website
  url: https://akabab.github.io/superhero-api/api/
- type: SourceCode
  url: https://github.com/akabab/superhero-api
- type: GitHubOrganization
  url: https://github.com/akabab
- type: License
  url: https://github.com/akabab/superhero-api/blob/master/LICENSE
  title: MIT License
- type: CDN
  url: https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/
  title: jsDelivr CDN Mirror
- type: OriginalSource
  url: https://superheroapi.com
  title: superheroapi.com (Original Source)
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: SpectralRules
  url: rules/superheroes-rules.yml
- type: Vocabulary
  url: vocabulary/superheroes-vocabulary.yml
- type: JSONLD
  url: json-ld/superheroes-context.jsonld
- type: JSONSchema
  url: json-schema/superheroes-character-schema.json
  title: Character
- type: JSONSchema
  url: json-schema/superheroes-powerstats-schema.json
  title: Powerstats
- type: JSONSchema
  url: json-schema/superheroes-appearance-schema.json
  title: Appearance
- type: JSONSchema
  url: json-schema/superheroes-biography-schema.json
  title: Biography
- type: JSONSchema
  url: json-schema/superheroes-work-schema.json
  title: Work
- type: JSONSchema
  url: json-schema/superheroes-connections-schema.json
  title: Connections
- type: JSONSchema
  url: json-schema/superheroes-images-schema.json
  title: Images
- type: JSONStructure
  url: json-structure/superheroes-character-structure.json
  title: Character
- type: Examples
  url: examples/superheroes-character-example.json
  title: Character Example
- type: Examples
  url: examples/superheroes-all-example.json
  title: All Characters Example
- type: Examples
  url: examples/superheroes-powerstats-example.json
  title: Powerstats Example
- type: RateLimits
  url: rate-limits/superheroes-rate-limits.yml
- type: Plans
  url: plans/superheroes-plans-pricing.yml
features:
- name: Bulk Character Dataset
  description: The /all.json endpoint returns all 731 character records in a single response — ideal for clients that want
    to load and cache the dataset once and query it locally.
- name: Per-Character Records
  description: The /id/{id}.json endpoint returns a complete record for a single character keyed by numeric id (1..731).
- name: Per-Property Slices
  description: Property-specific endpoints (/powerstats, /appearance, /biography, /work, /connections) return just one sub-document,
    which lets bandwidth-sensitive clients fetch only what they need.
- name: Multi-Resolution Images
  description: Each character has four image sizes — xs, sm, md, lg — keyed by the character slug (e.g. `1-a-bomb.jpg`), served
    as static JPGs from GitHub Pages and jsDelivr.
- name: Powerstats Scoring
  description: Every character has a six-axis powerstats vector — intelligence, strength, speed, durability, power, combat
    — scored 0-100, suitable for ranking, filtering, and comparison.
- name: Alignment Classification
  description: Each biography includes an alignment tag (good, bad, neutral) so clients can split the catalog into heroes,
    villains, and antiheroes.
- name: Cross-Publisher Coverage
  description: The dataset spans Marvel Comics, DC Comics, Dark Horse Comics, Image Comics, Wildstorm, Star Trek, IDW, Sony
    Pictures, Universal Studios, and several other publishers — accessible via the biography.publisher field.
- name: No Authentication
  description: All endpoints are unauthenticated GETs. No API key, OAuth, or account sign-up is required, in contrast with
    the upstream superheroapi.com which requires a free token.
- name: CDN-Backed Static JSON
  description: Files are pre-built and served from GitHub Pages with a jsDelivr CDN mirror, so clients get edge-cached responses
    with no origin server to rate-limit them.
- name: Open Source Dataset
  description: The full builder pipeline, sources, and images are MIT-licensed on GitHub, so the dataset can be forked, augmented,
    and redeployed.
useCases:
- name: Frontend Tutorial Fixture
  description: Zero-friction REST API used in JavaScript / React / Vue tutorials to demonstrate fetch, list rendering, image
    loading, and detail pages without bringing up a backend.
- name: Game and Battle Simulators
  description: The powerstats vector is widely used to build superhero battle simulators, top-trumps style card games, and
    ranking experiments.
- name: Data Visualization Demos
  description: Cross-publisher, multi-axis powerstats data is a common dataset for D3, Observable, and Tableau tutorials showing
    radar charts, scatter plots, and comparative analytics.
- name: Machine Learning Toy Dataset
  description: Small (731-row), well-structured, mixed-type dataset useful for teaching classification (alignment), regression
    (powerstats), and embedding (text fields like aliases and connections).
- name: Chatbot and LLM Demos
  description: Used as a stable JSON corpus for retrieval-augmented chatbots and agent demos that answer "who is X?" or "compare
    X vs Y" questions.
- name: Mobile App Sample Data
  description: iOS and Android tutorials use the character + image surface as a ready-made backend for list/detail UX patterns.
integrations:
- name: GitHub Pages
  description: Origin host for the static JSON files and image assets.
- name: jsDelivr CDN
  description: Public CDN mirror at cdn.jsdelivr.net/gh/akabab/superhero-api for faster delivery.
- name: superheroapi.com (Upstream)
  description: Original community dataset cleaned and republished by the akabab project.
solutions:
- name: Public-APIs Catalog Entry
  description: Registered in the community-maintained public-apis directory under Games & Comics.
- name: Free Tutorial Backend
  description: Frequently recommended as a no-key REST API for tutorial and bootcamp curricula.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com