The weather, in one
straightforward call.
Give an agent a set of coordinates and the forecast sections it needs. One typed JSON request can return current conditions, minute-by-minute precipitation, hourly forecasts, and daily outlooks with stable field names.
A small tool definition
The API accepts typed JSON with named sections and variables, familiar units, ISO-8601 dates, and stable field names. A useful weather tool stays short:
{
"name": "get_weather",
"description": "Current conditions and forecast for a coordinate.",
"url": "https://api.weatherkind.com/v1/forecast",
"method": "POST",
"body": {
"location": { "latitude": 39.19, "longitude": -106.82 },
"units": "us",
"current": { "variables": ["temperature", "condition"] }
}
} The endpoints
The same endpoint list is available in /llms.txt. Add it to an agent's context, point a crawler at it, or give it to a coding agent.
- POST /v1/forecast { location, units?, current?, quarter_hourly?, hourly?, daily? }
Named forecast sections with flat values: current, quarter_hourly, hourly, and daily.
- POST /v1/nowcast { location, timezone?, units? }
Pro+ (nowcast:read). Fixed two-hour precipitation nowcast in one-minute steps, including amount, rate, probability, confidence, and hazard signals when available.
- POST /v1/route { path, departure_time?, travel?, sample?, units?, variables? }
Pro+ (route:read). Forecast along a drive or hike, sampled by time and evaluated at each point's arrival time. Waypoints carry either their own times or a departure_time plus a travel mode; hiking is paced by Naismith's rule. Returns per-sample values plus a summary of extremes and the precipitation, freezing, and high-wind stretches.
- POST /v1/airport-delay { airport, destination?, scheduled_departure_time?, scheduled_arrival_time?, hours? }
Weather-attributed delay severity, cancellation risk, operated-flight delay probabilities, freshness, and probabilistic attribution for a supported US airport or exact route. Requires airport_delay:read.
- POST /v1/accuracy { scope, days?, units?, minutely?, hourly?, daily?, compare_to?, include? }
Verified error vs real station observations for a locality, weather region, or the whole network: error and bias by lead, precipitation event skill, probability calibration, and an optional persistence skill score.
- POST /v1/historical { location, timezone?, units?, start, end, variables, include? }
Field-selectable daily observations for completed local dates: maximum/minimum temperature, precipitation, rain total, snow total, and AQI, with optional station and source provenance.
- POST /v1/alerts { location, include? }
CAP-aligned active public alerts for an exact point.
- POST /v1/outlook { location, units?, start, end, variables }
Daily climate outlook for days 15 through 365.
- GET /v1/geocode q
Place search: name → coordinates.
Designed for agent workflows
A single forecast response can include current, quarter-hourly, hourly, and daily sections. The agent does not have to coordinate several requests to answer a normal weather question.
Named sections and variables keep responses focused. An agent can ask for temperature and precipitation without spending context on every available weather field.
The same API covers upcoming weather and completed local dates. Agents can answer “what will happen?” and “what happened?” with the same location shape and unit system.
Weatherkind ingests raw NOAA and ECMWF model output and runs its own engine. The forecast does not come from another commercial weather API.
Paths are versioned, changes within a version are additive, and field names, timestamps, and units stay predictable across calls.
Give your agent the weather.
Start with coordinates and the forecast sections you need. The API returns a compact, typed response ready for the next step in the workflow.
curl https://api.weatherkind.com/v1/forecast \
-H "Authorization: Bearer $WEATHERKIND_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"location": { "latitude": 39.19, "longitude": -106.82 },
"units": "us",
"current": { "variables": ["temperature", "condition"] },
"hourly": { "variables": ["temperature", "precipitation_probability"] }
}' Get a free key