# NASA EONET

> Follow the natural events NASA tracks around the world: wildfires, storms, volcanic eruptions, floods, icebergs and more. Search them by kind, source, date, area and size, follow one event's track, get results as GeoJSON for a map, and start a workflow when a new event appears. No account or API key required.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/nasa-eonet

## Actions

### Get event

Get one natural event by its id (such as EONET_25339): its category, sources, whether it has ended, and every dated position and magnitude, such as a storm's whole track.

**Inputs**

- Event ID (`event_id`, text, required): The event's id, from 'List natural events' or the trigger. Its API link works too.

**Outputs**

- `event` (object): A natural event

**Example output**

```json
{
  "event": {
    "api_url": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_25339",
    "categories": [
      {
        "id": "severeStorms",
        "title": "Severe Storms"
      }
    ],
    "closed_at": null,
    "description": null,
    "geometry": [
      {
        "coordinates": [
          136.9,
          15.1
        ],
        "date": "2026-10-19T12:00:00Z",
        "latitude": 15.1,
        "longitude": 136.9,
        "magnitude_unit": "kts",
        "magnitude_value": 140.0,
        "type": "Point"
      },
      {
        "coordinates": [
          136.7,
          15.4
        ],
        "date": "2026-10-19T18:00:00Z",
        "latitude": 15.4,
        "longitude": 136.7,
        "magnitude_unit": "kts",
        "magnitude_value": 135.0,
        "type": "Point"
      }
    ],
    "geometry_count": 2,
    "id": "EONET_25339",
    "latest_date": "2026-10-19T18:00:00Z",
    "latitude": 15.4,
    "longitude": 136.7,
    "magnitude_unit": "kts",
    "magnitude_value": 135.0,
    "source_url": "https://www.metoc.navy.mil/jtwc/products/wp2826.tcw",
    "sources": [
      {
        "id": "JTWC",
        "url": "https://www.metoc.navy.mil/jtwc/products/wp2826.tcw"
      }
    ],
    "start_date": "2026-10-19T12:00:00Z",
    "status": "open",
    "summary": "Super Typhoon Champi (Severe Storms), open: last reported 19 Oct 2026 at 15.40\u00b0N, 136.70\u00b0E, 135 kts",
    "title": "Super Typhoon Champi"
  }
}
```

### Get events as GeoJSON

Run the same search as 'List natural events' and get the result as a GeoJSON map layer, with one point or area per dated position. Paste it into a mapping tool or save it as a .geojson file.

**Inputs**

- Status (`status`, text): Events still going on, ones that have ended, or both. Defaults to open events. One of: `open` (Open (still going on)), `closed` (Closed (ended)), `all` (Open and closed).
- Categories (`categories`, list): Only events in any of these categories, such as Wildfires or Severe Storms. Leave empty for every category.
- Sources (`sources`, list): Only events reported by any of these organisations, such as InciWeb or GDACS. Leave empty for every source.
- Last N days (`days`, number): Only events with a position dated in this many days up to today. Leave empty when you give a date range. From 1 to 3650.
- From date (`start_date`, date): Only events with a position dated on or after this day.
- To date (`end_date`, date): Only events with a position dated on or before this day. Defaults to today.
- Area: west edge (`west`, number): To search one area, give all four edges in degrees. This is the westernmost longitude, -180 to 180 (e.g. -125 for the US west coast). From -180 to 180.
- Area: south edge (`south`, number): The southernmost latitude, -90 to 90 (e.g. 24). From -90 to 90.
- Area: east edge (`east`, number): The easternmost longitude, -180 to 180 (e.g. -66). From -180 to 180.
- Area: north edge (`north`, number): The northernmost latitude, -90 to 90 (e.g. 50). From -90 to 90.
- Magnitude type (`magnitude_type`, text): What to measure events by, for the minimum and maximum: storm wind speed (kts), burned area (acres or hectares), iceberg area...
- Minimum magnitude (`magnitude_min`, number): Only events that reached at least this, in the magnitude type's unit (e.g. 64 kts for hurricane strength).
- Maximum magnitude (`magnitude_max`, number): Only events with a measurement at or below this.
- Maximum events (`limit`, number): How many events to return, 1 to 500. Defaults to 50. From 1 to 500.

**Outputs**

- `event_count` (number): How many events the features belong to
- `feature_count` (number): How many map features: one per dated position of each event
- `geojson` (object): A GeoJSON FeatureCollection, ready for a map or a .geojson file
- `summary` (text): How many features and events came back

**Example output**

```json
{
  "event_count": 1,
  "feature_count": 1,
  "geojson": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            136.7,
            15.4
          ],
          "type": "Point"
        },
        "properties": {
          "categories": [
            {
              "id": "severeStorms",
              "title": "Severe Storms"
            }
          ],
          "closed": null,
          "date": "2026-10-19T18:00:00Z",
          "description": null,
          "id": "EONET_25339",
          "link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_25339/geojson",
          "magnitudeUnit": "kts",
          "magnitudeValue": 135.0,
          "sources": [
            {
              "id": "JTWC",
              "url": "https://www.metoc.navy.mil/jtwc/products/wp2826.tcw"
            }
          ],
          "title": "Super Typhoon Champi"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "summary": "1 map feature for 1 event"
}
```

### List categories

List the kinds of event NASA tracks (Drought, Wildfires, Severe Storms, Volcanoes...), with what each one covers.

**Inputs**: None.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many categories came back

**Example output**

```json
{
  "categories": [
    {
      "description": "Related to both the physical effects of an eruption (rock, ash, lava) and the atmospheric (ash and gas plumes).",
      "id": "volcanoes",
      "title": "Volcanoes"
    }
  ],
  "count": 1
}
```

### List events in a category

List the events in one category, such as every open volcano eruption, together with what the category covers. Filter by source, open or closed, and the last few days or a date range.

**Inputs**

- Category (`category`, text, required): The category whose events to list, such as Volcanoes.
- Status (`status`, text): Events still going on, ones that have ended, or both. Defaults to open events. One of: `open` (Open (still going on)), `closed` (Closed (ended)), `all` (Open and closed).
- Sources (`sources`, list): Only events reported by any of these organisations, such as InciWeb or GDACS. Leave empty for every source.
- Last N days (`days`, number): Only events with a position dated in this many days up to today. Leave empty when you give a date range. From 1 to 3650.
- From date (`start_date`, date): Only events with a position dated on or after this day.
- To date (`end_date`, date): Only events with a position dated on or before this day. Defaults to today.
- Maximum events (`limit`, number): How many events to return, 1 to 500. Defaults to 50. From 1 to 500.

**Outputs**

- `category` (object): An event category
- `count` (number): How many events came back
- `events` (list): The events, most recent first
- `summary` (text): How many events, by category, such as '12 events: 9 Wildfires'

**Example output**

```json
{
  "category": {
    "description": "Related to both the physical effects of an eruption (rock, ash, lava) and the atmospheric (ash and gas plumes).",
    "id": "volcanoes",
    "title": "Volcanoes"
  },
  "count": 1,
  "events": [
    {
      "api_url": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_20710",
      "categories": [
        {
          "id": "volcanoes",
          "title": "Volcanoes"
        }
      ],
      "closed_at": null,
      "description": null,
      "geometry": [
        {
          "coordinates": [
            -71.38,
            -36.87
          ],
          "date": "2026-06-15T00:00:00Z",
          "latitude": -36.87,
          "longitude": -71.38,
          "magnitude_unit": null,
          "magnitude_value": null,
          "type": "Point"
        }
      ],
      "geometry_count": 1,
      "id": "EONET_20710",
      "latest_date": "2026-06-15T00:00:00Z",
      "latitude": -36.87,
      "longitude": -71.38,
      "magnitude_unit": null,
      "magnitude_value": null,
      "source_url": "https://volcano.si.edu/volcano.cfm?vn=357070",
      "sources": [
        {
          "id": "SIVolcano",
          "url": "https://volcano.si.edu/volcano.cfm?vn=357070"
        }
      ],
      "start_date": "2026-06-15T00:00:00Z",
      "status": "open",
      "summary": "Nevados del Chillan Volcano, Chile (Volcanoes), open: last reported 15 Jun 2026 at 36.87\u00b0S, 71.38\u00b0W",
      "title": "Nevados del Chillan Volcano, Chile"
    }
  ],
  "summary": "1 event: 1 Volcanoes"
}
```

### List imagery layers

List the NASA satellite imagery layers (web map services) that suit a category, such as fire detections and true-colour images for Wildfires, or every layer when no category is chosen. Each comes with its service address and format.

**Inputs**

- Category (`category`, text): The category to list layers for. Leave empty for all.

**Outputs**

- `category` (object): The category asked for, empty when listing every layer
- `count` (number): How many layers came back
- `layers` (list): The imagery layers

**Example output**

```json
{
  "category": {
    "id": "wildfires",
    "title": "Wildfires"
  },
  "count": 1,
  "layers": [
    {
      "format": "image/jpeg",
      "name": "MODIS_Terra_CorrectedReflectance_TrueColor",
      "parameters": {
        "FORMAT": "image/jpeg",
        "TILEMATRIXSET": "250m"
      },
      "service_type": "WMTS 1.0.0",
      "service_type_id": "WMTS_1_0_0",
      "service_url": "https://gibs.earthdata.nasa.gov/wmts/epsg4326/best/wmts.cgi",
      "tile_matrix_set": "250m"
    }
  ]
}
```

### List magnitude types

List the ways NASA measures an event's size, such as a storm's wind speed in knots or a fire's burned area in acres, with the id to filter events by.

**Inputs**: None.

**Outputs**

- `count` (number): How many magnitudes came back
- `magnitudes` (list): The magnitude types

**Example output**

```json
{
  "count": 1,
  "magnitudes": [
    {
      "description": "Average Max Sustained Winds reported for severe storms.",
      "id": "mag_kts",
      "name": "Avg Max Windspeed (kts)",
      "unit": "kts"
    }
  ]
}
```

### List natural events

Find natural events NASA is tracking, such as wildfires, storms, volcanic eruptions, floods and icebergs. Filter by category, source, open or closed, the last few days or a date range, an area on the map, and size (wind speed, burned area...). Each event comes with its latest position and magnitude, every dated position, and a one-line summary.

**Inputs**

- Status (`status`, text): Events still going on, ones that have ended, or both. Defaults to open events. One of: `open` (Open (still going on)), `closed` (Closed (ended)), `all` (Open and closed).
- Categories (`categories`, list): Only events in any of these categories, such as Wildfires or Severe Storms. Leave empty for every category.
- Sources (`sources`, list): Only events reported by any of these organisations, such as InciWeb or GDACS. Leave empty for every source.
- Last N days (`days`, number): Only events with a position dated in this many days up to today. Leave empty when you give a date range. From 1 to 3650.
- From date (`start_date`, date): Only events with a position dated on or after this day.
- To date (`end_date`, date): Only events with a position dated on or before this day. Defaults to today.
- Area: west edge (`west`, number): To search one area, give all four edges in degrees. This is the westernmost longitude, -180 to 180 (e.g. -125 for the US west coast). From -180 to 180.
- Area: south edge (`south`, number): The southernmost latitude, -90 to 90 (e.g. 24). From -90 to 90.
- Area: east edge (`east`, number): The easternmost longitude, -180 to 180 (e.g. -66). From -180 to 180.
- Area: north edge (`north`, number): The northernmost latitude, -90 to 90 (e.g. 50). From -90 to 90.
- Magnitude type (`magnitude_type`, text): What to measure events by, for the minimum and maximum: storm wind speed (kts), burned area (acres or hectares), iceberg area...
- Minimum magnitude (`magnitude_min`, number): Only events that reached at least this, in the magnitude type's unit (e.g. 64 kts for hurricane strength).
- Maximum magnitude (`magnitude_max`, number): Only events with a measurement at or below this.
- Maximum events (`limit`, number): How many events to return, 1 to 500. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many events came back
- `events` (list): The events, most recent first
- `summary` (text): How many events, by category, such as '12 events: 9 Wildfires'

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "api_url": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_25339",
      "categories": [
        {
          "id": "severeStorms",
          "title": "Severe Storms"
        }
      ],
      "closed_at": null,
      "description": null,
      "geometry": [
        {
          "coordinates": [
            136.9,
            15.1
          ],
          "date": "2026-10-19T12:00:00Z",
          "latitude": 15.1,
          "longitude": 136.9,
          "magnitude_unit": "kts",
          "magnitude_value": 140.0,
          "type": "Point"
        },
        {
          "coordinates": [
            136.7,
            15.4
          ],
          "date": "2026-10-19T18:00:00Z",
          "latitude": 15.4,
          "longitude": 136.7,
          "magnitude_unit": "kts",
          "magnitude_value": 135.0,
          "type": "Point"
        }
      ],
      "geometry_count": 2,
      "id": "EONET_25339",
      "latest_date": "2026-10-19T18:00:00Z",
      "latitude": 15.4,
      "longitude": 136.7,
      "magnitude_unit": "kts",
      "magnitude_value": 135.0,
      "source_url": "https://www.metoc.navy.mil/jtwc/products/wp2826.tcw",
      "sources": [
        {
          "id": "JTWC",
          "url": "https://www.metoc.navy.mil/jtwc/products/wp2826.tcw"
        }
      ],
      "start_date": "2026-10-19T12:00:00Z",
      "status": "open",
      "summary": "Super Typhoon Champi (Severe Storms), open: last reported 19 Oct 2026 at 15.40\u00b0N, 136.70\u00b0E, 135 kts",
      "title": "Super Typhoon Champi"
    }
  ],
  "summary": "1 event: 1 Severe Storms"
}
```

### List sources

List the organisations NASA takes events from, such as InciWeb, the Joint Typhoon Warning Center and GDACS, with their websites.

**Inputs**: None.

**Outputs**

- `count` (number): How many sources came back
- `sources` (list): The sources

**Example output**

```json
{
  "count": 1,
  "sources": [
    {
      "id": "InciWeb",
      "title": "InciWeb",
      "url": "https://inciweb.nwcg.gov/"
    }
  ]
}
```
