Μετάβαση στο περιεχόμενο
GET /v1/search

Search heroes by name (+ filters)

Δοκιμάστε το ζωντανά

10 δωρεάν κλήσεις την ημέρα — χωρίς εγγραφή, χωρίς κλειδί API. Μέσω του gateway του oanor.

Προσαρμοσμένες κεφαλίδες (προαιρετικά)
api.oanor.com/superhero-api

Δουλεύει. Πάρε ένα κλειδί API και χρησιμοποίησέ το στο έργο σου.

Λάβετε ένα κλειδί API

Αποσπάσματα κώδικα

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

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

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