Global Profiles Changelog

3 months ago by ReadMe API

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.29.0 (June 27)

Added

Added support for nested rankings.

1.28.0 (June 11)

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.27.0 (June 11)

Added

Added the ability to filter transitions by laa_country.

May 2025

1.26.0 (May 12)

Refactored

Made internal changes.

Added

Added job transitions endpoints.

April 2025

1.25.0 (April 30)

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.24.0 (April 11)

Changed

Default lot_version changed to 7.

January 2025

1.23.0 (January 27)

Added

Added support for LOT version 7.
Added support for the following query parameter:
- lot_version
Added support for the following filters and facets:
- years_with_previous_company
- moves_in_previous_company

December 2024

1.22.0 (Dec 16)

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.21.0 (October 18)

Removed

Removed support for unlimited ranking limit on the following facets:
- company
- title

August 2024

1.20.0 (August 5)

Added

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

January 2023

1.19.0 (January 12)

Changed

Changed the minimum profiles limit.

December 2023

1.18.0 (December 6)

Added

Added support for Profiles Data Supression.

November 2023

1.17.0 (November 9)

Added

Added support for the following fields in /meta:
- earliest_year
- latest_year

October 2023

1.16.0 (October 11)

Added

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

September 2023

1.15.0 (September 29)

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

September 2023

1.14.1 (September 7)

Refactored

Refactored some internal functionality.

January 2023

1.14.0 (January 9)

Added

filter now supports both list and object types.

November 2022

1.13.1 (November 18)

Refactored

Improved coverage of certain exclusion values in request filters.

September 2022

1.13.0 (September 12)

Removed

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

May 2022

1.12.0 (May 19)

Changed

Improved performance of ranking endpoints.

March 2022

1.11.1 (March 31)

Fixed

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

January 2022

1.11.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.10.4 (December 6)

Refactored

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

November 2021

1.10.3 (November 16)

Removed

Removed noisy API logs.

May 2021

1.10.2 (May 12)

Added

Added skills and titles taxonomy versions in /meta.

1.10.1 (May 12)

Fixed

Fixed an issue preventing taxonomy search autocomplete=false functionality from working as expected.

Added

Title taxonomy responses now return profiles as a response property.

1.10.0 (May 6)

Added

Support for the following facets for /taxonomies endpoint:
- gender
Support for the following facets for /rankings endpoint:
- gender
- gender_name
Support for the following filters:
- gender
- gender_name

March 2021

1.9.0 (March 10)

Removed

Removed version query param from all endpoints.
Removed version and available_versions from /meta response.

1.8.0 (March 1)

Changed

The API is now using Emsi titles.

October 2020

1.7.0 (October 23)

Added

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

July 2020

1.6.1 (July 14)

Added

Added location property to market taxonomy.

June 2020

1.6.0 (June 12)

Added

Support for the following facets for /taxonomies endpoint:
- market
- nation
- occupation
- onet
- schools
Support for the following facets for /rankings endpoint:
- market_name
- nation_name
- occupation_name
- onet_name
Support for the following filters:
- market_name
- nation_name
- occupation_name
- onet_name

Removed

Unsupported filters:
- education.cip2
- education.cip2_name
- education.cip4
- education.cip4_name
- education.cip6
- education.cip6_name
- education.edulevels
- education.edulevels_name
- education.school_ipeds

April 2020

1.5.1 (April 28)

Changed

Increased taxonomy list and search results limit maximum to 10000.

January 2020

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

November 2019

1.4.1 (November 8)

Changed

Improved status check.

1.4.0 (November 7)

Changed

/meta response now shows nested filters.

September 2019

1.3.2 (September 30)

Refactored

Improved the company taxonomy's search and lookup performance.

1.3.1 (September 6)

Added

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

Changed

Database stability improvements.

August 2019

1.3.0 (August 15)

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 include both C and Java Programming Language skills but not Accounting skills.
```
{
    "filter": {
        "skills_name": {
            "include": [
                "C (Programming Language)",
                "Java (Programming Language)"
            ],
            "exclude": [
                "Accounting"
            ],
            "include_op": "and"
        }
    }
}
```

Deprecated

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

1.2.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.2.0 (July 12)

Added

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

June 2019

1.1.7 (June 27)

Fixed

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

May 2019

1.1.6 (May 10)

Fixed

Make meta endpoint respect version query parameter.

1.1.5 (May 10)

Changed

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

March 2019

1.1.4 (March 20)

Changed

Upgraded proxy web server.

1.1.3 (March 19)

Changed

Improved precision of rankings when requesting low limits.

1.1.2 (March 12)

Fixed

Fixed a bug causing unlimited rankings to return a 500.

1.1.1 (March 4)

Changed

Minor performance improvements.

January 2019

1.1.0 (January 30)

Added

New version query parameter for selecting from the available data versions.
New available_versions field in meta that lists all available data versions.

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.