# Met Office — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access detailed UK weather forecasts, real-time lightning tracking, and weather warnings from the Met Office. Search locations to retrieve hourly, daily, regional, and long-range predictions, and monitor storm activity with spot forecasts across any geographic area.

**Category:** Weather | **Website:** [metoffice.gov.uk/](https://metoffice.gov.uk/) | **Docs:** [parse.bot/marketplace/ddb90eb5-8bc1-49b9-b065-8719014d058b/metoffice-gov-uk-api](https://parse.bot/marketplace/ddb90eb5-8bc1-49b9-b065-8719014d058b/metoffice-gov-uk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_daily_forecast

Retrieve the 7-day daily weather forecast and current conditions for a specific location using its geohash from search_location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `geohash` | string | Yes | Location geohash from search_location results (e.g. 'gcpvj0v07'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_daily_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"geohash":"<string>"}'
```

### get_hourly_forecast

Retrieve detailed hourly weather forecast data for a location. Returns weather conditions for each hour of the current day or a specified date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Specific date for forecast in ISO format YYYY-MM-DD. Omitting returns today's hourly forecast. |
| `geohash` | string | Yes | Location geohash from search_location results (e.g. 'gcpvj0v07'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_hourly_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","geohash":"<string>"}'
```

### get_lightning_data

Retrieve real-time lightning strike data including coordinates and timestamps from the Met Office lightning detection network.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_lightning_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_spot_forecast

Retrieve spot forecast data for map layers (temperature, wind, symbols, etc.) within a geographic bounding box. Returns forecast data points for named locations within the area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bbox` | string | No | Bounding box as 'minLon,minLat,maxLon,maxLat' covering the geographic area of interest. |
| `layers` | string | No | Forecast layer to retrieve. Known values: 'symbol', 'temperature', 'wind'. |
| `zoom` | integer | No | Map zoom level (integer, higher values show more detail). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_spot_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bbox":"<string>","layers":"<string>","zoom":"<integer>"}'
```

### get_uk_long_range_forecast

Retrieve the UK-wide national long-range weather forecast narrative covering the outlook for the next several weeks.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_uk_long_range_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_uk_regional_forecast

Retrieve text-based weather forecasts for a specific UK region. Returns detailed narrative forecasts including current conditions, short-term outlook, and long-range predictions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | Yes | UK region code. Accepted values: 'se' (South East England), 'nw' (North West England), 'ne' (North East England), 'sw' (South West England), 'wm' (West Midlands), 'em' (East Midlands), 'ee' (East of England), 'yh' (Yorkshire and Humber), 'wl' (Wales), 'ni' (Northern Ireland), 'os' (Orkney and Shetland), 'he' (Highland and Eilean Siar), 'ta' (Central, Tayside and Fife), 'gr' (Grampian), 'st' (Strathclyde), 'dg' (Dumfries, Galloway, Lothian and Borders). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_uk_regional_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### get_uk_storm_centre

Retrieve information about named storms, the current storm season, and storm naming conventions from the Met Office UK Storm Centre.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_uk_storm_centre \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_uk_weather_warnings

Retrieve all active UK weather warnings issued by the Met Office. Returns an empty list when no warnings are currently active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/get_uk_weather_warnings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_location

Search for UK locations by name to retrieve their unique geohash codes, which are required for forecast endpoints. Returns up to 10 matching locations with their geohash, coordinates, area, and type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location name to search for (e.g. 'London', 'Manchester', 'Edinburgh'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metoffice-gov-uk-api-ddb90eb5/search_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```