# Met Office — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```