/v1/search
Search heroes by name (+ filters)
Probeer het live
10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.
Het werkt. Haal een API-key op en gebruik hem in je project.
Verkrijg een API-sleutelCodefragmenten
curl "https://api.oanor.com/superhero-api/v1/search" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/superhero-api/v1/search", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/superhero-api/v1/search");
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/search",
headers={"x-oanor-key": "oanor_test_..."}
)
Voorbeeldrespons
Een echte respons van dit endpoint, vastgelegd bij de laatste health check.
{
"data": {
"count": 7,
"query": "spider",
"total": 7,
"results": [
{
"id": 577,
"name": "Scarlet Spider",
"slug": "577-scarlet-spider",
"image": "https://cdn.jsdelivr.net/gh/akabab/[email protected]/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/[email protected]/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/[email protected]/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/[email protected]/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/[email protected]/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/[email protected]/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/[email protected]/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
}