Build on the same data

Every figure on jobfacts comes from a free JSON API. Pay, employment, demand, job adverts, apprenticeships and the routes in, for all 412 UK occupations, each with its source, its release and how reliable it is.

Occupations412every SOC 2020 unit group

Endpoints28JSON over HTTPS

Official sources16checked for new releases daily

PriceFreewith attribution

Get a key

Keys will be free. Sign-up opens when the public API goes live. Send your key in the X-API-Key header on every request.

The /v1/meta endpoints need no key, so you can see what the API covers first. The free tier allows 60 requests a minute.

Base address: published at launch

First requests

Everything is keyed on a four-digit SOC 2020 code. Start from a job title, then ask about the occupation it finds.

Find the occupation for a job title
```
curl -H "X-API-Key: $LMI_KEY" "$LMI_API/v1/occupations/search?q=plumber&limit=3"
```
The top match is 5315, plumbers and heating and ventilating installers and repairers.
Ask what it pays
```
curl -H "X-API-Key: $LMI_KEY" "$LMI_API/v1/occupations/5315/pay?pattern=fulltime"
```
Use the median. A withheld figure is null, never zero, and presentable says whether a figure is reliable enough to show.
Ask anything else about it
```
curl -H "X-API-Key: $LMI_KEY" "$LMI_API/v1/occupations/5315/job-adverts"
```
The same code works with every occupation endpoint: see them all.

Read the getting started guide for the full walk-through, with example responses.

Guides

01Getting startedA key, a first request, and the calls most integrations need.02Reading the figuresQuality bands, withheld values and provisional figures. Read before you show anything.03Occupations and areasSOC 2020 codes, job-title search, and which areas each kind of data covers.04What is and isn't availableThe datasets behind the API, how current they are, and the gaps.05AttributionWhat you must display. Required by the licences.06Errors, limits and freshnessError format, rate limits, caching and release timing.

Endpoints

OpenAPI document

Every endpoint, parameter and field is described in the API reference.

Find an occupation

GET/v1/occupationsList occupations
GET/v1/occupations/{soc}Get an occupation
GET/v1/occupations/searchFind occupations matching a job title
GET/v1/occupations/{soc}/titlesGet every job title classified to an occupation

Pay

GET/v1/occupations/{soc}/payGet pay for an occupation
GET/v1/occupations/{soc}/pay/seriesGet pay for an occupation over time
GET/v1/occupations/{soc}/pay/regionsCompare pay for an occupation across regions

People and demand

GET/v1/occupations/{soc}/visasGet sponsored work visas for an occupation
GET/v1/occupations/{soc}/demandGet whether an occupation is in demand
GET/v1/occupations/{soc}/vacanciesGet skill shortages for an occupation
GET/v1/occupations/{soc}/workforceGet who works in an occupation
GET/v1/occupations/{soc}/employmentGet employment for an occupation
GET/v1/occupations/{soc}/projectionsGet the employment outlook for an occupation

Job adverts

GET/v1/occupations/{soc}/job-advertsGet new online job adverts for an occupation
GET/v1/occupations/{soc}/job-adverts/localGet where an occupation's jobs are advertised
GET/v1/occupations/{soc}/job-adverts/local/{area}Get an occupation's job adverts in a local area

Routes in and the work

GET/v1/occupations/{soc}/skillsGet the skills an occupation involves
GET/v1/occupations/{soc}/work-profileGet the interests and abilities an occupation suits
GET/v1/occupations/{soc}/how-to-becomeGet how to become one
GET/v1/occupations/{soc}/apprenticeshipsGet apprenticeships and technical qualifications into an occupation

Lists across occupations

GET/v1/visasList occupations by sponsored work visas granted
GET/v1/demandList occupations by demand level
GET/v1/job-advertsList occupations by new online job adverts

Local areas

GET/v1/local-areasList local areas
GET/v1/local-areas/{area}/job-advertsGet the occupations with most job adverts in a local area

Metadata

GET/v1/meta/ingestCheck data freshness
GET/v1/meta/sourcesList data sources
GET/v1/meta/editionsList releases