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 apisupport@lightcast.io.

July 2026

2.95.0 (July 1)

Refactored

Made internal changes.

* Added internal field mapping endpoint: /internal/fieldmap (requires OAuth scope internal).

June 2026

2.94.1 (June 30)

Fixed

Fixed /timeseries and /rankings/{rankingFacet}/timeseries bucket date labels.

2.94.0 (June 23)

Added

Added support for the following fields, filters, and facets:
- company_v2
- company_name_v2
- isced
- isced_name
- isced_max
- isced_max_name
- isced_min
- isced_min_name
Added support for the following taxonomies:
- company_v2
- isced

March 2026

2.93.2 (March 20)

Refactored

Made internal changes to taxonomy search.

2.93.1 (March 03)

Refactored

Updated unique_companies metric precision to reduce estimation error and improve uniqueness accuracy.

* DEFAULT_UNIQUE_COMPANIES_PRECISION value updated 20 -> 3000 (API-2097).

February 2026

2.93.0 (February 25)

Refactored

Made internal changes.

* Removed field mapping for all benefits fields.

2.92.0 (February 18)

Added

Added support for the following fields, filters, and facets:
- 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
Added support for the following taxonomies:
- laa_country
- laa_admin_area_1
- laa_admin_area_2
- laa_metro

2.91.1 (February 6)

Added

Fixed a bug when ranking by significance with only a when filter.

January 2026

2.91.0 (January 23)

Added

Added support for the following field, filter, and facet:
- stars_qualified

November 2025

2.90.0 (November 14)

Added

Added support for the following rankings facets:
- is_fortune100
- is_fortune500
- is_fotrune1000

October 2025

2.89.0 (October 31)

Removed

Removed the following taxonomy versions:
- onet_2010
- soc_emsi_2019

Added

Added support for the following filters and facets:
- benefit
- benefit_name
- benefit_categories
- benefit_categories_name
Added support for the following taxonomies:
- benefit
- benefit_categories

September 2025

2.88.1 (September 23)

Fixed

Fixed meta response showing incorrect NAICS version.

August 2025

2.88.0 (August 21)

Changed

Renamed us_area version 1.0.3 to 2.0.0.

July 2025

2.87.0 (July 16)

Added

Added pipelineVersion to meta response.

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.

* Switched all salary fields to used trimmed prefix.

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.

* Removed GENERATED_ID_FACET_MAPPING 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.1 (December 20)

Removed

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

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.

September 2021

2.39.0 (September 24)

Added

Added support for the following ranking facets:
- job_band
- job_band_name
- job_levels
- job_levels_name
Added support for the following taxonomy facets:
- job_band
- job_levels
Added support for the following filters and postings fields:
- job_band
- job_band_name
- job_levels
- job_levels_name
- is_supervisor

2.38.0 (September 9)

Added

Support for burning glass jpa feed.

2.37.0 (September 2)

Added

New metric: median_max_salary

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.4 (December 11)

Added

Support for analytics on Emsi posting data.

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.4 (April 30)

Added

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

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.22.0 (January 21)

Added

Experimental support has been added for the following filter and facet:
- msa_skill_cluster
Experimental taxonomy has been added for the following facet:
- msa_skill_cluster

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

Removed

Experimental support has been removed for the representative_skill_cluster filter and facet

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.

Added

Experimental support has been added for the following filters and facets:
- national_skill_cluster
- representative_skill_cluster
- state_skill_cluster
Experimental taxonomies have been added for the following facets:
- national_skill_cluster
- representative_skill_cluster
- state_skill_cluster

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
```
{
    "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
```
{
    "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.

{
    "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.
```
{
  "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.

Changelog