{"openapi":"3.1.0","info":{"title":"Superhero API","version":"1.0.0","description":"Over 560 comic and movie superheroes and villains as an API — Marvel, DC and beyond. Look up any character by id or name (e.g. Batman → DC Comics, alignment good, intelligence 81 / strength 40 / speed 29 / combat 90) or search and filter the whole roster by publisher and alignment. Each character carries the full profile: six powerstats (intelligence, strength, speed, durability, power, combat), biography (full name, alter-egos, place of birth, first appearance, publisher, alignment), appearance (gender, race, height, weight, eye and hair colour), occupation and base of operations, group affiliations and relatives, and character images. Backed by the open SuperHero Database. Ideal for comic and movie apps, trivia and quiz games, character-comparison tools, Discord bots and fan sites.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/superhero-api","description":"oanor gateway"}],"tags":[{"name":"Heroes"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/hero":{"get":{"operationId":"get_v1_hero","tags":["Heroes"],"summary":"A superhero by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Character id, e.g. 70 (Batman)","schema":{"type":"string"},"example":"70"},{"name":"q","in":"query","required":false,"description":"Character name to resolve, e.g. Batman","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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/superhero-api@0.3.0/api/images/lg/70-batman.jpg","md":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/md/70-batman.jpg","sm":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/70-batman.jpg","xs":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Heroes"],"summary":"List / filter all heroes (paginated)","description":"","parameters":[{"name":"publisher","in":"query","required":false,"description":"Filter by publisher, e.g. DC Comics","schema":{"type":"string"}},{"name":"alignment","in":"query","required":false,"description":"good | bad | neutral","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100, default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":30,"total":563,"results":[{"id":1,"name":"A-Bomb","slug":"1-a-bomb","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/1-a-bomb.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":2,"name":"Abe Sapien","slug":"2-abe-sapien","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/2-abe-sapien.jpg","alignment":"good","publisher":"Dark Horse Comics"},{"id":3,"name":"Abin Sur","slug":"3-abin-sur","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/3-abin-sur.jpg","alignment":"good","publisher":"DC Comics"},{"id":4,"name":"Abomination","slug":"4-abomination","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/4-abomination.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":5,"name":"Abraxas","slug":"5-abraxas","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/5-abraxas.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":6,"name":"Absorbing Man","slug":"6-absorbing-man","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/6-absorbing-man.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":7,"name":"Adam Monroe","slug":"7-adam-monroe","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/7-adam-monroe.jpg","alignment":"good","publisher":"NBC - Heroes"},{"id":8,"name":"Adam Strange","slug":"8-adam-strange","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/8-adam-strange.jpg","alignment":"good","publisher":"DC Comics"},{"id":10,"name":"Agent Bob","slug":"10-agent-bob","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/10-agent-bob.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":11,"name":"Agent Zero","slug":"11-agent-zero","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/11-agent-zero.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":12,"name":"Air-Walker","slug":"12-air-walker","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/12-air-walker.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":13,"name":"Ajax","slug":"13-ajax","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/13-ajax.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":14,"name":"Alan Scott","slug":"14-alan-scott","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/14-alan-scott.jpg","alignment":"good","publisher":"DC Comics"},{"id":15,"name":"Alex Mercer","slug":"15-alex-mercer","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/15-alex-mercer.jpg","alignment":"bad","publisher":"Wildstorm"},{"id":17,"name":"Alfred Pennyworth","slug":"17-alfred-pennyworth","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/17-alfred-pennyworth.jpg","alignment":"good","publisher":"DC Comics"},{"id":18,"name":"Alien","slug":"18-alien","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/18-alien.jpg","alignment":"bad","publisher":"Dark Horse Comics"},{"id":20,"name":"Amazo","slug":"20-amazo","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/20-amazo.jpg","alignment":"bad","publisher":"DC Comics"},{"id":23,"name":"Angel","slug":"23-angel","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/23-angel.jpg","alignment":"good","publisher":"Dark Horse Comics"},{"id":24,"name":"Angel","slug":"24-angel","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/24-angel.jpg","alignment":"good","publisher":"Archangel"},{"id":25,"name":"Angel Dust","slug":"25-angel-dust","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/25-angel-dust.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":26,"name":"Angel Salvadore","slug":"26-angel-salvadore","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/26-angel-salvadore.jpg","alignment":"good","publisher":"Tempest"},{"id":28,"name":"Animal Man","slug":"28-animal-man","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/28-animal-man.jpg","alignment":"good","publisher":"DC Comics"},{"id":29,"name":"Annihilus","slug":"29-annihilus","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/29-annihilus.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":30,"name":"Ant-Man","slug":"30-ant-man","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/30-ant-man.jpg","alignment":"good","publisher":"Giant-Man"},{"id":31,"name":"Ant-Man II","slug":"31-ant-man-ii","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/31-ant-man-ii.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":32,"name":"Anti-Monitor","slug":"32-anti-monitor","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/32-anti-monitor.jpg","alignment":"bad","publisher":"DC Comics"},{"id":34,"name":"Anti-Venom","slug":"34-anti-venom","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/34-anti-venom.jpg","alignment":"-","publisher":"Toxin"},{"id":35,"name":"Apocalypse","slug":"35-apocalypse","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/35-apocalypse.jpg","alignment":"bad","publisher":"Marvel Comics"},{"id":36,"name":"Aquababy","slug":"36-aquababy","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/36-aquababy.jpg","alignment":"good","publisher":"DC Comics"},{"id":37,"name":"Aqualad","slug":"37-aqualad","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/37-aqualad.jpg","alignment":"good","publisher":"DC Comics"}],"total_pages":19},"meta":{"timestamp":"2026-06-01T00:04:36.125Z","request_id":"2a4eb913-a1c0-4300-9478-e9509be2f41a"},"status":"ok","message":"Heroes listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Heroes"],"summary":"Search heroes by name (+ filters)","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Name to search, e.g. spider","schema":{"type":"string"},"example":"spider"},{"name":"publisher","in":"query","required":false,"description":"Filter by publisher, e.g. Marvel Comics","schema":{"type":"string"}},{"name":"alignment","in":"query","required":false,"description":"Filter by alignment: good | bad | neutral","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"query":"spider","total":7,"results":[{"id":577,"name":"Scarlet Spider","slug":"577-scarlet-spider","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/577-scarlet-spider.jpg","alignment":"good","publisher":"Spider-Carnage"},{"id":578,"name":"Scarlet Spider II","slug":"578-scarlet-spider-ii","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/578-scarlet-spider-ii.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":618,"name":"Spider-Girl","slug":"618-spider-girl","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/618-spider-girl.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":619,"name":"Spider-Gwen","slug":"619-spider-gwen","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/619-spider-gwen.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":620,"name":"Spider-Man","slug":"620-spider-man","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/620-spider-man.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":623,"name":"Spider-Woman","slug":"623-spider-woman","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/623-spider-woman.jpg","alignment":"good","publisher":"Marvel Comics"},{"id":625,"name":"Spider-Woman III","slug":"625-spider-woman-iii","image":"https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api/images/sm/625-spider-woman-iii.jpg","alignment":"good","publisher":"Marvel Comics"}]},"meta":{"timestamp":"2026-06-01T00:04:36.193Z","request_id":"4345e53b-fc7d-414c-9f19-85a13301a818"},"status":"ok","message":"Heroes searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Counts, publishers & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Comic & movie superheroes. /v1/hero = one hero by id or name (e.g. id=70 or q=Batman) with powerstats, biography, appearance, work, connections and images; /v1/search = search by name with optional publisher/alignment filters; /v1/list = list/filter all heroes (publisher=, alignment=good|bad|neutral) with paging. Data is a fixed snapshot of the open SuperHero DB.","source":"SuperHero Database (akabab/superhero-api) — bundled static snapshot","endpoints":["/v1/hero","/v1/search","/v1/list","/v1/meta"],"alignments":["good","bad","neutral"],"publishers":["ABC Studios","Angel","Angel Salvadore","Ant-Man","Anti-Venom","Anti-Vision","Archangel","Aztar","Batgirl","Batgirl III","Batgirl V","Batman II","Binary","Black Racer","Boom-Boom","DC Comics","Dark Horse Comics","Deadpool","Evil Deadpool","Flash IV","Gemini V","George Lucas","Giant-Man","Goliath","IDW Publishing","Icon Comics","Image Comics","Impulse","Iron Lad","J. K. Rowling","J. R. R. Tolkien","Jean Grey","Marvel Comics","Meltdown","Microsoft","Ms Marvel II","NBC - Heroes","Nightwing","Oracle","Phoenix","Power Man","Power Woman","Rebellion","Red Hood","Red Robin","Robin II","Robin III","Rune King Thor","Scorpion","She-Thing","Shueisha","Sony Pictures","South Park","Speed Demon","Spider-Carnage","Spoiler","Star Trek","Superman Prime One-Million","SyFy","Tempest","Thunderbird II","Titan Books","Toxin","Universal Studios","Venom III","Vindicator II","Wildstorm"],"total_heroes":563},"meta":{"timestamp":"2026-06-01T00:04:36.268Z","request_id":"6f8d3215-a7ff-419b-8cec-b2596b56a585"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":340,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1140,"monthly_call_quota":600000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3290,"monthly_call_quota":2600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/superhero-api"}