# Nomis UK Labour Market Statistics API

> UK official labour market statistics from Nomis (ONS): claimant count, employment, census and more

- Vendor: `nomisuklabourmarketstatisticsa` · version 1.0 · category Government Data · tags uk statistics api, ons api, labour market api, unemployment api, claimant count api, uk census api, nomis api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/nomisuklabourmarketstatisticsa
- This document: https://apiclay.com/docs/nomisuklabourmarketstatisticsa.md
- OpenAPI 3.1: https://apiclay.com/api/nomisuklabourmarketstatisticsa/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `nomisuklabourmarketstatisticsa`
- Updated: 2026-11-18

## About

## Nomis UK Labour Market Statistics API

Official UK labour market and census statistics from Nomis, run by Durham University for the Office for National Statistics: find datasets (claimant count, Annual Population Survey, earnings, jobs, Census 2021 tables) and pull their figures for any geography and date.

Data comes from **nomisweb.co.uk** (https://www.nomisweb.co.uk). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/datasets?search=*claimant*` to find a dataset id such as `NM_1_1`, then `/data?dataset=NM_1_1&amp;geography=2092957697&amp;date=latest&amp;sex=7&amp;item=1&amp;measures=20100`.

### Routes

#### GET `/datasets` - Find datasets
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | yes | Words with `*` wildcards, e.g. `*claimant*`. |

Returns: `structure.keyfamilies.keyfamily[]` with `id` (e.g. `NM_1_1`), `name.value`, dimensions and status.

#### GET `/data` - Dataset data
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| dataset | path | string | yes | Dataset id from `/datasets`, e.g. `NM_1_1`. |
| geography | query | string | no | Geography code(s), e.g. `2092957697` (UK). |
| date | query | string | no | `latest`, `prevyear`, or dates like `2026-09`. |
| sex | query | string | no | Dimension value, e.g. `7` (total) in NM_1_1. |
| item | query | string | no | Dimension value, e.g. `1` in NM_1_1. |
| measures | query | string | no | e.g. `20100` (value). |
| select | query | string | no | Comma-separated columns to return. |

Returns: `header` and `obs[]` with `dataset`, `geography`, `time`, `obs_value.value` and each dimension.

### Caveats

- Dimension names and codes differ per dataset; read them from `/datasets` first. Data is ONS Crown Copyright under the Open Government Licence.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by nomisweb.co.uk.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /datasets — Find datasets
- Gateway: `GET https://api.apiclay.com/v1/api/nomisuklabourmarketstatisticsa/datasets`
- Public query params: `search` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /data — Dataset data
- Gateway: `GET https://api.apiclay.com/v1/api/nomisuklabourmarketstatisticsa/data`
- Public query params: `geography` (string), `date` (string), `sex` (string), `item` (string), `measures` (string), `select` (string), `dataset` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/nomisuklabourmarketstatisticsa/datasets?search=<search>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
