--- title: "Get a ranking of a selected facet" method: POST path: "/rankings/{rankingFacet}" tags: ["Rankings"] --- # Get a ranking of a selected facet `POST /rankings/{rankingFacet}` ## Request - Base URL: `https://api.lightcast.io/alumni-pathways` - URL: `https://api.lightcast.io/alumni-pathways/rankings/{rankingFacet}` - Auth: OAuth 2 - Client credentials - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `alumni-pathways` Group and rank postings by {rankingFacet}. ## 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 ## Query parameters - `soc_version` 'soc_2021' - `onet_version` 'onet_2019' - `title_version` 'emsi' - `company_version` 'emsi_company' - `naics_version` 'naics_std_2022' - `new_taxonomy_versions` true | false - `area_version` 'us_area_2024_3' | 'us_area_2024_4' - `area_us_version` '1.0.2' | '1.0.3' - `soc_lightcast_version` '2018.2021.0' - `onet_standard_version` '2019.0.0' - `lot_version` '7' | '6' ## Request body - object - `filter` union, required: An object or a list of up to 10 objects. - object - `title` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `cip2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `cip2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `cip4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `cip4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `cip6` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above) For version see [/meta](#meta). - unknown[] - unknown - object - `cip6_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `city` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `city_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `company` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `company_v2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `company_is_staffing` boolean: Passing `false` filters out postings from companies that have been identified as staffing companies or recruiting agencies; `true` limits results to _only_ those from staffing or recruiting companies. By default both staffing and non-staffing companies are included in the results. - `company_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `company_name_v2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `contract_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `contract_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `county` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `county_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `employment_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `employment_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `fips` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `fips_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `is_fortune100` boolean: Job postings by Fortune 100 companies - `is_fortune1000` boolean: Job postings by Fortune 1000 companies - `is_fortune500` boolean: Job postings by Fortune 500 companies - `is_hwol` boolean: Job postings that are described as Help Wanted OnLine postions. - `is_internship` boolean: Job postings that are described as internship positions. - `is_supervisor` boolean: Job postings that are described as supervisor postions. - `job_seniority` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `job_seniority_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `keywords` object - `type` 'or' | 'and' | 'phrase' | 'expression': How the keyword(s) are matched in a job posting. * `or` - Match postings with any of the keywords. * `and` - Match postings with all the keywords. * `phrase` - Match postings with the keywords as a phrase. * `expression` - Match postings using a complex boolean expression; e.g. `"(uav OR drone) AND agriculture NOT surveillance"`. * Alternatively, you can prefix a word with `-` to exclude it; e.g. `"games Android -iOS"` would match postings that mention 'games' and 'Android' but exclude those that mention 'iOS'. - `query` string, required: Keyword(s) to match in the original title and body of the postings. - `lightcast_sectors` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `lightcast_sectors_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_admin_area_1` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_admin_area_1_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_admin_area_2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_admin_area_2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_country` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_country_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_metro` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `laa_metro_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `language` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `language_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `lot_career_area` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_career_area_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_occupation_group` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_occupation_group_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_specialized_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `lot_specialized_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `max_edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `max_edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `max_salary` object: This filter operates on the maximum advertised annual salary found in a job posting. Not all postings advertise salaries, when using this filter only postings with advertised salaries will be included in your results. - `lower_bound` integer - `upper_bound` integer - `max_years_experience` object: This filter operates on the advertised maximum years of experience found in a job posting. Not all postings advertise maximum years of experience, when using this filter only postings with a maximum years of experience will be included in your results. - `lower_bound` integer: Lower bound for the maximum years of experience required by a job posting (years are inclusive). - `upper_bound` integer: Upper bound for the maximum years of experience required by a job posting (years are inclusive). - `min_edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `min_edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `min_salary` object: This filter operates on the minimum advertised annual salary found in a job posting. Not all postings advertise salaries, when using this filter only postings with advertised salaries will be included in your results. - `lower_bound` integer - `upper_bound` integer - `min_years_experience` object: This filter operates on the advertised minimum years of experience found in a job posting. Not all postings advertise minimum years of experience, when using this filter only postings with a minimum years of experience will be included in your results. - `lower_bound` integer: Lower bound for the minimum years of experience required by a job posting (years are inclusive). - `upper_bound` integer: Upper bound for the minimum years of experience required by a job posting (years are inclusive). - `msa` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `msa_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `naics2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics3_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics5` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics5_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics6` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `naics6_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `onet` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `onet_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `posting_duration` object: This filter operates on the number of days a posting has been active. This filter differs from the 'posting_duration' metric in that it will take into account currently active posting durations, where the metric only calculates duration of expired postings. - `lower_bound` integer: Lower bound for the number of days a posting has been active for (days are inclusive). - `upper_bound` integer: Upper bound for the number of days a posting has been active for (days are inclusive). - `remote_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `remote_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `salary` object: This filter operates on the average advertised annual salary found in a job posting. Not all postings advertise salaries, when using this filter only postings with advertised salaries will be included in your results. - `lower_bound` integer - `upper_bound` integer - `skill_categories` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `skill_categories_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `skill_subcategories` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `skill_subcategories_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `skills` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `skills_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc3_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc5` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `soc5_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `sources` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - unknown[] - unknown - object - `state` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `state_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `title_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - unknown[] - unknown - object - `when` union, required: Job posting timeframe filter, can be the string `active` (except for the timeseries endpoints) to match all currently active postings, or a more granular timeframe `when` object detailed below. - string - object - `type` 'posted' | 'active' | 'expired': Determines how posting dates are evaluated. * `posted` - Match postings that were posted in your date range. * `active` - Match postings that were active within your date range. * `expired` - Match postings that expired in your date range.` - `end` string, required: The end of a date range, an ISO-8061 year-month or year-month-day date format. - `start` string, required: The start of a date range, an ISO-8061 year-month or year-month-day date format. - unknown[] - unknown - `rank` object, required - `by` 'unique_postings' | 'total_postings' | 'unique_companies' | 'significance': Some metrics may be approximations for performance reasons. - `limit` integer: Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits: * Nested rankings: `100` - `extra_metrics` string[]: In addition to 'by' metric, calculate these metrics for each ranked group. Some metrics may be approximations for performance reasons. - `min_unique_postings` integer: Require ranked items to have at least this many unique postings matching the filter. Default: `3` when ranking by `significance`. - `include` union[]: This field does not affect totals matched by the request query, it only filters the items returned in the ranking. - union - string - integer - `exclude` union[]: This field does not affect totals matched by the request query, it only filters the items returned in the ranking. - union - string - integer ## Response `200` OK - object - `data` object, required - `totals` object, required - `unique_postings` integer - `total_postings` integer - `unique_companies` integer - `median_posting_duration` integer, nullable - `median_salary` integer, nullable - `max_salary` integer, nullable - `min_salary` integer, nullable - `median_max_salary` integer, nullable - `average_salary` integer, nullable - `ranking` object, required - `facet` string, required - `rank_by` 'unique_postings' | 'significance' | 'total_postings' | 'unique_companies' | 'median_salary', required - `limit` integer, required - `buckets` object[], required - `name` union, required - string - integer - `unique_postings` integer - `total_postings` integer - `unique_companies` integer - `significance` number - `median_posting_duration` integer, nullable - `median_salary` integer, nullable - `min_salary` integer, nullable - `max_salary` integer, nullable - `median_max_salary` integer, nullable - `average_salary` integer, nullable ## Other responses - `400`: bad request - `401`: unauthorized request - `404`: requested resource not found - `422`: Your request wasn't valid (bad keyword expression). --- [API](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0.md) - [All operations](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0/revisions/fc66b9877391?raw)