----:--LOCAL TIME
DEVELOPERS / DATA ACCESS

The Imber API.

Access the same UK forecast data that powers our website. Our read-only JSON API provides searchable locations, forecast values, units and model provenance in a straightforward format.

Currently available as a developing public service. No API key is required for the endpoints below. Availability, response formats and access limits may change while we improve the platform.

UKVMet Office forecast model
≈2 kmUnderlying model grid
Up to 120 hForecast horizon
JSONRead-only responses
GETTING STARTED

Simple endpoints, clear responses.

Use GET requests over HTTPS. The WordPress endpoints below power our website and are suitable for browser-based requests to this domain. The direct forecast service is also available at api.imberweather.com.

GET

Find a forecast location

Search the published settlement catalogue. Results include names and geographical coordinates. An empty search lists available forecast locations.

https://imberweather.com/wp-json/imber/v1/locations?search=Cardiff
Try location search ↗
GET

Forecast for a named town

Returns future forecast times and available weather variables for a cached location, together with its actual coordinates, source, model and run timestamp.

https://imberweather.com/wp-json/imber/v1/forecast?place=Cardiff
Try Cardiff forecast ↗
GET

Nearest cached forecast

Provide decimal latitude and longitude. IMBER selects the nearest cached town where one is within 35 km. The response identifies the forecast location and distance: it is not an exact-location interpolation.

https://imberweather.com/wp-json/imber/v1/forecast?lat=51.45&lon=-3.31
Try nearest forecast ↗
DATA FORMAT

How the forecasts work.

IMBER processes Met Office UKV numerical weather prediction data into a compact catalogue of forecast values for selected UK towns. Source NetCDF grids are sampled at the nearest model cell for each catalogue location, converted into readable units and cached as a JSON dataset. Our server refreshes the dataset when new model runs become available.

Model & coverage

Our current source is the deterministic UKV model, at approximately 2 km grid spacing. Forecast values are model predictions, not live observations; geographic detail and forecast accuracy are not the same thing.

Times & updates

Forecasts are provided at three-hourly intervals, for up to five days. Timestamps use UTC in ISO 8601 format. Data availability can vary by variable and run, and publication may lag the model run.

Variables & units

Available fields include temperature and dew point (°C), humidity and cloud cover (%), wind and gust (mph), direction (degrees), pressure (hPa), precipitation rate (mm/h), visibility (km) and solar radiation (W/m²). Missing fields should not be treated as zero.

Location matching

Our cache currently covers approximately 1,500 named locations. A coordinate request can be matched to a nearby cached town, not necessarily the requested point. Mountainous, coastal and rural areas may differ meaningfully from the town forecast.

Response structure

Illustrative structure, not live values
{
  "forecast_location": "Cardiff",
  "model": "ukv",
  "run_time": "ISO-8601 UTC timestamp",
  "forecasts": [
    {
      "time": "ISO-8601 UTC timestamp",
      "variables": {
        "temperature": { "value": 0, "unit": "°C" }
      }
    }
  ]
}

Values in this example are placeholders to demonstrate the response format. Live requests return real model values. The schema may be extended as we add models and parameters.

LICENSING & ATTRIBUTION

Where the data comes from.

IMBER combines an independently developed presentation and processing pipeline with third-party data. Those underlying data rights do not automatically become unrestricted because they are available through this API.

Forecast data · Met Office

Our current forecast source is the Met Office UK deterministic 2 km dataset distributed through AWS Open Data. The AWS dataset registry identifies this release as British Crown copyright, Met Office, licensed under Creative Commons Attribution–ShareAlike (CC BY-SA). Reuse may require attribution, a licence link, indication of changes and ShareAlike treatment of adapted material.

Dataset and licensing record ↗

Place names · GeoNames

Some town names and coordinates are drawn from GeoNames, which publishes data under a Creative Commons Attribution licence and permits commercial reuse with credit. The catalogue also retains locations added independently by IMBER.

GeoNames data and terms ↗

Before reusing or redistributing forecast data

Check the current source-specific licence yourself, provide appropriate attribution and assess whether ShareAlike obligations apply to your adapted output. Met Office datasets supplied through other channels may have materially different terms; their licences should not be assumed to apply to this AWS release. IMBER does not grant additional rights over third-party source data.

Suggested source credit: “Forecast data: © Crown copyright, Met Office, via AWS Open Data (CC BY-SA). Place information: GeoNames (CC BY). Processed and presented by IMBER.” Include links to the source and applicable licence, and identify transformations where relevant.

LIMITATIONS & RESPONSIBLE USE

Use forecasts with their limitations in mind.

The Met Office describes this AWS release as a free, unsupported dataset and advises against its use for critical business purposes. IMBER is an independent service, not an official Met Office forecast or warning service. Neither availability nor forecast accuracy is guaranteed.

Do not rely on these forecasts alone for safety-critical decisions, emergency response, regulated aviation, or other activities requiring an operationally supported service. Rainfall rate is not a probability of precipitation; a deterministic model does not provide a calibrated confidence percentage. The API is currently read-only and provided on a best-efforts development basis.

For the source documentation and model publication details, see the Met Office external data channels and the AWS dataset registry.