Canada 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.57.0 (July 3)

Added

Added support for interval field on timeseries requests.

May 2025

1.56.0 (May 8)

Refactored

Made internal changes.

Switched all salary fields to used trimmed prefix.

April 2025

1.55.0 (April 11)

Changed

Default lot_version changed to 7.

Febraury 2025

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

1.53.0 (January 27)

Added

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

November 2024

1.52.0 (November 1)

Changed

Changed the default area version from ca_area_sgc2016 to ca_area_sgc2021.
Changed the default area_ca version from 2016.0.0 to 2021.0.0.

October 2024

1.51.0 (October 14)

Refactored

Changed internal field mappings for city and city_name.

September 2024

1.50.0 (September 11)

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

1.49.0 (August 19)

Added

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

1.48.0 (August 5)

Added

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

May 2024

1.47.1 (May 8)

Refactored

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

April 2024

1.47.0 (April 5)

Added

Added support for the following taxonomy:
- language_taxonomy
Added support for the following filters and facets:
- language
- language_name

March 2024

1.46.2 (March 14)

Refactored

Internal API refactoring.

1.46.1 (March 5)

Refactored

Improved percentile distribution performance.

November 2023

1.46.0 (November 17)

Added

New metric: average_salary

October 2023

1.45.1 (October 11)

Refactored

Updated internal functionality.

Removed GENERATED_ID_FACET_MAPPING functionality.

1.45.0 (October 6)

Refactored

Updated back-end infrastructure.

Removed

Removed the following NOC taxonomy version:
- ca_noc2016emsi

August 2023

1.44.0 (August 1)

Changed

Changed default NOC version from ca_noc2016emsi to ca_noc2021

July 2023

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

June 2023

1.42.0 (June 5)

Added

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

1.41.1 (June 5)

Changed

Changed the following NOC taxonomy versions:
- ca_noc2016emsi
- ca_noc2021

May 2023

1.41.0 (May 16)

Added

Added support for the following area taxonomy versions:
- ca_area_sgc2016
- ca_area_sgc2021

1.40.0 (May 9)

Added

Added support for the following NOC taxonomy versions:
- noc_2016
- noc_2021
Added support for the following filters and facets:
- noc5
- noc5_name

March 2023

1.39.2 (March 24)

Refactored

Updated back-end infrastructure.

February 2023

1.39.1 (February 3)

Fixed

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

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

1.38.0 (January 18)

Added

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

1.37.1 (January 6)

Fixed

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

November 2022

1.37.0 (November 7)

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

1.36.4 (October 14)

Fixed

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

1.36.3 (October 14)

Refactored

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

1.36.2 (October 6)

Refactored

Updated references to internal datasets.

August 2022

1.36.1 (August 23)

Removed

Posting duration fields have been temporarily removed from /meta due to data issues. These will return once the issues have been resolved.

1.36.0 (August 18)

Removed

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

1.35.1 (August 9)

Added

Exposed duration fields and metrics in /meta.

1.35.0 (August 4)

Added

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

July 2022

1.34.0 (July 29)

Removed

Removed support for the following company taxonomy version:
- company

1.33.0 (July 22)

Added

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

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

1.32.0 (July 20)

Added

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

1.31.1 (July 13)

Refactor

Updating hard and soft skills in preparation for removal

May 2022

1.31.0 (May 19)

Changed

Improved performance of ranking endpoints.

1.30.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 taxonomy:
- specialized_occupation
- occupation
- occupation_group
- career_area

April 2022

1.29.0 (April 21)

Added

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

1.28.0 (April 12)

Added

Added support for the following filters:
- min_salary
- max_salary

1.27.3 (April 12)

Fixed

Fixed an issue preventing unique_companies metric from working as expected.

1.27.2 (April 6)

Fixed

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

1.27.1 (April 1)

Removed

Support for internal dataset.

March 2022

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

1.26.1 (March 2)

Removed

/meta endpoint no longer shows duration, posting_duration and median_posting_duration as available field, filter and metric for BG data.

January 2022

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

1.25.0 (December 6)

Added

Support for burning glass jpa feed.

1.24.1 (December 6)

Refactored

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

November 2021

1.24.0 (November 17)

Changed

Default company version changed to emsi_company.

1.23.4 (November 16)

Removed

Removed noisy API logs.

1.23.3 (November 15)

Fixed

Fixed a bug causing company taxonomy search to return an error when using the emsi_company version.

1.23.2 (November 3)

Fixed

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

October 2021

1.23.1 (October 22)

Changed

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

July 2021

1.23.0 (July 28)

Dual tagging for following taxonomies and facets:
- company
- naics
Dual tagging for following filters:
- company
- naics
- company_is_staffing
New query parameter: company_version

1.22.0 (July 21)

Removed

The deprecated /samples endpoint from the API.

1.21.8 (July 6)

Fixed

Issue causing 500 in certain timeseries requests.

June 2021

1.21.7 (June 4)

Fixed

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

March 2021

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

1.21.5 (March 26)

Changed

Utilized new features in timeseries query construction to improve performance

1.21.4 (March 25)

Changed

Improved internal timeseries query.

December 2020

1.21.3 (December 17)

Fixed

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

1.21.2 (December 11)

Added

Support for analytics on Emsi posting data.

November 2020

1.21.1 (November 23)

Fixed

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

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

1.20.0 (November 13)

Changed

Updated the title taxonomy, including title facets and filters, to Emsi titles.

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

1.19.1 (October 7)

Fixed

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

September 2020

1.19.0 (September 17)

Added

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

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

1.17.0 (August 26)

Added

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

1.16.0 (August 25)

Added

Added an is_internship request filter.

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

1.14.4 (July 2)

Fixed

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

April 2020

1.14.3 (April 30)

Added

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

1.14.2 (April 28)

Changed

Increased taxonomy list and search results limit maximum to 10000.

1.14.1 (April 15)

Refactored

Refactored calculation of the total_postings metric.

1.14.0 (April 15)

Added

New filter: sources

Fixed

Removed requirement of the noc2 properties when searching for titles.

1.13.3 (April 7)

Added

City taxonomy endpoints now return a location property.

1.13.2 (April 2)

Changed

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

1.13.1 (April 2)

Added

Added the following filters and facets:
- cd_name
- cma_name
- csd_name
- naics2_name
- naics3_name
- naics4_name
- naics5_name
- naics6_name
- noc1_name
- noc2_name
- noc3_name
- noc4_name
- pr_name
- province_name

March 2020

1.13.0 (March 23)

Added

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

1.12.0 (March 16)

Added

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

January 2020

1.11.3 (January 31)

Added

Incorporated new authorization functionality.

December 2019

1.11.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.11.1 (November 26)

Added

New filter: is_remote

1.11.0 (November 18)

Added

Added support for the following facets:
- min_years_experience
- max_years_experience

1.10.2 (November 18)

Changed

Improved keyword expression validation performance.

1.10.1 (November 8)

Changed

Improved status check.

1.10.0 (November 7)

Changed

/meta response now shows nested filters.

1.9.0 (November 1)

Changed

More restrictive access to job posting samples.

October 2019

1.8.0 (October 28)

Added

Added skills and skills_name fields to sample postings.

September 2019

1.7.3 (September 13)

Changed

Updated underlying data structure.

August 2019

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

1.7.1 (August 2)

Changed

Database stability improvements.

July 2019

1.7.0 (July 23)

Changed

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

April 2019

1.6.0 (April 16)

Added

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

March 2019

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

1.5.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
```
{
    "filter": {
        "when": {
            "start": "2019-03-01",
            "end": "2019-03-20"
        }
    }
}
```

1.4.2 (March 20)

Changed

Upgraded proxy web server.

1.4.1 (March 19)

Changed

Improved precision of rankings when requesting low limits.

1.4.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
```
{
    "filter": {
        "when": "active"
    }
}
```

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

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

1.2.1 (March 4)

Changed

Minor performance improvements.

February 2019

1.2.0 (February 27)

Removed

data_version has been removed from meta.

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

1.1.1 (February 20)

Changed

Improved performance of city taxonomy list and lookup endpoints.

1.1.0 (February 19)

Added

noc1 facet, filter, and taxonomy.

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

1.0.1 (February 15)

Changed

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

1.0.0 (February 4)

Added

Start a changelog to document updates to the API.