LIlightcast
Rankings

Get a ranking of a selected facet with timeseries data

Group and rank postings by {ranking_facet} with a monthly or daily timeseries for each ranked group. Use YYYY-MM date format in the timeseries time-frame filter, timeseries.when, to get monthly summary of each ranked group, or use YYYY-MM-DD date format for daily summary.

post/rankings/{rankingFacet}/timeseries

Request

  • Base URL
    https://api.lightcast.io/alumni-pathways
  • URL
    https://api.lightcast.io/alumni-pathways/rankings/{rankingFacet}/timeseries
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: alumni-pathways

Path parameters

rankingFacet'certifications' | 'certifications_name' | 'cip2' | 'cip2_name' | 'cip4' | 'cip4_name' | 'cip6' | 'cip6_name' | 'city' | 'city_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'company_name_v2' | 'company_v2' | 'contract_type' | 'contract_type_name' | 'county' | 'county_name' | 'edulevels' | 'edulevels_name' | 'employment_type' | 'employment_type_name' | 'fips' | 'fips_name' | 'job_seniority' | 'job_seniority_name' | 'laa_admin_area_1' | 'laa_admin_area_1_name' | 'laa_admin_area_2' | 'laa_admin_area_2_name' | 'laa_country' | 'laa_country_name' | 'laa_metro' | 'laa_metro_name' | 'language' | 'language_name' | 'lightcast_sectors' | 'lightcast_sectors_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' | 'max_years_experience' | 'min_edulevels' | 'min_edulevels_name' | 'min_years_experience' | 'msa' | 'msa_name' | 'naics2' | 'naics2_name' | 'naics3' | 'naics3_name' | 'naics4' | 'naics4_name' | 'naics5' | 'naics5_name' | 'naics6' | 'naics6_name' | 'onet' | 'onet_name' | 'remote_type' | 'remote_type_name' | 'skill_categories' | 'skill_categories_name' | 'skill_subcategories' | 'skill_subcategories_name' | 'skills' | 'skills_name' | 'soc2' | 'soc2_name' | 'soc3' | 'soc3_name' | 'soc4' | 'soc4_name' | 'soc5' | 'soc5_name' | 'software_skills' | 'software_skills_name' | 'sources' | 'specialized_skills' | 'specialized_skills_name' | 'state' | 'state_name' | 'title' | 'title_name' required

The facet to rank by.

Query parameters

soc_version'soc_2021'

Specify SOC taxonomy version to use.

onet_version'onet_2019'

Specify ONET taxonomy version to use.

title_version'emsi'

Specify Job Title taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

naics_version'naics_std_2022'

Specify NAICS taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

area_version'us_area_2024_3' | 'us_area_2024_4'

Specify Area taxonomy version to use.

area_us_version'1.0.2' | '1.0.3'

Specify US Area taxonomy version to use.

soc_lightcast_version'2018.2021.0'

Specify SOC Lightcast taxonomy version to use.

onet_standard_version'2019.0.0'

Specify ONET Standard taxonomy version to use.

lot_version'7' | '6'

Specify LOT taxonomy version to use.

Request body

Example request

{
  "filter": {
    "company_is_staffing": true,
    "is_fortune100": true,
    "is_fortune1000": true,
    "is_fortune500": true,
    "is_hwol": true,
    "is_internship": true,
    "is_supervisor": true,
    "keywords": {
      "query": "work/life balance"
    },
    "max_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "max_years_experience": {
      "lower_bound": 4,
      "upper_bound": 6
    },
    "min_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "min_years_experience": {
      "lower_bound": 1,
      "upper_bound": 3
    },
    "posting_duration": {
      "upper_bound": 30
    },
    "salary": {
      "lower_bound": 60000,
      "upper_bound": 70000
    },
    "when": {
      "end": "2019-06",
      "start": "2018-06"
    }
  },
  "timeseries": {
    "when": {
      "end": "2019-06",
      "start": "2018-06"
    }
  }
}

Response

OK

Changes

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