Standard APIGET /v1/alerts

Weather Alerts API

Government-issued severe weather warnings and watches for any location, in real time.

Retrieve the latest active alerts — tornado warnings, hurricane watches, flood advisories, heat emergencies, winter storm warnings — exactly as issued by national meteorological agencies including the US National Weather Service, the UK Met Office, and others worldwide. Integrate life-safety notifications into your app with a single API call.

Get Free API Key View Full Docs

What You Get with the Weather Alerts API

Official government sources

Alerts are sourced directly from national meteorological agencies — no third-party re-processing that could delay or alter warnings.

Headline, severity & urgency

Each alert includes headline, event type, severity (Minor/Moderate/Severe/Extreme), and urgency (Immediate/Expected/Future).

Full description text

The complete alert description, instruction text, and effective/expiry timestamps — ready to display verbatim to users.

Bundled with forecast

Set alerts=yes in any /v1/forecast request to include active alerts in the same response — no extra call needed.

Covers 140+ countries

Coverage extends beyond the US to include UK, EU member states, Australia, Canada, Japan, and many more.

Zero latency on critical data

Our ingestion pipeline prioritises alert propagation so your users receive warnings as soon as agencies publish them.

Who Uses This API

From startups to enterprise teams, the Weather Alerts API powers a wide range of real-world applications.

Travel & navigation apps

Warn users of severe weather at their destination or along their route before they depart — reducing surprise and risk.

Facility & building management

Trigger automated responses (close roof vents, evacuate outdoor areas) when a severe alert is issued for your site's location.

News & media platforms

Automatically pull and display current weather warnings alongside local news articles and live event coverage.

Emergency response platforms

Feed government alerts into first-responder dispatch systems and community notification tools.

Request Parameters

Parameter	Type	Required	Description	Example
q	string	Required	Location — city, lat/lon, or postcode	Miami, FL

Authenticate every request with the X-API-Key header.

Code Example

Request

cURL

curl "https://api.weatherai.io/v1/alerts?q=Miami,FL" \
  -H "X-API-Key: your-api-key"

Response

200 OKapplication/json

{
  "location": { "name": "Miami", "region": "Florida", "country": "USA" },
  "alerts": [
    {
      "headline": "Tropical Storm Watch issued for Miami-Dade County",
      "event": "Tropical Storm Watch",
      "severity": "Moderate",
      "urgency": "Expected",
      "description": "Tropical storm conditions possible within 48 hours...",
      "effective": "2024-08-10T14:00:00Z",
      "expires": "2024-08-12T02:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
location	object	Location name, region, country, coordinates
alerts[]	array	Array of active alerts (empty if none)
alerts[].headline	string	Short alert headline
alerts[].event	string	Event type (e.g. Tornado Warning)
alerts[].severity	string	Minor \| Moderate \| Severe \| Extreme
alerts[].urgency	string	Immediate \| Expected \| Future
alerts[].description	string	Full alert text as issued by the agency
alerts[].effective	string	Alert effective date/time (ISO 8601)
alerts[].expires	string	Alert expiry date/time (ISO 8601)

Start Using the Weather Alerts API Today

Create a free account and get your API key in under a minute. 1,000 free calls per day. No credit card required.

Get Your Free API Key