Overview

Tomorrow.io's Historical Weather API allows you to query weather conditions (limited to historical data layers ]) by specifying the location (GeoJSON of a Point, LineString or Polygon), fields ("temperature", "windSpeed", ...), timesteps ("1h", "1d") and the startTime and endTime, such that the response include a historical timeline.

Polygon and Polyline limits:

  • Polygon - 10,000 square km and no more than 70km per segment.
  • Polyline - 2,000 km long.
  • Max number of vertices - 550.

Timerange is limited to up to 30 days per API call.

If the location is a Polygon or a Polyline, you can specify whether you want the min/max/avg values throughout that coverage area by adding them as a suffix to any of the available fields (temperatureMax, temperatureMaxTime) and if not specified the response will default to Max.

The historical archive is based on observations and differs from our forecast based Timeline API.
Please note that our reanalysis model takes between 7 to 90 days to calculate the data fields. Please see the historical data field Availability.