Spire’s Soil Moisture Insights are satellite-derived daily surface soil moisture products at 6 km (d-mssm), 500 m (d-essm) and 100 m (d-hssm), with near-real-time, forecast and anomaly variants. They are served through the endpoints below with the same API key and base URL as the weather products.
Endpoints¶
| Method | Endpoint | Description |
|---|---|---|
| GET | /soil-moisture/region | List regional soil moisture files (NetCDF or GeoTIFF) |
| GET | /soil-moisture/region/{file_id} | Download a regional file |
| GET | /soil-moisture/point | Get a daily soil moisture time series at a point |
| POST | /soil-moisture/historical/point | Request historical point data (asynchronous job) |
| POST | /soil-moisture/historical/region | Request a historical regional file (asynchronous job) |
| GET | /soil-moisture/historical/status/{job_uuid} | Check a historical job |
| GET | /soil-moisture/historical/download/{job_uuid} | Download the result of a completed job |
Quick Example¶
List the most recent regional files for the default product:
Shell
Python
Node.js
curl -X GET \
'https://api.wx.spire.com/soil-moisture/region?product=d-mssm' \
-H 'spire-api-key: YOUR_API_KEY'import requests
response = requests.get(
"https://api.wx.spire.com/soil-moisture/region",
params={"product": "d-mssm"},
headers={"spire-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://api.wx.spire.com/soil-moisture/region?product=d-mssm",
{ headers: { "spire-api-key": "YOUR_API_KEY" } }
);
const data = await response.json();The parameters accepted by each endpoint are described in the Swagger UI and, with full context, at developers