Weather Forecast API - Spire Point, Airport and Tide Forecasts

Pull global weather forecasts for any latitude and longitude, optimized forecasts for more than 10,000 airports, ports and weather stations, current weather conditions and tides from the Spire Weather API with your own key, as clean dataset rows.

Works with the official Spire Weather API on api.wx.spire.com: the Point Forecast API (Spire's satellite-initialised global model SOF-D at 1/8 degree, hourly to 48 hours and 6 hourly to 15 days), the Optimized Point Forecast API, Current Weather Conditions and Tides. Each forecast time step becomes one row with temperature, dew point, humidity, wind, gusts, precipitation, cloud, pressure and visibility as flat columns, plus every variable of the bundles you pick (maritime waves and currents, thunderstorm, agricultural soil, clouds, wind and solar energy, precipitation type). Download as JSON, CSV or Excel, schedule it, or feed it into logistics planning, energy trading, agriculture, shipping, aviation dashboards, Google Sheets and AI agents. Bring your own API key.

BYOK, not live-tested: every endpoint, parameter and value comes from Spire's published documentation on developers.wx.spire.com, and every route was confirmed to exist on api.wx.spire.com, but the actor has not been run against a live Spire subscription.

What it does

• Point forecast by coordinates: the Spire global forecast for each latitude and longitude, one row per lead time. Choose the time bundle (hourly to 48 hours, 3 hourly to 5 days, 6 hourly to 7, 10 or 15 days), the model run, a valid time window and up to 14 data bundles.
• Optimized forecast for airports, ports and stations: Spire's machine-learning optimized forecast, refreshed every hour, for ICAO airports (icao:KJFK), WMO stations (wmo:72259) and UN/LOCODE ports (unlocode:NLAMS), with ceiling, fog and thunderstorm probability, precipitation probability, snowfall, ice, heat index, wind chill and degree days, hourly to 15 days.
• Current weather by coordinates: the hourly 3 km current conditions analysis: temperature, dew point, humidity, wind and gusts, sea level pressure, precipitation rate and type, visibility, shortwave radiation and cloud amount.
• Hourly tide height: astronomical tide height relative to mean sea level at 1/16 degree, from 1990 onwards, past and future in one query, up to 10 days per request.
• High and low tides: the time and height of every high and low tide between two dates.
• Units and time zones: SI, US (Celsius) or US with Fahrenheit, and times in UTC, any IANA time zone or local time at the point. Every row carries the unit of each field.
• Pay only for results: refused and empty lookups are recorded as a free row that says why, never charged.

How to get an API key

Spire Weather keys are issued by Spire, not self-served. Email the Spire Weather team (weather@spire.com) or use the contact form on spire.com to request a trial (usually one week) or a subscription, naming the products (Standard Point API, Optimized Point API), bundles (for example basic, maritime, agricultural) and forecast range you need. Your key arrives in your welcome email. Paste it into the API key field. It is sent only in the spire-api-key header to api.wx.spire.com and is never logged. A key opens only the products, bundles and time bundles on its plan.

Input

Field	Modes	Description
mode	all	pointForecast, optimizedForecast, currentWeather, tides or tideExtrema
locations	point, current, tides	One latitude,longitude per line, such as 40.7128,-74.0060
stations	optimized	icao:KJFK, wmo:72259, unlocode:NLAMS, a bare ICAO code such as EGLL, or a location UUID
bundles	point	basic (default), basic-accumulation, maritime, maritime-atmos, maritime-wave, maritime-wave-ext, thunderstorm, agricultural, clouds, wind-energy, solar-energy, solar-energy-accumulation, precipitation, precipitation-accumulation
optimizedBundle	optimized	basic (default), wind-energy or solar-energy
timeBundle	point, optimized	hourly (default), 3_hourly, 6_hourly, 6_hourly_extended, 6_hourly_10day, 6_hourly_15day, hourly_6day, or all (optimized only)
issuanceTime	point, optimized	Model run as ISO 8601, such as 2026-10-16T00:00:00Z. Empty means the latest
validTimeInterval	point, optimized	ISO 8601 interval, such as 2026-10-16T00:00:00Z/P1D
currentTime	current	ISO 8601 time or range within the past 72 hours. Empty means the latest
startDate	tides	ISO 8601 date or date-time
endDate	high and low tides	ISO 8601 date or date-time. Empty means three days after the start
tideHours	hourly tides	1 to 240 hours from the start. Empty means 240
unitSystem	all	si, us or us-f. Empty means SI
timezone	point, optimized, current	IANA name such as Europe/Amsterdam, or local. Empty means UTC
maxResults	all	Row ceiling for the run (default 100)
requestsPerMinute	all	Pacing, default 30
apiKey	all	Your Spire Weather API key (or the DATA_API_KEY secret)

Example: a 15 day, 6 hourly forecast with waves for two offshore points.

{
    "mode": "pointForecast",
    "locations": ["26.71,-22.41", "51.98,3.95"],
    "bundles": ["basic", "maritime"],
    "timeBundle": "6_hourly_15day",
    "maxResults": 200
}

Example output

An illustrative point forecast row, shaped like Spire's documented Point API response (values are an example, not real data). Every value Spire returns is kept as its own column and in the values object; only a few are shown.

{
    "mode": "pointForecast",
    "recordType": "forecast",
    "identifier": "40.018672,-105.250537",
    "found": true,
    "latitude": 40.018672,
    "longitude": -105.250537,
    "elevation": 1655.2,
    "locationName": null,
    "issuanceTime": "2026-10-16T00:00:00+00:00",
    "validTime": "2026-10-16T06:00:00+00:00",
    "airTemperature": 287.7,
    "dewPointTemperature": 284.2,
    "relativeHumidity": 79.0,
    "windSpeed": 3.1,
    "windDirection": 193.0,
    "windGust": 6.5,
    "precipitationRate": 0.0,
    "precipitationAmount": 0.0,
    "totalCloudCover": 100.0,
    "seaLevelPressure": 101708.8,
    "visibility": 24135.3,
    "tideEvent": null,
    "tideHeight": null,
    "unitSystem": "si",
    "forecastModel": "Spire SOF-D Forecast",
    "units": { "air_temperature": "degreeK", "wind_speed": "m/s", "precipitation_amount": "mm" },
    "air_temperature": 287.7,
    "eastward_wind": 0.7,
    "northward_wind": 3.0,
    "retrievedAt": "2026-10-16T08:00:00.000Z",
    "note": null
}

FAQ

What is the Spire Weather API?

Spire Weather is the weather data business of Spire Global (NYSE: SPIR), which runs its own satellite constellation and feeds radio occultation data into a proprietary global forecast model. The Spire Weather API on api.wx.spire.com serves point, route and file forecasts, an optimized point forecast for fixed locations, current conditions, tides, lightning, storm tracks and historical weather, authenticated with an API key in the spire-api-key header.

Do I need my own Spire Weather API key?

Yes. This is a bring-your-own-key actor: it calls Spire with your key, under your Spire contract and its terms. A missing or rejected key, or a bundle or time bundle outside your plan, ends the run cleanly with a status message that explains what to change, and nothing is charged.

What is the difference between the point forecast and the optimized forecast?

The point forecast samples Spire's global model (about 14 km) at any coordinate. The optimized forecast blends Spire's model with other global and regional models and local observations through machine learning for one fixed location, refreshed every hour, and is available for more than 10,000 airports, maritime ports and weather stations.

How far ahead do the forecasts go?

The global model runs four times a day. The 00 and 12 UTC runs reach 48 hours hourly, 5 days 3 hourly and 15 days 6 hourly; the 06 and 18 UTC runs cover 24 hours. The optimized forecast is hourly to 15 days with the all time bundle. Which ranges you can read depends on your subscription.

Why does the latest forecast sometimes have fewer rows?

Spire publishes a run while its later lead times are still being computed. If you need a complete run, set the issuance time to the previous run, or compare the row count with the time bundle (49 rows for hourly on a 00 or 12 UTC run).

What units are the values in?

SI by default: Kelvin, metres per second, Pascals, millimetres and metres. Choose us for Celsius, mph and hPa, or us-f for Fahrenheit. The units column of every row lists the unit of each field, straight from the API.

What do I pay?

Pay per result: 0.005 USD per row, where a row is one forecast time step, one current weather record, one tide hour or one high or low tide. Refused and empty lookups are never charged. Your Spire subscription is billed separately by Spire. Each location or station is one Spire API request.

Pricing

Event	Price	Charged for
weather-record	0.005 USD	Each forecast time step, current weather record, tide hour or high or low tide

Keyword map

weather API, weather forecast API, point forecast API, Spire Weather API, Spire Global weather data, hourly weather forecast, 15 day forecast, airport weather forecast, ICAO weather, port weather, maritime weather, wave forecast, ocean current forecast, wind forecast, solar irradiance forecast, wind energy forecast, agricultural weather, soil moisture forecast, current weather API, tide API, tide times, high and low tide, weather data for AI agents.

Terms and data use

Spire Weather data is licensed under your Spire Order Form and the Spire Data Service Terms (published with the Spire Weather Data Description and Data Order Form on spire.com/our-data/terms-of-use). The standard licence is non-exclusive and non-transferable, for Internal Use and for Derivative Works for Internal Use during the term, plus any Permitted External Use your Order Form allows. Distributing the data to third parties needs a separate Distribution License, the data must not be used to build a competing service, Spire's notices must be kept, and on termination the data must no longer be used and must be destroyed (copies may remain on archival or backup systems). Run this actor with your own key, keep the results for your own internal use within your licence, and contact Spire before sharing or reselling the data. This actor is not affiliated with or endorsed by Spire Global.