Distributions

Get distributions on facet

Calculate data distributions (by percentiles or fixed interval) based around numerical job posting fields such as salary and years of experience.

post/distributions/{distributionFacet}

Request

Base URL
https://api.lightcast.io/global-postings
URL
https://api.lightcast.io/global-postings/distributions/{distributionFacet}
Auth
OAuth 2
Client credentials
Token URL: https://auth.emsicloud.com/connect/token scopes: postings:global

Path parameters

distributionFacet'max_years_experience' | 'min_years_experience' | 'posting_duration' | 'salary' required

The facet used as the domain of the distribution.

Query parameters

lot_version'6' | '7'

Example:7

Specify LOT taxonomy version to use.

area_version'lf_area_2023_2' | 'lf_area_2025_1'

Example:lf_area_2025_1

Specify area taxonomy version to use.

area_laa_version'1' | '2'

Example:2

Specify LAA area taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

Request body

Example request

{
  "filter": {
    "active_sources_info": {
      "type": "Company",
      "source": "ABCRecruiting.com",
      "url": "ABCRecruiting.com/job/GNkBaDoMWiyQbmlpFHfz"
    },
    "when": {
      "start": "2018-06",
      "end": "2019-06"
    },
    "company_is_staffing": true,
    "posting_duration": {
      "upper_bound": 30
    },
    "min_years_experience": {
      "lower_bound": 1,
      "upper_bound": 3
    },
    "max_years_experience": {
      "lower_bound": 4,
      "upper_bound": 6
    },
    "min_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "max_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "salary": {
      "lower_bound": 50000,
      "upper_bound": 200000
    }
  }
}

Response

Changes

No recorded changes to this operation across all 1 revision of this API.