Global Job Postings Changelog

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

1.63.0 (July 2)

Added

• Added support for interval field on timeseries requests.

June 2025

1.62.0 (June 18)

Added

• Added support for the following filters and facets:
  • naics2_name
  • naics2
  • naics3_name
  • naics3
  • naics4_name
  • naics4
  • naics5_name
  • naics5
  • naics6_name
  • naics6

1.61.0 (June 12)

Added

• Added support for the following field:
  • company_raw

1.60.0 (June 6)

Changed

• Removed requirement to filter by nation on /rankings/<rankingFacet>/distributions/<distributionFacet>.

May 2025

1.59.0 (May 12)

Added

• Added new endpoint /rankings/<rankingFacet>/distributions/<distributionFacet>.

1.58.0 (May 5)

Refactored

• Made internal changes.

April 2025

1.57.0 (April 29)

Added

• Added support for the following area taxonomy versions:

  • lf_area_2023_2
  • lf_area_2025_1 (default)

• Added support for the following area taxonomy versions (available via new_taxonomy_versions query parameter):

  • 1
  • 2 (default)

• Added support for versioning on area taxonomy via the following query parameters:

  • area_version
  • area_laa_version

1.56.0 (April 11)

Changed

• Default lot_version changed to 7.

March 2025

1.55.0 (March 21)

Added

• Added support for the following fields in the /postings endpoint:
  • isced_min
  • isced_min_name
  • isced_max
  • isced_max_name

1.54.0 (March 19)

Added

• Added support for the following fields in the /postings endpoint:
  • nation
  • nation_name
  • laa_country
  • laa_country_name
  • laa_admin_area_1
  • laa_admin_area_1_name
  • laa_admin_area_2
  • laa_admin_area_2_name
  • laa_metro
  • laa_metro_name

January 2025

1.53.0 (January 27)

Added

• Added support for LOT version 7

• Added support for the following query parameter:

  • lot_version

October 2024

1.52.0 (October 14)

Removed

• Removed support for the version query param and removed it from meta.

1.51.0 (October 10)

Added

• Added new /distributions and /distributions/{facet} endpoints with support for the following facets:
  • salary
  • posting_duration
  • min_years_experience
  • max_years_experience

September 2024

1.50.0 (September 27)

Added

• Added support for the following taxonomies:

  • remote_type_taxonomy

• Added support for the following fields and facets:

  • remote_type
  • remote_type_name

1.49.0 (September 24)

Added

• Added new endpoints, /postings and /postings/{postingId}, to list and search for sample postings.

1.48.0 (September 4)

Added

• Exposed new facets and filters:
  • active_sources_info
  • active_sources_info.type
  • active_sources_info.source
  • active_sources_info.url

August 2024

1.47.0 (August 5)

Added

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

May 2024

1.46.4 (May 14)

Refactored

• Internal API refactoring.

1.46.3 (May 8)

Refactored

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

March 2024

1.46.2 (March 14)

Refactored

• Internal API refactoring.

January 2024

1.24.0 (January 19)

Added

• Exposed all anz_sic and anz_sco facets as filters.

November 2023

1.23.0 (November 16)

Added

• New metric: average_salary

1.22.0 (November 10)

Added

• Added support for the following taxonomies:

  • anz_sco_taxonomy
  • anz_sic_taxonomy

• Added support for the following fields and facets:

  • anz_sco_1
  • anz_sco_1_name
  • anz_sco_2
  • anz_sco_2_name
  • anz_sco_3
  • anz_sco_3_name
  • anz_sco_4
  • anz_sco_4_name
  • anz_sco_5
  • anz_sco_5_name
  • anz_sic_1
  • anz_sic_1_name
  • anz_sic_2
  • anz_sic_2_name
  • anz_sic_3
  • anz_sic_3_name
  • anz_sic_4
  • anz_sic_4_name

October 2023

1.21.0 (Ocotober 6)

Removed

• Removed support for the following metrics, fields, and facets:
  • advertised_salary
  • median_advertised_salary
  • min_advertised_salary
  • max_advertised_salary

July 2023

1.21.0 (July 21)

Added

• Added support for the following filters and facets:
  • isced
  • isced_name
• Added the following taxonomies:
  • isced

1.20.0 (July 18)

Added

• New filter: experience level filtering to refine analysis of employer demand, e.g. 0-3 years (min_years_experience and max_years_experience).

June 2023

1.19.0 (June 14)

Deprecated

• Following fields/metrics have been deprecated:
  • advertised_salary
  • median_advertised_salary
  • min_advertised_salary
  • max_advertised_salary

Added

• Following fields/metrics have been added:
  • salary
  • median_salary
  • min_salary
  • max_salary

1.18.0 (June 13)

Added

• Added support for the following filters and facets:
  • lot_v6_career_area
  • lot_v6_occupation_group
  • lot_v6_occupation
  • lot_v6_specialized_occupation
• Added the following taxonomies:
  • lot_v6_career_area
  • lot_v6_occupation_group
  • lot_v6_occupation
  • lot_v6_specialized_occupation

March 2023

1.17.1 (March 28)

Refactored

• Updated back-end infrastructure.

1.17.0 (March 2)

Added

• Added support for the following filters and facets:
  • skill_categories
  • skill_categories_name
  • skill_subcategories
  • skill_subcategories_name
• Added the following taxonomies:
  • skills_categories
  • skills_subcategories

1.16.1 (March 2)

Refactored

• Changed internal query structure.

February 2023

1.16.0 (February 6)

Added

• Added support for the following filters and facets:
  • isco_1
  • isco_1_name
  • isco_2
  • isco_2_name
  • isco_3
  • isco_3_name
  • isco_4
  • isco_4_name
  • nace_1
  • nace_1_name
  • nace_2
  • nace_2_name
• Added the following taxonomies:
  • isco
  • nace

1.15.1 (February 3)

Fixed

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

January 2023

1.15.0 (January 27)

Added

• Added support for the following filters and facets:
  • laa_admin_area_1
  • laa_admin_area_1_name
  • laa_admin_area_2
  • laa_admin_area_2_name
  • laa_country
  • laa_country_name
  • laa_metro
  • laa_metro_name
• Added the following taxonomies:
  • laa_admin_area_1
  • laa_admin_area_2
  • laa_country
  • laa_metro

1.14.0 (January 24)

Added

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

1.13.0 (January 23)

Added

• Added support for the following metrics:
  • duplicate_postings
  • total_postings
  • posting_intensity

1.12.0 (January 20)

Added

• Request filters now support both object and array<object> types.

October 2022

1.11.1 (October 14)

Refactored

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

August 2022

1.11.0 (August 18)

Removed

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

July 2022

1.10.1 (July 13)

Refactor

• Updating hard and soft skills in preparation for removal

May 2022

1.10.0 (May 19)

Changed

• Improved performance of ranking endpoints.

1.9.0 (May 13)

Added

• New metrics: min_advertised_salary and max_advertised_salary

April 2022

1.8.0 (April 22)

Added

• Support has been added for the following filter:
  • advertised_salary
• Support has been added for the following metric:
  • median_advertised_salary
• Support has been added for the following taxonomy:
  • currency

1.7.1 (April 1)

Fixed

• Fixed an issue preventing specialized_skills and common_skills facets from working as expected.

January 2022

1.7.0 (January 18)

Deprecated

• Following facets have been deprecated:
  • hard_skills
  • hard_skills_name
  • soft_skills
  • soft_skills_name

Added

• Following facets have been added:
  • specialized_skills
  • specialized_skills_name
  • common_skills
  • common_skills_name

December 2021

1.6.3 (December 6)

Refactored

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

November 2021

1.6.2 (November 16)

Removed

• Removed noisy API logs.

October 2021

1.6.1 (October 5)

Changed

• Ranking timeseries responses now have a hard timeout of 3 minutes, up from 1 minute.
• Timeouts caued by long running requests now return with 504 (Gateway Timeout) response instead of a 500 (Internal Server Error).

Fixed

• Fixed an issue causing large requests to negatively impact performance of the API.

April 2021

1.6.0 (April 16)

Added

• Support has been added for the following filter and facet:
  • title
  • title_name
• A taxonomy has been added for the following facet:
  • title

January 2020

1.5.2 (January 21)

Fixed

• Company taxonomy responses now return unique_postings as a response property instead of profiles.

December 2020

1.5.1 (December 17)

Fixed

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

1.5.0 (December 7)

Added

• Added support for the following facets:
  • hard_skills
  • hard_skills_name
  • soft_skills
  • soft_skills_name
  • certifications
  • certifications_name

1.4.0 (December 4)

Changed

• /taxonomies response now has updated available taxonomies.

Added

• /meta response now includes nation_start_month.
• company taxonomy.
• market taxonomy.
• nation taxonomy.
• occupation taxonomy.
• skills taxonomy.

October 2020

1.3.0 (October 23)

Added

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

July 2020

1.2.4 (July 2)

Fixed

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

April 2020

1.2.3 (April 28)

Changed

• Increased taxonomy list and search results limit maximum to 10000.

December 2019

1.2.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

1.2.1 (November 8)

Changed

• Improved status check.

1.2.0 (November 7)

Changed

• /meta response now shows nested filters.

September 2019

1.1.0 (September 5)

Added

• Added a version field to meta to show the data version that's being used.

Fixed

• Version query parameter now properly maps to internal data versions.

August 2019

1.0.0 (August 26)

Added

• Start a changelog to document updates to the API.