Aller au contenu
oanor
Inscription gratuite
Marché Tarifs Fonctionnalités Connexion
GET /v1/search

Search heroes by name (+ filters)

Essayez-le en direct

10 appels gratuits par jour — sans inscription, sans clé API. Passe par la passerelle oanor.

En-têtes personnalisés (facultatif)
api.oanor.com/superhero-api

Ça marche. Récupérez une clé API et utilisez-la dans votre projet.

Obtenez une clé API

Extraits de code

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_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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
}