v1
latestOpenAPI 3.1.02026-07-242892032.8 MBRankings
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
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