Tomorrow.io LLM-Friendly Weather API Documentation

Note

Any attributes not listed on this page should not be in use, they are in beta, and might be deprecated or changed at a later date.

Severe Weather Events Category Subscriptions

Our API provides standardized severe weather events from many sources that can be equipped for "historical awareness", allowing developers to include the whole picture across all of their regional, and most importantly, global insight and alert needs.

In addition to subscribing to any of the Severe Weather Events below, you can create Custom Insight categories based on any of the data you have tracked in historical Event Timelines.

Severe Weather Events Category	Regions Availability
Air	United States, Canada
Fires	United States, Canada, Europe
Wind	United States, Canada, Europe
Winter	United States, Canada, Europe
Thunderstorms	United States, Canada, Europe
Floods	United States, Canada, Europe
Temperature	United States, Canada
Tropical	United States, Canada
Marine	United States, Canada, Europe
Fog	United States, Canada, Europe
Tornado	United States, Canada

Accessing Severe Weather Events

Severe weather events through the Insights API using the Events API and get prepared before a Severe Weather Event happens.

Event Title

Various weather classifications have different types of risk. Therefore, the title of our predefined categories use the common event tier "severe weather" as a highly recommended to follow this standard as well when defining your custom insights.

These are the common levels in increasing order:

Level

Outlook

Advisory

Emergency

Watch

Warning

Statement

Description

Issued early to indicate that a hazardous event may occur in the next several days and is intended to provide information to those who have considerable lead time to prepare for the event.

Issued when a hazardous event is occurring, imminent or likely. Generally greater than 80% probability of occurrence. Usually not more than 12 hours until the event.

Issued when an event that by itself would not be considered a threat to life or property, but may cause significant inconvenience, and if caution is not exercised, it could lead to situations that may threaten life or property.

Issued when there is a hazardous event that has increased significantly (50 to 80% certainty) that warning thresholds will be met but it is uncertain, therefore, or during a 12-hour attention span is intended to provide advance notice of potential weather or water-related hazards.

Issued when a hazardous event is occurring, imminent or likely. Generally greater than 80% probability of occurrence. Usually not more than 12 hours until the event.

Issued on a follow-up message to a warning, watch, or emergency. This may update, extend, cancel, expire, or cancel the subject event or provide additional significant weather or water-related information.

Event Description

Usually, when recording a weather event the following are expected to be described:

What is going to happen?
When will it take place?
Where will it occur?
How severe will it be/expected?
ACTIONS precautionary or in preparation needed?

It is common and recommended to follow each event with a precautionary statement and their specific official such as "...for" the expected availability.

Below is an example of a weather announcement description, as reported by the NOAA:

Weather Description ExampleTEXT
...HEAT...for the High East Warning, dangerously large breakthrough of 14 to 15 feet expected in the surf zone. The Highest Current Risk, despite

Event Severity

The code denoting the severity of impact.

Level	Description
Extreme	Extraordinary threat to life or property
Severe	Significant threat to life or property
Moderate	Possible threat to life or property
Minor	Minimal or no known threat to life or property
Unknown	Severity unknown

Event Urgency

The code denoting the time available to prepare.

Level	Description
Immediate	Responsive action SHOULD be taken immediately
Expected	Responsive action SHOULD be taken soon (within next hour)
Future	Responsive action SHOULD be taken in the near future
Past	Responsive action is no longer required
Unknown	Urgency not known

Event Certainty

The code denoting the confidence in the observation or prediction.

Level	Description
Observed	Determined to have occurred or to be ongoing
Likely	Likely (p > ~50%)
Possible	Possible but not likely (p <= ~50%)
Unlikely	Not expected to occur (p ~ 0)
Unknown	Certainty unknown

Event Response

An action code denoting the appropriate handling.

Action	Description
Shelter	Take shelter in place or as instructed
Evacuate	Relocate as instructed
Prepare	Make preparations as instructed
Execute	Execute a pre-planned activity as instructed
Avoid	Avoid the subject event as instructed
Monitor	Attend to information sources as instructed
Assess	Evaluate the information in this message
AllClear	The subject event no longer poses a threat or concern; follow up as instructed
None	No action recommended

Event Instructions

A text briefly that intended to enter response instructions, for example: "Show down and use caution while traveling. The hazardous conditions could restrict visibility and create dangerous while traveling."

Event Geocode and Locations

geocode is a string of geographically bound string that describe the event target area, as mentioned in the geocodeType attribute, reference. You can use it as a GeoJSON (geometry representing the Event coverage area from the Point, Polygon, or MultiPolygon types.

Subdivisions Landscape

On channel Events