LIlightcast
Rankings

Nested rankings

Get a nested ranking (e.g. top companies, then top skills per company).

post/rankings/{rankingFacet}/rankings/{nestedRankingFacet}

Request

  • Base URL
    https://api.lightcast.io/profiles
  • URL
    https://api.lightcast.io/profiles/rankings/{rankingFacet}/rankings/{nestedRankingFacet}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: profiles:us

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' | 'county' | 'county_name' | 'edulevels' | 'edulevels_name' | 'fips' | 'fips_name' | 'gender' | 'gender_name' | 'grad_year' | 'max_edulevels' | 'max_edulevels_name' | 'moves_in_most_recent_company' | 'moves_in_previous_company' | 'msa' | 'msa_name' | 'most_recent_company' | 'most_recent_company_end_date' | 'most_recent_company_start_date' | 'naics2' | 'naics2_name' | 'naics3' | 'naics3_name' | 'naics4' | 'naics4_name' | 'naics5' | 'naics5_name' | 'naics6' | 'naics6_name' | 'onet' | 'onet_name' | 'previous_company' | 'previous_company_end_date' | 'previous_company_start_date' | 'schools' | 'schools_ipeds' | 'schools_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' | 'specialized_skills' | 'specialized_skills_name' | 'state' | 'state_name' | 'title' | 'title_name' | 'years_in_current_role' | 'years_with_most_recent_company' | 'years_with_previous_company' | 'years_of_experience' | 'years_of_experience_in_occupation' | 'revenue_bucket' | 'employee_count_range' required
nestedRankingFacet'certifications' | 'certifications_name' | 'cip2' | 'cip2_name' | 'cip4' | 'cip4_name' | 'cip6' | 'cip6_name' | 'city' | 'city_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'county' | 'county_name' | 'edulevels' | 'edulevels_name' | 'fips' | 'fips_name' | 'gender' | 'gender_name' | 'grad_year' | 'max_edulevels' | 'max_edulevels_name' | 'moves_in_most_recent_company' | 'moves_in_previous_company' | 'msa' | 'msa_name' | 'most_recent_company' | 'most_recent_company_end_date' | 'most_recent_company_start_date' | 'naics2' | 'naics2_name' | 'naics3' | 'naics3_name' | 'naics4' | 'naics4_name' | 'naics5' | 'naics5_name' | 'naics6' | 'naics6_name' | 'onet' | 'onet_name' | 'previous_company' | 'previous_company_end_date' | 'previous_company_start_date' | 'schools' | 'schools_ipeds' | 'schools_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' | 'specialized_skills' | 'specialized_skills_name' | 'state' | 'state_name' | 'title' | 'title_name' | 'years_in_current_role' | 'years_with_most_recent_company' | 'years_with_previous_company' | 'years_of_experience' | 'years_of_experience_in_occupation' | 'revenue_bucket' | 'employee_count_range' required

Query parameters

area_version'us_area_2024_3' | 'us_area_2024_4'

Specify Area taxonomy version to use.

soc_version'soc_2021' | 'soc_emsi_2019'

Specify SOC taxonomy version to use.

title_version'emsi'

Specify Job Title taxonomy version to use.

cip_version'cip2010' | 'cip2020'

Specify CIP taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

onet_version'onet_2019' | 'onet_2010'

Specify ONET taxonomy version to use.

naics_version'naics_std_2022'

Specify NAICS taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

area_us_version'1.0.2' | '1.0.3'

Specify US Area taxonomy version to use.

soc_lightcast_version'2010.2019.0' | '2018.2021.0'

Specify SOC Lightcast taxonomy version to use.

onet_standard_version'2010.0.0' | '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": {
    "keywords": {
      "query": "workday AND \"payroll processing\""
    },
    "is_fortune100": true,
    "is_fortune500": true,
    "is_fortune1000": true
  }
}

Response

OK

Changes

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