Vai al contenuto
GET /v1/search

Search by name with country / type / region filters

Provalo dal vivo

10 chiamate gratuite al giorno — senza registrazione, senza chiave API. Passa dal gateway oanor.

Intestazioni personalizzate (facoltative)
api.oanor.com/volcanoes-api

Funziona. Prendi una chiave API e usala nel tuo progetto.

Ottieni una chiave API

Frammenti di codice

curl "https://api.oanor.com/volcanoes-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/volcanoes-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/volcanoes-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/volcanoes-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "count": 1,
        "limit": 20,
        "query": "fuji",
        "total": 1,
        "offset": 0,
        "filters": {
            "type": null,
            "region": null,
            "country": null
        },
        "results": [
            {
                "id": 283030,
                "name": "Fujisan",
                "type": "Stratovolcano",
                "region": "Northwestern Pacific Volcanic Regions",
                "country": "Japan",
                "landform": "Composite",
                "latitude": 35.361,
                "longitude": 138.728,
                "subregion": "Izu Volcanic Arc",
                "elevation_m": 3776,
                "last_eruption": "1708",
                "geologic_epoch": "Holocene",
                "tectonic_setting": "Subduction zone / Continental crust (> 25 km)"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T03:47:07.707Z",
        "request_id": "a08cbf86-a673-465c-aa9f-3318f2d8c544"
    },
    "status": "ok",
    "message": "Volcanoes listed",
    "success": true
}