Severe Weather Alerts API

This API returns severe weather alerts issued by local meteorological agencies. Current supported countries include: The USA via NOAA. As well as European Union member nations, and Isreal via Meteoalarm.

Note: Alerts are typically issued in the language of the local country.

Base URL

Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
callback=[function] (optional: JSON-P callback)

API Endpoints

Description Required Parameters Example(s)
Get alerts by lat/lon lat,lon &lat=38.123&lon=-78.543
Get alerts by city name city, state(optional), country (optional)
  • &city=Raleigh&country=US
  • &city=Raleigh,NC
  • &city=Raleigh,North+Carolina
Get alerts by postal code postal_code, country (optional) &postal_code=27601&country=US
Get alerts by city id city_id &city_id=8953360

Example Request:

Example Response (JSON):

           "city_name":"Sainte Genevieve",
                 "title":"Winter Weather Advisory issued February 9 at 3:17AM CST expiring February 10 at 12:00PM CST by NWS St Louis MO",
                 "description":"* WHAT...Mixed precipitation expected. Total snow and sleet\naccumulations of less than one inch, and ice accumulations of\nup to one tenth of an inch expected.\n\n* WHERE...Portions of east central and southeast Missouri and\nsouthwest Illinois.\n\n* WHEN...From midnight tonight to noon CST Sunday.\n\n* ADDITIONAL DETAILS...Plan on slippery road conditions.",
                    "St. Francois",
                    "Ste. Genevieve",
                 "title":"Flood Warning issued February 8 at 8:51PM CST expiring February 12 at 8:24AM CST by NWS St Louis MO",
                 "description":"Mississippi River at Chester\n\n.This Flood Warning is a result of 1-2 inches of rainfall across\nthe basin earlier this week...\nThe Flood Warning continues for\nthe Mississippi River at Chester\n* until Tuesday morning.\n* At  8:30 PM Friday the stage was 26.8 feet.\n* Flood stage is 27.0 feet.\n* Minor flooding is forecast.\n* The river is forecast to rise above flood stage by tonight and to\ncrest near 29.0 feet by Saturday evening. The river is forecast to\nfall below flood stage by Monday morning.\n* Impact:  At 28.0 feet...Unleveed islands near Chester and the prison\nfarm floods.\n* Impact:  At 27.0 feet...Flood Stage.  Unprotected farmland on right\nbank begins to flood.",
                    "Randolph, IL",
                    "Jackson, IL",
                    "Ste. Genevieve, MO",
                    "Perry, MO"

Field Decriptions:

  • lat: Latitude (Degrees).
  • lon: Longitude (Degrees).
  • timezone: Local IANA Timezone.
  • city_name: Nearest city name.
  • state_code: State abbreviation/code.
  • country_code: Country abbreviation.
  • alerts: [
    • title: Brief description of the alert.
    • description: Detailed description of the alert.
    • severity: Severity of the weather phenomena - Either "Advisory", "Watch", or "Warning".
    • effective_utc: UTC time that alert was issued.
    • effective_local: Local time that alert was issued.
    • expires_utc: UTC time that alert expires.
    • expires_local: Local time that alert expires.
    • uri: An HTTP(S) URI that one may refer to for more detailed alert information.
    • regions: An array of affected regions.
  • ]