Overview

Introduction

The Career Coach UK Jobs API is a RESTful service providing aggregated data from millions of job postings across online sources. It delivers insights into recent job availability, hiring companies, and in-demand skills across the UK. All endpoints follow a JSON:API-like format, with a top-level data object containing objects or arrays with type, id, and attributes.

The Career Coach UK Jobs API is closely related to the UK Careers API, which focuses on longer-term occupational data (LMI, projections, demographics). While careers represent long-term occupations (e.g., Web Developer, SOC 2137), jobs represent specific positions at a time and place (e.g., Web Developer role at Lightcast in Basingstoke). Using the Jobs API together with the Careers API provides a full picture: long-term occupational context alongside current job demand.

Support: Please contact your Lightcast / Career Coach account manager for technical or customer support regarding API use.

Data Overview

The API features three main datasets:

1. Timeseries of Job Postings – Number of unique job postings per month, total unique postings, and total companies posting, filtered by region, career (SOC code), and time period.
2. Companies Posting Jobs – List of companies posting jobs for a specified region, career, and time period.
3. Skills Data – List of hard and soft skills associated with a given career, with the number of unique postings requiring each skill, filtered by region, career, and time period.

All queries require specifying an Standard Occupational Classification (SOC), geographic region(s), and a date range.

Resource Structure

The main collections in this API have routes prefixed by /jobs. Additionally, there is a separate skill search endpoint: /skill-search.

The API provides access to the following collections:

• Timeseries
• Companies
• Skills
• Skill Search

The structure for each collection is:

/jobs/uk/{geographyLevel}/{geographyID}/{careerCode}/{collection}

Available geography levels:

• nation
• country
• lau1
• nuts1
• nuts3

Example:

/jobs/uk/nuts3/ukj37/2137/timeseries

Breakdown:

• /uk/nuts3/ukj37 – North Hampshire NUTS region code
• /2137 – SOC code for certified accountants
• /timeseries – Monthly job postings collection (default past 6 months if unspecified)

API Endpoint

There are multiple endpoints within this category. Refer to individual API docs under the Career Coach UK Jobs section.

Request Headers

(*) Indicates the action to be required

All requests must include the following headers:

Authentication

All endpoints in this category require an OAuth 2.0 Bearer Token for authentication. Tokens are granted through Lightcast’s Authentication API and are valid for 1 hour.

To access the Career Coach UK Jobs API, the token must include the following scope:

• jobs (for expanded access)

Sample Request

curl --request POST \
  --url https://auth.emsicloud.com/connect/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=CLIENT_ID \
  --data client_secret=CLIENT_SECRET \
  --data grant_type=client_credentials \
  --data scope=jobs

Request Parameters

Sample Response

{
  "access_token": "<ACCESS_TOKEN>",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Note that the Tokens expire after 3600 seconds. To maintain uninterrupted access, refresh the token before it expires. To know more about this, refer to the Authentication guide.

Response Parameters

curl --request GET \
--url 'https://cc.emsiservices.com/jobs/uk/nuts1/UKi/2137/skills?limit=10&start=2017-10&end=2018-10'\
--header 'Authorization: Bearer <ACCESS_TOKEN>'

{
  "data": {
    "attributes": {
      "date-range": {
        "start": "2017-10",
        "end": "2018-10",
        "months": 12,
        "context": "a year"
      },
      "skills": [
        { "name": "JavaScript (Programming Language)", "unique-postings": 18735 },
        { "name": "Cascading Style Sheets (CSS)", "unique-postings": 15468 },
        { "name": "Front End (Software Engineering)", "unique-postings": 12891 },
        { "name": "HyperText Markup Language (HTML)", "unique-postings": 11205 },
        { "name": "Agile Software Development", "unique-postings": 7751 },
        { "name": "HTML5", "unique-postings": 6997 },
        { "name": "Front End (Automobile)", "unique-postings": 5620 },
        { "name": "PHP (Scripting Language)", "unique-postings": 5379 },
        { "name": "User Interface", "unique-postings": 5257 },
        { "name": "Testing", "unique-postings": 5256 }
      ],
      "total-unique-postings": 40856,
      "soc-id": "2137"
    },
    "id": "2137",
    "type": "skills"
  }
}

Status Code Summary

Versioning

The Career Coach UK Jobs API is currently at version 1.0. New data updates, fields, and minor hotfixes may be added at any time and are not considered breaking changes.

Data is typically refreshed once per quarter, as new economic information becomes available. Clients will be notified when new data or features are released.

In the rare event that a version is deprecated, clients will receive at least 90 days’ notice to update their queries to the new format.