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

---

June 2025

2.86.0 (June 19)

Removed

• Removed support for the following fields:
  • msa_skill_cluster
  • national_skill_cluster
  • state_skill_cluster

2.85.0 (June 9)

Added

• Added support for the following filters and facets:
  • is_fortune100
  • is_fortune500
  • is_fortune1000
  • revenue_bucket
  • employee_count_range

2.84.0 (June 5)

Added

• Added support for the following fields and facets:
  • job_seniority
  • job_seniority_name

May 2025

2.83.0 (May 8)

Refactored

• Made internal changes.

April 2025

2.82.0 (April 11)

Changed

• Default lot_version changed to 7.

2.81.0 (April 2)

Fixed

• Corrected the area version number from 1.0.3 to 2.0.0. 1.0.3 can still be used as an alias for version 2.0.0.

Changed

• Default area_us_version changed to 2.0.0.

March 2025

2.80.0 (March 17)

Changed

• Default area_version changed to us_area_2024_4.
• Default area_us_version changed to 1.0.3.

February 2025

2.79.0 (February 3)

Added

• Added support for the following taxonomy:

  • contract_type

• Added support for the following fields and facets:

  • contract_type
  • contract_type_name

January 2025

2.78.0 (January 27)

Added

• Added support for LOT version 7.

• Added support for the following query parameter:

  • lot_version

October 2024

2.77.0 (October 11)

Added

• Added support for taxonomy versioning via the following query parameters:
  • area_version
  • area_us_version

2.76.2 (October 4)

Fixed

• Fixed a bug with the new_taxonomy_versions query parameter.

September 2024

2.76.1 (September 25)

Fixed

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

August 2024

2.76.0 (August 2)

Added

• Added support for new taxonomy versioning via the following query parameters:
  • new_taxonomy_versions
  • soc_lightcast_version
  • onet_standard_version

May 2024

2.75.1 (May 8)

Refactored

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

March 2024

2.75.0 (March 27)

Added

• Exposed new postings field:

  • active_sources_info

• Exposed new filters:

  • active_sources_info
  • active_sources_info.type
  • active_sources_info.source
  • active_sources_info.url

February 2024

2.74.1 (February 26)

Refactored

• Internal API refactoring.

2.74.0 (February 13)

Removed

• Removed support for the following NAICS taxonomy version:
  • naics_std_2017

January 2024

2.73.0 (January 12)

Added

• Exposed new posting field and filter:
  • source_types

December 2023

2.72.1 (December 20)

Fixed

• Fixed an issue with ranking distributions.

2.72.0 (December 15)

Changed

• Default NAICS version changed to naics_std_2022.

November 2023

2.71.0 (November 17)

Added

• New metric: average_salary

2.70.0 (November 3)

Refactored

• Updated back-end infrastructure.

October 2023

2.69.1 (October 26)

Fixed

• Fixed issue with min_years_experience bounds causing no postings to be returned.

2.69.0 (October 20)

Added

• Added the ability to filter for missing fields using a new advanced filter:
  • include_missing

2.68.1 (October 11)

Refactored

• Updated internal functionality.

2.68.0 (October 6)

Removed

• Removed support for the following facets:
  • job_levels
  • job_levels_name
  • job_band
  • job_band_name
• Removed support for the following taxonomies:
  • job_levels
  • job_band

September 2023

2.67.1 (September 26)

Fixed

• Fixed a bug with no-data states on the /distributions/{facet} endpoint.

2.67.0 (September 22)

Added

• Added the ability to perform distributions on rankings using the new rankings/{rankingFacet}/distributions/{distributionFacet} endpoint.
• Added the following optional field for timeseries requests:
  • interval

July 2023

2.66.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 its respective metadata.

May 2023

2.65.0 (May 24)

Added

• Added support for the following NAICS taxonomy version:
  • naics_std_2022

2.64.0 (May 4)

Added

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

March 2023

2.63.1 (March 24)

Refactored

• Updated back-end infrastructure.

February 2023

2.63.0 (February 10)

Added

• Added support for the following filters and facets:

  • lightcast_sectors
  • lightcast_sectors_name

• Added the following taxonomy:

  • lightcast_sectors

2.62.1 (February 3)

Fixed

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

2.62.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.61.1 (January 6)

Fixed

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

December 2022

2.61.0 (December 13)

Added

• filter now supports both list and object types.

2.60.1 (December 12)

Refactored

• Refactored internal field formatting.

2.60.0 (December 2)

Changed

• Default SOC version changed to soc_2021.
• Default ONET version changed to onet_2019.

November 2022

2.59.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.58.2 (October 13)

Refactored

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

2.58.1 (October 6)

Refactored

• Updated references to internal datasets.

August 2022

2.58.0 (August 18)

Removed

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

2.57.2 (August 9)

Added

• Exposed duration fields and metrics in /meta.

2.57.1 (August 4)

Fixed

• Corrected typo in max_edulevels facet.

July 2022

2.57.0 (July 29)

Removed

• Removed support for the following company taxonomy version:
  • company

2.56.0 (July 25)

Added

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

2.55.1 (July 13)

Refactor

• Updating hard and soft skills in preparation for removal

2.55.0 (July 8)

Added

• Added support for the following filters and facets:
  • cip2
  • cip2_name
  • cip4
  • cip4_name
  • cip6
  • cip6_name
• Added support for the following taxonomy:
  • cip

2.54.0 (July 8)

Added

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

2.53.0 (July 6)

Added

• Added support for the following filters and facets:
  • min_edulevels
  • min_edulevels_name
  • max_edulevels
  • max_edulevels_name

June 2022

2.52.0 (June 28)

Added

• Added support for new SOC taxonomy version:
  • soc_2021

April 2022

2.51.0 (April 12)

Added

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

2.50.0 (April 12)

Added

• Added support for the following filters:
  • min_salary
  • max_salary

2.49.2 (April 12)

Fixed

• Fixed an issue preventing unique_companies metric from working as expected.

2.49.1 (April 1)

Removed

• Support for internal dataset.

March 2022

2.49.0 (March 28)

Added

• Added internal filter option.

2.48.1 (March 18)

Refactored

• Improved SOC tagging in postings.

2.48.0 (March 18)

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

2.47.1 (March 17)

Fixed

• Improved performance of ranking endpoints.

2.47.0 (March 14)

Added

• Added support for the following filters and facets:

  • career_area
  • career_area_name

• Added support for the following taxonomy:

  • career_area

2.46.0 (March 3)

Added

• Added support for the following filters and facets:

  • specialized_occupation
  • specialized_occupation_name
  • occupation
  • occupation_name
  • occupation_group
  • occupation_group_name

• Added support for the following taxonomy:

  • specialized_occupation
  • occupation
  • occupation_group

2.45.0 (March 2)

Added

• Dual tagging for onet.
• New query parameter: onet_version

February 2022

2.44.0 (February 24)

Added

• Added support for the following filters and facets:

  • remote_type
  • remote_type_name

• Added support for the following taxonomy:

  • remote_type

January 2022

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

2.42.1 (January 13)

Fixed

• Fixed an issue causing the /postings endpoint to time out when posting bodies were improperly formatted.

2.42.0 (January 10)

Changed

• The internal job posting data source has changed.

Removed

• Removed support for following field:
  • duration
• Removed support for following filter:
  • posting_duration
• Removed support for following metric:
  • median_posting_duration

2.41.2 (January 7)

Refactored

• Improved support for alternative posting datasets.

December 2021

2.41.0 (December 13)

Removed

• Removed SOC version soc_emsi_2017.

2.40.2 (December 7)

Added

• Increased allowed ranking limits for city, company, and title facets.

2.40.1 (December 6)

Refactored

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

November 2021

2.40.0 (November 17)

Changed

• Default company version changed to emsi_company.

2.39.3 (November 16)

Removed

• Removed noisy API logs.

2.39.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.39.1 (October 22)

Changed

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

August 2021

2.36.2 (August 25)

Fixed

• Fixed a bug causing taxonomy search on emsi_company to return empty dataset.

July 2021

2.36.1 (July 23)

Added

• Added support for emsi_company version for naics and company_is_staffing fields.

2.36.0 (July 21)

Removed

• The deprecated /samples endpoint from the API.

June 2021

2.35.1 (June 7)

Fixed

• Fixed a bug that causes status check on internal database to fail.

2.35.0 (June 4)

Added

• Dual tagging for company.
• New query parameter: company_version

2.34.1 (June 4)

Fixed

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

April 2021

2.34.0 (April 12)

Changed

• Default soc version changed to soc_emsi_2019.

March 2021

2.33.8 (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.33.7 (March 25)

Changed

• Utilized new features in timeseries query construction to improve performance

February 2021

2.33.6 (February 26)

Changed

• Default title version changed to emsi.

Removed

• Title version carotene.

December 2020

2.33.5 (December 17)

Fixed

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

2.33.3 (December 2)

Fixed

• Fixed an issue causing false negative health checks resulting in periodic service outages.

November 2020

2.33.2 (November 23)

Fixed

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

2.33.1 (November 19)

Refactored

• Rolled back database query preferences causing query performance issues introduced in 2.33.0.

2.33.0 (November 13)

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.32.2 (November 11)

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.32.1 (October 22)

Changed

• Title taxonomy version in /meta now specifies version number for Emsi titles.

2.32.0 (October 9)

Added

• Added unique_posting property to city taxonomy responses.

Changed

• Updated city taxonomy's search scoring so the results are more relevant.

2.31.1 (October 7)

Fixed

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

September 2020

2.31.0 (September 17)

Added

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

2.30.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.29.0 (August 26)

Added

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

2.28.0 (August 25)

Added

• Added an is_internship request filter.

2.27.1 (August 24)

Fixed

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

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

2.26.1 (August 17)

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.

2.26.0 (August 11)

Added

• Added title field to /samples response.

2.25.0 (August 7)

Added

• Added unique_postings property to Emsi titles taxonomy results.

Changed

• Updated title taxonomy's search scoring so the results are more relevant.

July 2020

2.24.6 (July 2)

Fixed

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

June 2020

2.24.5 (June 29)

Added

• Added soc_emsi_2019 to soc_version query parameter.

April 2020

2.24.3 (April 28)

Changed

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

2.24.2 (April 15)

Refactored

• Refactored calculation of the total_postings metric.

2.24.1 (April 15)

Fixed

• Removed requirement of the soc2 properties when searching for Emsi Titles.

2.24.0 (April 14)

Added

• New filter: sources

2.23.3 (April 6)

Added

• City taxonomy endpoints now return a location property.

2.23.2 (April 2)

Changed

• Updated autocomplete=false taxonomy search functionality, all search terms must match to get results.

March 2020

2.23.1 (March 30)

Added

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

2.23.0 (March 19)

Added

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

2.22.3 (March 2)

Fixed

• Issue causing 500 in certain timeseries requests

February 2020

2.22.2 (February 18)

Changed

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

January 2020

2.22.1 (January 31)

Added

• Incorporated new authorization functionality.

2.21.0 (January 20)

Removed

• The deprecated skills_op filter.

2.20.1 (January 16)

Refactored

• Improved query performance of the active postings filter.

2.20.0 (January 16)

Added

• New metrics: min_salary and max_salary

December 2019

2.19.0 (December 19)

Added

• New filter: salary
• New metric: median_salary

2.18.4 (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.18.3 (November 26)

Added

• New filter: is_remote

2.18.1 (November 22)

Changed

• Improved back-end query resilience.

2.18.0 (November 18)

Added

• Added support for the following facets:
  • min_years_experience
  • max_years_experience

2.17.1 (November 18)

Changed

• Improved keyword expression validation performance.

2.17.0 (November 14)

Removed

• Experimental facet and filter skill_cluster has been removed.

2.16.1 (November 8)

Changed

• Improved status check.

2.16.0 (November 7)

Changed

• /meta response now shows nested filters.

2.15.0 (November 1)

Changed

• More restrictive access to job posting samples.

October 2019

2.14.0 (October 28)

Added

• Added skills and skills_name fields to sample postings.

2.13.3 (October 24)

Changed

• Database stability improvements.

September 2019

2.13.2 (September 13)

Changed

• Updated underlying data structure.

August 2019

2.13.1 (August 8)

Changed

• Removed the fuzzy matching functionality of company, skills, and title taxonomy search to reduce noise in search results.
  As a result, search score values and the order of search results will be different from the previous functionality.

July 2019

2.13.0 (July 17)

Added

• Added support for the following filters and facets:
  • fips_name
  • county_name
  • msa_name
  • state_name
  • onet_name
  • soc2_name
  • soc3_name
  • soc4_name
  • soc5_name
  • naics2_name
  • naics3_name
  • naics4_name
  • naics5_name
  • naics6_name

2.12.0 (July 11)

Changed

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

April 2019

2.11.0 (April 16)

Added

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

March 2019

2.10.1 (March 29)

Changed

• The company, skills, and title taxonomy's search scoring process has been updated. 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.

2.10.0 (March 21)

Added

• 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

  JSON

  {
      "filter": {
          "when": {
              "start": "2019-03-01",
              "end": "2019-03-20"
          }
      }
  }
  

2.9.1 (March 20)

Changed

• Upgraded proxy web server.

2.9.0 (March 15)

Added

• The when filter now supports filtering to postings that are currently active, regardless of the date they were posted. The set of active postings is usually updated daily and may include postings for months that are not yet complete. The available_months list returned from the /meta endpoint only includes complete months, while using this new filter will include postings from the current month that may not yet be complete.

  Note: this filter is not supported in the timeseries endpoints.

  Example

  JSON

  {
      "filter": {
          "when": "active"
      }
  }
  

2.8.1 (March 12)

Changed

• Improved precision of rankings when requesting low limits.

2.8.0 (March 6)

Changed

• Minor performance improvements.

Removed

• Removed soc_emsi_2010 from soc_version query parameter.

2.7.0 (March 5)

Added

• New posting_duration filter for filtering postings by their posting duration.

  Example

  Filter to postings in 2018 that were closed within 20 days of being posted.

  JSON

  {
      "filter": {
          "when": {"start": "2018-01", "end": "2018-12"},
          "posting_duration": {
              "lower_bound": 0,
              "upper_bound": 20
          }
      }
  }
  

February 2019

2.6.0 (February 27)

Removed

• data_version has been removed from meta.

2.5.3 (February 21)

Changed

• New improvements to the company taxonomy search results. Exact matches influence the scoring process more, so relevant results get higher scores. As a result, search score values and the order of search results will be different from the former search process.

2.5.2 (February 20)

Changed

• Improved performance of city taxonomy list and lookup endpoints.

2.5.1 (February 15)

Changed

• New improvements to the title taxonomy search results. Exact matches influence the scoring process more, so relevant results get higher scores. As a result, search score values and the order of search results will be different from the former search process.

2.5.0 (February 15)

Changed

• Further improvements to the skills taxonomy search results. Exact matches and alternative skill names influence the scoring process more, so relevant results get higher scores. As a result, search score values and the order of search results will be different from the former search process.

Removed

• Removed the deprecated skill_type field from skills taxonomy search results, in favor of the properties.skills_type field.

January 2019

2.4.1 (January 30)

Fixed

• Handle missing company taxonomy properties more gracefully.

2.4.0 (January 28)

Added

• Experimental facet and filter skill_cluster has been added for ranking and filtering job postings by skill clusters. A skill cluster is a grouping of skills that categorize a posting into a particular job type. Skill clusters are organic groupings of job types that can change over time, so they don't have concrete names (a skills cluster's name can be categorized as one of the top job titles for the cluster at a particular time), therefore skill cluster names are not provided as facets or filters.

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

December 2018

2.2.0 (December 19)

Added

• Added ids to the city taxonomy
  • The /taxonomies/city/lookup endpoint now works with cities
  • The /taxonomies/city endpoints now includes id values (previously they were null)
• Added a city filter that uses city ids
• Added a city facet that allows you to rank on city ids, this facet works on the following endpoints:
  • Rankings – /rankings/city
  • Nested rankings – /rankings/city/rankings/city
  • Ranking timeseries – /rankings/city/timeseries

Changed

• The city taxonomy has been updated to include ids. You can now search, list, and lookup cities just like you can with all of the other taxonomies, as well as filter and rank on city ids.

September 2018

2.1.0 (September 18)

Added

• Added an optional 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.

  JSON

  {
    "filter": {
        "when": {"start": "2018-01", "end": "2018-06"},
        "skills_name": {
            "include": ["Accounting", "Automation"],
            "exclude": ["Management"],
            "include_op": "and"
        }
    }
  }
  

Deprecated

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

Removed

• Both the source_broad and source_specific filters and facets have been removed.

July 2018

2.0.0 (July 25)

Added

• New metric: posting duration–a measure of how long a posting has been active–as a signal of how difficult it is to fill a specific position and insight into demand.
• New filter: experience level filtering to refine analysis of employer demand, e.g. 0-3 years (min_years_experience and max_years_experience).
• New filter: filtering postings by full-time positions versus part-time (employment_type).
• New response field: links to live job postings in /samples responses when available.
• New filter option: filtering by the month in which postings were posted or removed, not just months in which postings were active.

Changed

• New features are powered by improvements in the underlying data.
  • Improved de-duplication methodology.
  • An emphasis on jobs posted to employer sites.
  • Clearer sourcing information for active posting samples with linking.
• All job posting samples will be viewable, and as a result the /samples endpoint will no longer have a unique_postings_not_displayable key.
• The yearmonth field in responses to the /samples endpoint will be replaced by posted and expired dates.
• There will be a noticeable change in posting volume in comparison to our previous version—this is primarily caused by the data improvements.

Deprecated

• Both the source_broad and source_specific filters and facets will be removed.

Removed

• Due to methodology changes, job posting history prior to September 2016 will no longer be available. If you are already using the /meta endpoint correctly to get available posting months before pulling data, no change will be required. When the changes are released, the /meta response will reflect the new set of available months.