Severe Weather Alerts API
This API returns severe weather alerts issued by local meteorological agencies. Current supported countries include: The USA via NOAA. European Union member nations, the United Kingdom, and Israel via Meteoalarm. As well as weather alerts for Canada via Environment Canada, and China via the China Meteorological Administration.
Note: Alerts are typically issued in the language of the local country.
Base URL
HTTP: http://api.weatherbit.io/v2.0/alerts
HTTPS: https://api.weatherbit.io/v2.0/alerts
Supported Methods: GET
Request Parameters
key=[key] (REQUIRED)
key
- Your API Key.
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) |
|
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:
https://api.weatherbit.io/v2.0/alerts?lat=39.75895&lon=-84.19161&key=API_KEY
Example Response (JSON):
{
"country_code":"US",
"lon":-84.19161,
"timezone":"America\/New_York",
"lat":39.75895,
"alerts":[
{
"regions":[
"Madison",
" Franklin",
" Scioto",
" Hardin",
" Logan",
" Licking",
" Montgomery",
" Clermont",
" Fayette",
" Brown",
" Mercer",
" Wayne",
" Adams",
" Union",
" Warren",
" Highland",
" Lewis",
" Ross",
" Robertson",
" Clark",
" Fayette",
" Preble",
" Shelby",
" Clinton",
" Franklin",
" Pike",
" Miami",
" Delaware",
" Bracken",
" Greene",
" Auglaize",
" Hocking",
" Fairfield",
" Butler",
" Champaign",
" Pickaway",
" Darke",
" Mason",
" Union"
],
"ends_utc":"2020-10-17T13:00:00",
"effective_local":"2020-10-16T14:17:00",
"onset_utc":"2020-10-17T06:00:00",
"expires_local":"2020-10-16T22:30:00",
"expires_utc":"2020-10-17T02:30:00",
"ends_local":"2020-10-17T09:00:00",
"uri":"https:\/\/api.weather.gov\/alerts\/NWS-IDP-PROD-4486346-3727122",
"onset_local":"2020-10-17T02:00:00",
"effective_utc":"2020-10-16T18:17:00",
"severity":"Watch",
"title":"Freeze Warning issued October 16 at 2:17PM EDT until October 17 at 9:00AM EDT by NWS Wilmington OH",
"description":"* WHAT...Sub-freezing temperatures as low as 30 expected.\n\n* WHERE...Portions of East Central and Southeast Indiana,\nNortheast and Northern Kentucky and Central, South Central,\nSouthwest and West Central Ohio.\n\n* WHEN...From 2 AM to 9 AM EDT Saturday.\n\n* IMPACTS...Frost and freeze conditions will kill crops, other\nsensitive vegetation and possibly damage unprotected outdoor\nplumbing."
}
],
"city_name":"Dayton",
"state_code":"OH"
}
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.onset_utc:
UTC time that alert event starts (If available).onset_local:
Local time that alert event starts (If available).ends_utc:
UTC time that alert event ends (If available).ends_local:
Local time that alert event ends (If available).uri:
An HTTP(S) URI that one may refer to for more detailed alert information.regions:
An array of affected regions.]