Near-real-time volcanic activity report from the United States based on the USGS report.

Limitation: Query time interval must be less than one minute. This will allow 1440 queries per day.

Resource URL

https://api.idemc.org/volcano_activity_us/v1/

Parameters

ParameterDescriptionOptionalDefault
api_key Authentication API key
status Set the "eruption" keyword, if you need only the erupted and active volcanoes data True

Example

POST https://api.idemc.org/volcano_activity_us/v1/

Request

  {
    "api_key" : "xycvbnm234ztr"
    "status" : "eruption"
}  

Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Thu, 11 Jun 2020 16:12:58 +0000",
        "url": "https://api.idemc.org/volcano_activity_us/v1/",
        "title": "IDEMC - Volcano activity report in the US",
        "status": 200,
        "message": "Data has been published",
        "api": "1.0.3",
        "count": 168
    },
    "features": [
        {
            "id": "78",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    "-169.945",
                    "52.8222"
                ]
            },
            "properties": {
                "main_category": "Geological Event",
                "sub_category": "volcano activity",
                "main_category_code": "GE",
                "sub_category_code": "VAC",
                "event_date": "2019-11-14T00:00:00+00:00",
                "event_update": "2020-06-02T07:50:05+00:00",
                "volcano_number": "311240",
                "volcano_name": "Cleveland",
                "area_code": "05",
                "area_name": "North America",
                "country_code": "5010",
                "country_name": "United States",
                "administration_area": "Alaska",
                "location": "Aleutians",
                "actual_alert_level_id": 3,
                "actual_alert_level_name": "WATCH",
                "actual_aviation_level_id": 3,
                "actual_aviation_level_name": "ORANGE",
                "actual_threat_level_id": 3,
                "actual_threat_level_name": "Moderate Threat"
            }
        }
    }  

Error Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Mon, 25 Nov 2019 16:15:54 +0000",
        "url": "https://api.idemc.org/volcano_activity_us/v1/",
        "title": "IDEMC - Volcano activity report in the US",
        "status": 600,
        "message": "Wrong, missing or expired api key",
        "api": "1.0.3",
        "count": 0
    }
}  

Resource Information

Rate Limited True
Response Format GeoJSON
Authentication 1