Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/hero

A superhero by id or name

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/superhero-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/superhero-api/v1/hero" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/superhero-api/v1/hero", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/superhero-api/v1/hero");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/superhero-api/v1/hero",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "hero": {
            "id": 70,
            "name": "Batman",
            "slug": "70-batman",
            "work": {
                "base": "Batcave, Stately Wayne Manor, Gotham City; Hall of Justice, Justice League Watchtower",
                "occupation": "Businessman"
            },
            "images": {
                "lg": "https://cdn.jsdelivr.net/gh/akabab/[email protected]/api/images/lg/70-batman.jpg",
                "md": "https://cdn.jsdelivr.net/gh/akabab/[email protected]/api/images/md/70-batman.jpg",
                "sm": "https://cdn.jsdelivr.net/gh/akabab/[email protected]/api/images/sm/70-batman.jpg",
                "xs": "https://cdn.jsdelivr.net/gh/akabab/[email protected]/api/images/xs/70-batman.jpg"
            },
            "biography": {
                "aliases": [
                    "Insider",
                    "Matches Malone"
                ],
                "fullName": "Bruce Wayne",
                "alignment": "good",
                "alterEgos": "No alter egos found.",
                "publisher": "DC Comics",
                "placeOfBirth": "Crest Hill, Bristol Township; Gotham County",
                "firstAppearance": "Detective Comics #27"
            },
            "appearance": {
                "race": "Human",
                "gender": "Male",
                "height": [
                    "6'2",
                    "188 cm"
                ],
                "weight": [
                    "210 lb",
                    "95 kg"
                ],
                "eyeColor": "blue",
                "hairColor": "black"
            },
            "powerstats": {
                "power": 47,
                "speed": 27,
                "combat": 100,
                "strength": 26,
                "durability": 50,
                "intelligence": 100
            },
            "connections": {
                "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",
                "groupAffiliation": "Batman Family, Batman Incorporated, Justice League, Outsiders, Wayne Enterprises, Club of Heroes, formerly White Lantern Corps, Sinestro Corps"
            }
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:36.067Z",
        "request_id": "281f605d-4b75-4b83-b9e5-dac05afc93bc"
    },
    "status": "ok",
    "message": "Hero retrieved",
    "success": true
}