/v1/search
Search by name with country / type / region filters
Essayez-le en direct
10 appels gratuits par jour — sans inscription, sans clé API. Passe par la passerelle oanor.
Ça marche. Récupérez une clé API et utilisez-la dans votre projet.
Obtenez une clé APIExtraits de code
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_..."}
)
Exemple de réponse
Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.
{
"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
}