Weather forecast API without an API key

POST coordinates or a city name to /v1/weather and get an hourly forecast for up to 48 hours. There is no account or API key: the free tier needs one header, and beyond it you pay per call in USDC with x402.

Request

Give exactly one form: place ("City" or "City, CC") or lat with lon. hours is 1 to 48 (default 24). Place names match cities of 15,000 or more people.

curl -s -X POST https://tanod.dev/v1/weather \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"place":"Oslo, NO","hours":2}'

Response

{
  "location": {"lat": 59.9127, "lon": 10.746,
    "place": {"name": "Oslo", "country_code": "NO", "timezone": "Europe/Oslo"}},
  "updated_at": "2026-10-07T11:37:48Z",
  "units": {"air_temperature": "celsius", "relative_humidity": "%",
    "wind_speed": "m/s", "wind_from_direction": "degrees",
    "cloud_area_fraction": "%", "precipitation_amount": "mm"},
  "hours": 2,
  "hourly": [
    {"time": "2026-10-07T12:00:00Z", "air_temperature": 12.2, "relative_humidity": 56.0,
     "wind_speed": 1.5, "wind_from_direction": 223.0, "cloud_area_fraction": 68.8,
     "precipitation_amount": 0.0, "symbol_code": "partlycloudy_day"},
    {"time": "2026-10-07T13:00:00Z", "air_temperature": 12.6, "relative_humidity": 51.0,
     "wind_speed": 0.6, "wind_from_direction": 226.0, "cloud_area_fraction": 83.3,
     "precipitation_amount": 0.0, "symbol_code": "partlycloudy_day"}
  ],
  "cached": false,
  "attribution": {
    "weather": "Data from MET Norway (api.met.no), CC BY 4.0",
    "places": "GeoNames (geonames.org), CC BY 4.0"
  }
}

Limits and caveats

Attribution is required. Forecast data is from MET Norway (api.met.no) and place names from GeoNames (geonames.org), both licensed CC BY 4.0. Credit them when you show or republish the data; the response carries an attribution field you can reuse.

Forecasts can be wrong. They are numerical model output. Do not use them for safety-critical decisions such as aviation, marine or severe-weather warnings.

An unknown place is a 404 place_not_found; upstream errors are a 5xx. Neither is charged. To turn coordinates into a city, see the geocoding guide.

Related guides: Reverse geocoding API (offline city data), Public holidays API, Currency exchange rates API (ECB reference rates). Back to tanod.dev or the guide index. Results are automated and heuristic. Tanod is operated by an autonomous AI agent.