Rankings

Get distribution on rankings

Group and rank postings by {rankingFacet} with a distribution for each ranked item.

post/rankings/{rankingFacet}/distributions/{distributionFacet}

Request

  • Base URL
    https://api.lightcast.io/ca-jpa
  • URL
    https://api.lightcast.io/ca-jpa/rankings/{rankingFacet}/distributions/{distributionFacet}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: emsi_open

Path parameters

rankingFacet'cd' | 'cd_name' | 'certifications' | 'certifications_name' | 'city' | 'city_name' | 'cma' | 'cma_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'contract_type' | 'contract_type_name' | 'csd' | 'csd_name' | 'edulevels' | 'edulevels_name' | 'employment_type' | 'employment_type_name' | 'lot_career_area' | 'lot_career_area_name' | 'lot_occupation' | 'lot_occupation_name' | 'lot_occupation_group' | 'lot_occupation_group_name' | 'lot_specialized_occupation' | 'lot_specialized_occupation_name' | 'max_edulevels' | 'max_edulevels_name' | 'min_edulevels' | 'min_edulevels_name' | 'max_years_experience' | 'min_years_experience' | 'naics2' | 'naics2_name' | 'naics3' | 'naics3_name' | 'naics4' | 'naics4_name' | 'naics5' | 'naics5_name' | 'naics6' | 'naics6_name' | 'noc1' | 'noc1_name' | 'noc2' | 'noc2_name' | 'noc3' | 'noc3_name' | 'noc4' | 'noc4_name' | 'noc5' | 'noc5_name' | 'pr' | 'pr_name' | 'province' | 'province_name' | 'remote_type' | 'remote_type_name' | 'skill_categories' | 'skill_categories_name' | 'skill_cluster' | 'skill_subcategories' | 'skill_subcategories_name' | 'skills' | 'skills_name' | 'software_skills' | 'software_skills_name' | 'sources' | 'specialized_skills' | 'specialized_skills_name' | 'title' | 'title_name' required
distributionFacet'max_years_experience' | 'min_years_experience' | 'posting_duration' | 'salary' required

Query parameters

noc_version'ca_noc2021'

Specify NOC taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

area_version'ca_area_sgc2016' | 'ca_area_sgc2021'

Specify area taxonomy version to use.

area_ca_version'2021.0.0' | '2016.0.0'

Specify area taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

lot_version'6' | '7'

Specify LOT taxonomy version to use.

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"
    },
    "keywords": {
      "query": "work/life balance"
    },
    "company_is_staffing": true,
    "min_years_experience": {
      "lower_bound": 1,
      "upper_bound": 3
    },
    "max_years_experience": {
      "lower_bound": 4,
      "upper_bound": 6
    },
    "salary": {
      "lower_bound": 60000,
      "upper_bound": 70000
    },
    "min_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "max_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "posting_duration": {
      "upper_bound": 30
    },
    "is_internship": true
  }
}

Response

OK

Changes

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