UK Job Postings Changelog

March 24th, 2025

All notable changes to this project will be documented in this file.

If you have questions, please contact us by emailing our engineering team at [email protected].

July 2025

2.52.0 (July 16)

Added

Added pipelineVersion to meta response.

2.51.0 (July 3)

Added

Added support for interval field on timeseries requests.

May 2025

2.50.0 (May 8)

Refactored

Made internal changes.

Switched all salary fields to used trimmed prefix.

April 2025

2.49.0 (April 11)

Changed

Default lot_version changed to 7.

January 2025

2.48.0 (January 27)

Added

Added support for LOT version 7.
Added support for the following query parameter:
- lot_version

September 2024

2.47.1 (September 25)

Fixed

Fixed an issue causing the /postings endpoint's score field to always be 0.0.

2.47.0 (September 10)

Added

Exposed new posting field:
- active_sources_info
Exposed new facets and filters:
- active_sources_info
- active_sources_info.type
- active_sources_info.source
- active_sources_info.url

August 2024

2.46.0 (August 29)

Added

Added the ability to perform distributions on rankings using the new rankings/{rankingFacet}/distributions/{distributionFacet} endpoint.

2.45.0 (August 2)

Added

Added support for new taxonomy versioning via the following query parameter:
- new_taxonomy_versions

May 2024

2.44.1 (May 8)

Refactored

Improved precision of median salary calculations when there are few observations.

April 2024

2.44.0 (April 12)

Removed

Removed support for the following taxonomy:
- uk_soc2010emsi

March 2024

2.43.1 (March 14)

Refactored

Internal API refactoring.
Improved percentile distribution performance.

January 2024

2.43.0 (January 16)

Changed

Changed the default SOC version from uk_soc2010emsi to uk_soc_2020.

December 2023

2.42.0 (December 20)

Added

Rankings can now be performed on all facets.

November 2023

2.41.1 (November 20)

Fixed

Fixed null metric responses for city and company_is_staffing.

2.41.0 (November 17)

Added

New metric: average_salary

Refactored

Updated back-end infrastructure.

October 2023

2.40.1 (October 11)

Refactored

Updated internal functionality.

Removed GENERATED_ID_FACET_MAPPING functionality.

September 2023

2.40.0 (September 28)

Added

Added support for the following taxonomy version:
- uk_soc_2020

2.39.1 (September 7)

Refactored

Refactored some internal functionality.

July 2023

2.39.0 (July 24)

Changed

Removed the following fields from the API:
- career_area
- career_area_name
- occupation_group
- occupation_group_name
- occupation
- occupation_name
- specialized_occupation
- specialized_occupation_name
- is_remote
Removed the got_version query parameter with it's respective metadata.

June 2023

2.38.0 (June 5)

Added

Added support for the following field in the /postings endpoint:
- active_urls

March 2023

2.37.2 (March 23)

Refactored

Updated back-end infrastructure.

February 2023

2.37.1 (February 3)

Fixed

Fixed a bug causing certain nested rankings to come back empty.

2.37.0 (February 1)

Deprecated

The following filters and facets have been deprecated:
- career_area
- career_area_name
- occupation_group
- occupation_group_name
- occupation
- occupation_name
- specialized_occupation
- specialized_occupation_name

January 2023

2.36.0 (January 18)

Added

filter now supports both list and object types.

2.35.1 (January 6)

Fixed

Fixed keyword highlighting in postings.
Fixed a bug causing postings to get clipped occasionally.

November 2022

2.35.0 (November 7)

Added

Added support for the following filters and facets:
- ttwa
- ttwa_name
- uk_sic_1
- uk_sic_1_name
- uk_sic_2
- uk_sic_2_name
- uk_sic_3
- uk_sic_3_name
- uk_sic_4
- uk_sic_4_name
- uk_sic_5
- uk_sic_5_name
Added support for the following taxonomy:
- ttwa
- uk_sic

2.34.0 (November 4)

Added

Added support for the following filters and facets:
- lot_career_area
- lot_career_area_name
- lot_occupation_group
- lot_occupation_group_name
- lot_occupation
- lot_occupation_name
- lot_specialized_occupation
- lot_specialized_occupation_name
Added support for the following taxonomies:
- lot_career_area
- lot_occupation_group
- lot_occupation
- lot_specialized_occupation

October 2022

2.34.0 (October 31)

Removed

Removed uk_area_2013_1 definition.

2.33.4 (October 17)

Refactored

Updated internal metadata logic to maintain current functionality.

2.33.3 (October 14)

Fixed

Title search with autocomplete=false now respects both name and singular_name fields when matching search terms.

2.33.2 (October 14)

Refactored

Improved back-end resource consumption of large nested rankings requests.

2.33.1 (October 6)

Refactored

Updated references to internal datasets.

August 2022

2.33.0 (August 18)

Removed

Removed support for the following facets:
- hard_skills
- soft_skills
- hard_skills_name
- soft_skills_name

2.32.1 (August 9)

Added

Exposed duration fields and metrics in /meta.

2.32.0 (August 4)

Added

Added support for the following filters and facets:
- min_edulevels
- min_edulevels_name
- max_edulevels
- max_edulevels_name
- edulevels_name
- edulevels

2.31.0 (July 29)

Removed

Removed support for the following company taxonomy version:
- company

2.30.0 (July 22)

Added

Added support for the following GOT taxonomy versions:
- v3
- v6

2.29.0 (July 21)

Added

Added support for the following filters and facets:
- remote_type
- remote_type_name
Added support for the following taxonomy:
- remote_type

Deprecated

The following filter has been deprecated:
- is_remote

2.28.0 (July 20)

Added

Added new distributions endpoint with support for the following facets:
- salary
- posting_duration
- min_years_experience
- max_years_experience

2.27.3 (July 13)

Refactor

updating hard and soft skills in preparation for removal

June 2022

2.27.2 (June 7)

Fixed

Fixed a tagging issue with our career_area definition.

May 2022

2.27.1 (May 31)

Changed

Improved coverage of metadata fields.

2.27.0 (May 19)

Changed

Improved performance of ranking endpoints.

2.26.0 (May 16)

Added

Added support for the following filters:
- is_apprenticeship
- is_voluntary

2.25.0 (May 6)

Added

Added support for the following filters and facets:
- specialized_occupation
- specialized_occupation_name
- occupation
- occupation_name
- occupation_group
- occupation_group_name
- career_area
- career_area_name
Added support for the following taxonomies:
- specialized_occupation
- occupation
- occupation_group
- career_area

April 2022

2.24.0 (April 21)

Added

Added is_software property to skills taxonomy.
Added support for the following facets:
- software_skills
- software_skills_name

2.23.0 (April 12)

Added

Added support for the following filters:
- min_salary
- max_salary

2.22.2 (April 12)

Fixed

Fixed an issue preventing unique_companies metric from working as expected.

2.22.1 (April 1)

Removed

Support for internal dataset.

March 2022

2.22.0 (March 24)

Added

Added support for the following filters and facets:
- skill_categories
- skill_categories_name
- skill_subcategories
- skill_subcategories_name
Added support for the following taxonomy:
- skill_categories
- skill_subcategories

February 2022

2.21.2 (February 8)

Refactored

Improved support for alternative taxonomies datasets.

January 2022

2.21.1 (January 28)

Refactored

Improved support for alternative posting datasets.

2.21.0 (January 18)

Deprecated

The following facets have been deprecated:
- hard_skills
- hard_skills_name
- soft_skills
- soft_skills_name

Added

The following facets have been added:
- specialized_skills
- specialized_skills_name
- common_skills
- common_skills_name

December 2021

2.20.1 (December 6)

Refactored

Improved accuracy of ranking metrics when ranking on high cardinality facets.

2.20.0 (December 1)

Added

Support for burning glass jpa feed.

November 2021

2.19.0 (November 17)

Changed

Default company version changed to emsi_company.

2.18.3 (November 16)

Removed

Removed noisy API logs.

2.18.2 (November 3)

Fixed

Fixed a bug causing data discrepancies when filtering by company_is_staffing using the emsi_company company version.

October 2021

2.18.1 (October 22)

Changed

Company taxonomy version in /meta now specifies version number for Emsi company.

July 2021

2.18.0 (July 23)

Added

Dual tagging for company.
New query parameter: company_version

2.17.0 (July 21)

Removed

The deprecated /samples endpoint from the API.

2.16.7 (July 6)

Fixed

Issue causing 500 in certain timeseries requests.

June 2021

2.16.6 (June 4)

Fixed

Fixed a bug causing ranking time-series requests to return an error in rare situations.

March 2021

2.16.5 (March 29)

Fixed

Fixed a bug causing posted and expired /timeseries and /ranking/{rankingFacet}/timeseries requests to omit data from the last date bucket in their time-frame.

2.16.4 (March 26)

Changed

Utilized new features in timeseries query construction to improve performance

2.16.3 (March 25)

Changed

Improved internal timeseries query.

February 2021

2.16.2 (February 26)

Changed

Updated meta soc taxonomy version to be uk_soc2010emsi.

2.16.1 (February 26)

Changed

Default title version changed to emsi.

Removed

Title version carotene.

2.16.0 (February 12)

Added

Dual tagging for titles.
New query parameter: title_version
New meta taxonomy version: title_version

December 2020

2.15.2 (December 17)

Fixed

Fixed an issue causing the posting_duration filter to match active postings outside the specified range.

2.15.1 (December 11)

Added

Support for analytics on Emsi posting data.

November 2020

2.15.0 (November 24)

Added

Added city taxonomy.

2.14.1 (November 23)

Fixed

Fixed an issue where pages_available in /postings response showed more than actually viewable.

2.14.0 (November 11)

Deprecated

The /samples endpoint has been deprecated in favor of the /postings endpoint

Added

Added page parameter to /postings request for pagination functionality.
Added the following params to /postings responses:
- page - requested page number.
- pages_available - number of available pages.
- viewable_postings - number of matched postings available to view.
- limit - requested postings limit.

2.13.2 (November 12)

Fixed

Fixed an issue when formatting job postings for /samples and /postings responses that caused HTML tags to become malformed in particular scenarios.

October 2020

2.13.1 (October 7)

Fixed

Fixed a bug preventing the /samples and /postings endpoints from accepting large filter lists.

September 2020

2.13.0 (September 17)

Added

Added a /postings/{postingId} endpoint for looking up a posting by id.

2.12.0 (September 4)

Added

Added an optional fields parameter to /postings requests, allowing clients to specify which fields are returned for each posting.

August 2020

2.11.0 (August 26)

Added

Added an experimental /postings endpoint.
/postings endpoint response now returns an id for each posting.

2.10.0 (August 25)

Added

Added an is_internship request filter.

2.9.0 (August 21)

Added

The /samples endpoint request now supports an order param which defines how postings are sorted.
The /samples endpoint response now returns a score field, which indicates how relevant a posting is to the requested filter.

July 2020

2.8.4 (July 2)

Fixed

Fixed a bug that duplicates results when duplicate metrics are passed in.

April 2020

2.8.3 (April 30)

Added

Support for restricting access to active sample postings via postings:only_expired_samples claim.

2.8.2 (April 28)

Changed

Increased taxonomy list and search results limit maximum to 10000.

2.8.1 (April 15)

Refactored

Refactored calculation of the total_postings metric.

2.8.0 (April 15)

Added

New filter: sources

Fixed

Removed requirement of the soc2 properties when searching for titles.

2.7.3 (April 7)

Added

City taxonomy endpoints now return a location property.

2.7.2 (April 2)

Changed

Improved non-autocomplete taxonomy searches.
Increased taxonomy search limit from 100 to 1000.

March 2020

2.7.1 (March 27)

Changed

The deafult area version is now based on 2015 areas.
- 2013.1 areas may still be access through the area_version query parameter.

2.7.0 (March 23)

Added

Support for include and exclude fields has been added to the rank filter.

2.6.0 (March 4)

Added

Dual tagging for UK areas.
New query parameter: area_version
New meta taxonomy version: area_version

2.5.1 (March 2)

Fixed

Issue causing 500 in certain timeseries requests

February 2020

2.5.0 (February 4)

Added

New filter: salary
New metrics: median_salary, min_salary and max_salary

January 2020

2.4.1 (January 31)

Added

Incorporated new authorization functionality.

2.4.0 (January 20)

Removed

The deprecated skills_op filter.

December 2019

2.3.2 (December 4)

Fixed

Fixed a bug that would cause ranking timeseries requests to trigger an internal server error when filter.when is active and timeseries.when is a timeframe.

November 2019

2.3.1 (November 26)

Added

New filter: is_remote

2.3.0 (November 18)

Added

Added support for the following facets:
- min_years_experience
- max_years_experience

2.2.2 (November 18)

Changed

Improved keyword expression validation performance.

2.2.1 (November 8)

Changed

Improved status check.

2.2.0 (November 7)

Changed

/meta response now shows nested filters.

2.1.0 (November 1)

Changed

More restrictive access to job posting samples.

October 2019

2.0.0 (October 30)

Added

Added skills and skills_name fields to sample postings.
Added support for the following facets:
- city
- employment_type
- employment_type_name
- lau1_name
- nuts1_name
- nuts3_name
- skill_cluster
- soc1_name
- soc2_name
- soc3_name
- soc4_name
- sources
Added support for the following filters:
- city
- employment_type
- employment_type_name
- lau1_name
- max_years_experience
- min_years_experience
- nuts1_name
- nuts3_name
- posting_duration
- skill_cluster
- soc1_name
- soc2_name
- soc3_name
- soc4_name
Added support for the following metrics:
- duplicate_postings
- total_postings
- posting_intensity
The /meta endpoint now lists latest_day, this is the latest available day of posting data, useful when filtering postings by a day range with the when filter.
The when filter now supports filtering by a day range in addition to a month range. Day range queries allow you to view the current month's job postings that haven't yet been made available when filtering by month.

Note: When using the timeseries or rankings/timeseries endpoints the maximum day range is 90 days.

Example
```
{
    "filter": {
        "when": {
            "start": "2019-03-01",
            "end": "2019-03-20"
        }
    }
}
```
Added an advanced filter object for more expressive syntax.
- include field specifies items to be included in the filter.
- exclude field specifies items to be excluded from the filter.
- include_op field allowing for matching any (or) or all (and) of the specified items in the include filter (Defaults to or if unspecified).
- exclude_op field allowing for matching any (or) or all (and) of the specified items in the exclude filter (Defaults to or if unspecified).
Example Request

Look for job postings in the first half of 2018 that included both Accounting and Automation skills but not Management skills.
```
{
  "filter": {
      "when": {"start": "2018-01", "end": "2018-06"},
      "skills_name": {
          "include": ["Accounting", "Automation"],
          "exclude": ["Management"],
          "include_op": "and"
      }
  }
}
```

Changed

Database stability improvements.
Updated underlying data structure.
Both the source_broad and source_specific filters and facets have been removed.

Deprecated

The skills_op filter. It has been replaced by the more flexible filter options detailed in the Added section.

Removed

Removed data_version from meta.
Removed median_posting_duration from /rankings/timeseries and /timeseries due to performance cost.

July 2019

1.2.0 (July 23)

Changed

Increased ranking time-series limits for skills and cetificaitons facets from 100 to 1000. There is still a limit of 100 skills and certifications if asking for the unique_companies metric.

1.1.0 (July 11)

Added

The /taxonomies and /rankings endpoints now return a list of all the available facets for each endpoint.

June 2019

1.0.4 (June 27)

Fixed

Fixed an error caused by passing non-numeric limits to the taxonomy endpoints.

March 2019

1.0.3 (March 20)

Changed

Upgraded proxy web server.

1.0.2 (March 19)

Changed

Improved precision of rankings when requesting low limits.

1.0.1 (March 4)

Changed

Minor performance improvements.

January 2019

1.0.0 (January 11)

Changed

The skills taxonomy's search scoring process has been updated to incorporate search term relevance and approximate matches. This will allow more relevant search terms to appear at the top of search results. As a result, search score values and the order of search results will be different from the former search process.