Aggregate Profiles 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

1.58.0 (June 20)

Added

• Added support for nested rankings.

1.57.0 (June 10)

Added

• Added support for the following fields:

  • years_of_work_history

• Added support for the following metrics:

  • median_years_of_experience_in_occupation
  • median_years_with_most_recent_company
  • median_years_in_current_role
  • median_moves_in_most_recent_company

1.56.0 (June 6)

Added

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

May 2025

1.55.0 (May 12)

Refactored

• Made internal changes.

April 2025

1.54.0 (April 11)

Changed

• Default lot_version changed to 7

March 2025

1.53.0 (March 17)

Changed

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

January 2025

1.52.0 (January 27)

Added

• Added support for LOT version 7.

• Added support for the following query parameter:

  • lot_version

1.51.0 (January 7)

Added

• Added support for the following filters and facets:
  • years_with_previous_company
  • moves_in_previous_company

December 2024

1.50.0 (December 10)

Added

• Added support for the following filters and facets:
  • most_recent_company
  • years_with_most_recent_company
  • years_in_current_role
  • moves_in_most_recent_company
  • most_recent_company_start_date
  • most_recent_company_end_date
  • previous_company
  • previous_company_start_date
  • previous_company_end_date
  • years_of_experience

October 2024

1.49.0 (October 18)

Added

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

August 2024

1.48.0 (August 29)

Added

• Added new distributions endpoint with support for the following facets:
  • estimated_wage

1.47.0 (August 20)

Added

• Added support for the following ranking facet:
  • grad_year

1.46.0 (August 5)

Added

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

July 2024

1.45.0 (July 19)

Added

• Added support for the following facets:

  • estimated_wage_p25
  • estimated_wage_p50
  • estimated_wage_p75

• Added support for the following filters:

  • estimated_wage_p25.lower_bound
  • estimated_wage_p25.upper_bound
  • estimated_wage_p50.lower_bound
  • estimated_wage_p50.upper_bound
  • estimated_wage_p75.lower_bound
  • estimated_wage_p75.upper_bound

• Added support for the following metric:

  • estimated_wage_p50

February 2023

1.44.0 (February 13)

Removed

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

January 2023

1.43.0 (January 12)

Changed

• Changed the minimum profiles limit.

December 2023

1.42.0 (December 15)

Changed

• Default NAICS version changed to naics_std_2022.

1.41.0 (December 12)

Refactored

• Made internal changes.

1.40.0 (December 6)

Added

• Added support for Profiles Data Supression.

September 2023

1.38.3 (September 26)

Fixed

• Resolved a versioning issue related to an internal endpoint.

1.38.2 (September 12)

Fixed

• Fixed issue that limited responses when filtering on educations.grad_year.

July 2023

1.38.1 (July 12)

Fixed

• Fixed issue causing NAICS 2022 data to not return correctly.

May 2023

1.38.0 (May 24)

Added

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

March 2023

1.37.3 (March 31)

Refactored

• Made internal mapping changes.

1.37.2 (March 24)

Refactored

• Updated back-end infrastructure.

February 2023

1.37.1 (February 13)

Fixed

• CIP filters now appropriately target the correct version.

1.37.0 (February 7)

Added

• Added support for the following filter:
  • educations.grad_year

January 2023

1.36.0 (January 9)

Added

• filter now supports both list and object types.

December 2022

1.35.0 (December 2)

Changed

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

August 2022

1.34.0 (August 18)

Removed

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

July 2022

1.33.0 (July 29)

Removed

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

1.32.0 (July 21)

Added

• Added support for the following filters, facets and taxonomy:
  • gender
  • gender_name

1.31.2 (July 18)

Fixed

• Resolved a versioning issue related to an internal endpoint.

1.31.1 (July 13)

Refactor

• Updating hard and soft skills in preparation for removal

June 2022

1.31.0 (June 28)

Added

• Added support for new SOC taxonomy version:
  • soc_2021

1.30.1 (June 23)

Changed

• Improved SOC field tagging quality.

May 2022

1.30.0 (May 26)

Added

• New query parameter: onet_version

1.29.0 (May 19)

Changed

• Improved performance of ranking endpoints.

1.28.0 (May 18)

Added

• Added support for the following ranking filters and facets:
  • county_name
  • fips_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

1.27.0 (May 13)

Added

• Added is_software property to skills taxonomy.

• Added support for the following ranking facets:

  • software_skills
  • software_skills_name

1.26.1 (May 5)

Fixed

• Resolved a versioning issue related to an internal endpoint.

1.26.0 (May 2)

Added

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

April 2022

1.25.0 (April 20)

Changed

• Updated internal API functionality.

1.24.1 (April 12)

Fixed

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

March 2022

1.23.1 (March 29)

Changed

• Unlimited ranking is now allowed for city, company and title facets.

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

1.21.1 (February 23)

Fixed

• Fixed a bug causing exclusive verbose filter to not work properly when used for educations filter.

January 2022

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

1.19.0 (January 14)

Added

• Added experimental job history endpoint.

December 2021

1.18.0 (December 13)

Removed

• Removed SOC version soc_emsi_2017.

1.17.1 (December 6)

Refactored

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

November 2021

1.17.0 (November 17)

Changed

• Default company version changed to emsi_company.

1.16.2 (November 16)

Fixed

• Fixed a bug that was causing query parameters to be ignored in multiple endpoints.

1.16.1 (November 16)

Removed

• Removed noisy API logs.

1.16.0 (November 2)

Changed

• Uppdated the default CIP version from cip2010 to cip2020.

October 2021

1.15.3 (October 22)

Changed

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

August 2021

1.15.2 (August 26)

Added

• Added support for emsi_company version for naics field.

July 2021

1.15.1 (July 8)

Fixed

• Fixed new cip code version bug that was causing problems for analytics.

1.15.0 (July 8)

Added

• Dual tagging for CIP codes.
• New query parameter: cip_version

June 2021

1.13.1 (June 7)

Fixed

• Fixed a bug causing company ids to be used when requesting company names.

1.13.0 (June 4)

Added

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

April 2021

1.12.0 (April 12)

Changed

• Default soc version changed to soc_emsi_2019.

March 2021

1.11.5 (March 25)

Changed

• Improved internal timeseries query.

February 2021

1.11.4 (February 26)

Changed

• Default title version changed to emsi.

Removed

• Title version carotene.

October 2020

1.11.2 (October 23)

Changed

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

August 2020

1.11.1 (August 24)

Fixed

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

1.11.0 (August 7)

Changed

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

July 2020

1.10.6 (July 2)

Fixed

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

1.10.5 (July 1)

Added

• Added soc_emsi_2019 to available soc versions.

May 2020

1.10.3 (May 29)

Changed

• Improved non-autocomplete taxonomy searches.

1.10.2 (May 1)

Added

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

April 2020

1.10.1 (April 28)

Changed

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

March 2020

1.10.0 (March 26)

Added

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

February 2020

1.9.2 (February 18)

Fixed

• Rank by significance is now returning properly.

January 2020

1.9.1 (January 31)

Added

• Incorporated new authorization functionality.

1.8.1 (January 22)

Refactored

• Improved the quality of taxonomy search results.

1.8.0 (January 20)

Removed

• The deprecated skills_op filter.
• The deprecated schools filter.
• The deprecated schools_ipeds filter.
• The deprecated schools_name filter.
• The deprecated schools_op filter.

December 2019

1.7.4 (December 6)

Fixed

• The /recency endpoint now properly filters to the requested time frame.

November 2019

1.7.3 (November 23)

Added

• Expose skills taxonomy version in /meta.

1.7.2 (November 22)

Refactored

• Cleaned up internal references to unused country filters.

1.7.1 (November 18)

Changed

• Improved keyword expression validation performance.

1.7.0 (November 15)

Removed

• Unused country filter and query parameters have been removed.

1.6.1 (November 8)

Changed

• Improved status check.

1.6.0 (November 7)

Changed

• /meta response now shows nested filters.

October 2019

1.5.2 (October 18)

Changed

• Database stability improvements.

August 2019

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

1.5.0 (July 12)

Added

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

1.4.0 (July 10)

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 profiles that were updated in 2018 or later that include both Accounting and Automation skills but not Management skills.

  JSON

  {
    "filter": {
        "last_updated": {"start": "2018"},
        "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.

June 2019

1.3.1 (June 26)

Fixed

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

May 2019

1.3.0 (May 6)

Changed

• Improved the way meta is pulled internally.

Added

• Added available facets, filters and metrics to meta endpoint response.
• Added supportsAdvancedFilters field to meta endpoint response.

March 2019

1.2.3 (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.

1.2.2 (March 20)

Changed

• Updated proxy web server.

1.2.1 (March 19)

Changed

• Improved precision of rankings when requesting low limits.

1.2.0 (March 6)

Changed

• Minor performance improvements.

Removed

• Removed soc_emsi_2010 from soc_version query parameter.

February 2019

1.1.1 (February 21)

Changed

• New improvements to the company, title, and skills 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.

January 2019

1.1.0 (January 14)

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.

Added

• Company taxonomy properties that will now return in search, lookup, and list responses:

  • address
  • city
  • country
  • naics
  • state
  • website

  Example Request

  https://emsiservices.com/profiles/taxonomies/company?q=google&limit=1

  {
    "data": [
        {
            "id": "NC92337974-0c7e-478c-ae3c-c68a08d91045",
            "name": "Google Inc.",
            "properties": {
                "address": "1600 Amphitheatre Pkwy",
                "city": "Mountain View",
                "country": "US",
                "naics": "517110",
                "profiles": 46898,
                "state": "CA",
                "website": "www.google.com"
            },
            "score": 68.90731
        }
    ]
  }
  

1.0.0 (January 11)

Fixed

• Facets that do not allow unlimited rankings incorrectly returned a 500. They now return a 400 with a message stating that an unlimited ranking is not allowed for the facet.