Query Forecasts | Silurian Docs

Query the available cyclone forecasts for a particular time

X-API-KEYstring

API Key authentication via header

timedatetimeOptional

Default value: (current time) - Default time zone: UTC

min_storm_categoryintegerOptional

basin_idsstringOptional

modelenumOptionalDefaults to GFTC

Allowed values:

Successful Response

storm_idstring

storm_namestring

categoryinteger

positionobject

forecast_timedatetime

forecast_source_infostring

forecast_last_updateddatetime

typestring

401

Forecasts List Request Unauthorized Error

404

Forecasts List Request Not Found Error

422

Forecasts List Request Unprocessable Entity Error

500

Forecasts List Request Internal Server Error

1	from silurian import Earth
2	import datetime
3
4	client = Earth(
5	api_key="YOUR_API_KEY_HERE",
6	)
7
8	client.cyclones.forecasts.list(
9	time=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
10	min_storm_category=1,
11	basin_ids=[
12	"basin_ids"
13	],
14	model="OFCL",
15	)

1	[
2	{
3	"storm_id": "AL092024",
4	"storm_name": "Hurricane Elsa",
5	"category": 2,
6	"position": {
7	"latitude": 25.3,
8	"longitude": -80.5
9	},
10	"forecast_time": "2024-08-15T09:30:00Z",
11	"forecast_source_info": "National Hurricane Center - GFS Model",
12	"forecast_last_updated": "2024-08-15T06:00:00Z",
13	"type": "Hurricane"
14	}
15	]