{"openapi":"3.1.0","info":{"title":"Job Postings - Company Direct","description":"This is an interface for retrieving job posting data that is filtered, sorted and ranked by various properties of the company postings.","version":"1.4.0"},"tags":[{"name":"Status"},{"name":"Meta"},{"name":"Totals"},{"name":"Timeseries"},{"name":"Rankings"},{"name":"Postings"},{"name":"Distributions"},{"name":"Taxonomies"}],"servers":[{"url":"https://api.lightcast.io/company-postings"}],"paths":{"/status":{"get":{"tags":["Status"],"summary":"Get the health of the service","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"message":"Service is healthy","healthy":true}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/status.schema.json","properties":{"data":{"type":"object","properties":{"message":{"type":"string","minLength":1},"healthy":{"type":"boolean"}},"required":["message","healthy"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}},"description":"Get the health of the service. Be sure to check the `healthy` attribute of the response, not just the status code. Caching not recommended.","operationId":"company_postings_get_status"}},"/meta":{"get":{"tags":["Meta"],"summary":"Get service metadata","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"attribution":{"body":"Job postings are collected directly from the career pages of the companies. The data is then processed/enriched to provide information such as standardized company name, occupation, skills, and geography.","title":"Lightcast Job Postings - Company Direct"},"available_months":["2012-01","2012-02","2012-03","2012-04","2012-05","2012-06","2012-07","2012-08","2012-09","2012-10","2012-11","2012-12","2013-01","2013-02","2013-03","2013-04","2013-05","2013-06","2013-07","2013-08","2013-09","2013-10","2013-11","2013-12","2014-01","2014-02","2014-03","2014-04","2014-05","2014-06","2014-07","2014-08","2014-09","2014-10","2014-11","2014-12","2015-01","2015-02","2015-03","2015-04","2015-05","2015-06","2015-07","2015-08","2015-09","2015-10","2015-11","2015-12","2016-01","2016-02","2016-03","2016-04","2016-05","2016-06","2016-07","2016-08","2016-09","2016-10","2016-11","2016-12","2017-01","2017-02","2017-03","2017-04","2017-05","2017-06","2017-07","2017-08","2017-09","2017-10","2017-11","2017-12","2018-01","2018-02","2018-03","2018-04","2018-05","2018-06","2018-07","2018-08","2018-09","2018-10","2018-11","2018-12","2019-01","2019-02","2019-03","2019-04","2019-05","2019-06","2019-07","2019-08","2019-09","2019-10","2019-11","2019-12","2020-01","2020-02","2020-03","2020-04","2020-05","2020-06","2020-07","2020-08","2020-09","2020-10","2020-11","2020-12","2021-01","2021-02","2021-03","2021-04","2021-05","2021-06","2021-07","2021-08","2021-09","2021-10","2021-11","2021-12","2022-01","2022-02","2022-03","2022-04","2022-05","2022-06","2022-07","2022-08","2022-09","2022-10","2022-11","2022-12","2023-01","2023-02","2023-03","2023-04","2023-05","2023-06","2023-07","2023-08","2023-09","2023-10","2023-11","2023-12","2024-01","2024-02","2024-03","2024-04","2024-05","2024-06","2024-07","2024-08","2024-09","2024-10","2024-11","2024-12","2025-01","2025-02","2025-03","2025-04","2025-05","2025-06","2025-07","2025-08","2025-09","2025-10","2025-11","2025-12","2026-01"],"distributionFacets":["max_years_experience","min_years_experience","posting_duration","salary"],"facets":["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","lightcast_sectors","lightcast_sectors_name","lot_career_area","lot_career_area_name","lot_occupation","lot_occupation_group","lot_occupation_group_name","lot_occupation_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"],"filters":["cip2","cip2_name","cip4","cip4_name","cip6","cip6_name","city","city_name","company","company_is_staffing","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","is_fortune100","is_fortune1000","is_fortune500","is_internship","is_supervisor","job_seniority","job_seniority_name","keywords","keywords.query","keywords.type","lightcast_sectors","lightcast_sectors_name","lot_career_area","lot_career_area_name","lot_occupation","lot_occupation_group","lot_occupation_group_name","lot_occupation_name","lot_specialized_occupation","lot_specialized_occupation_name","max_edulevels","max_edulevels_name","max_salary","max_salary.lower_bound","max_salary.upper_bound","max_years_experience","max_years_experience.lower_bound","max_years_experience.upper_bound","min_edulevels","min_edulevels_name","min_salary","min_salary.lower_bound","min_salary.upper_bound","min_years_experience","min_years_experience.lower_bound","min_years_experience.upper_bound","msa","msa_name","naics2","naics2_name","naics3","naics3_name","naics4","naics4_name","naics5","naics5_name","naics6","naics6_name","onet","onet_name","posting_duration","posting_duration.lower_bound","posting_duration.upper_bound","remote_type","remote_type_name","salary","salary.lower_bound","salary.upper_bound","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","sources","state","state_name","title","title_name","when","when.end","when.start","when.type"],"latest_day":"2026-02-03","metrics":["average_salary","max_salary","median_max_salary","median_posting_duration","median_salary","min_salary","significance","total_postings","unique_companies","unique_postings"],"pipelineVersion":"2026-01","postingFields":["body","cip2","cip2_name","cip4","cip4_name","cip6","cip6_name","city","city_name","company","company_is_staffing","company_name","company_name_v2","company_raw","company_v2","contract_type","contract_type_name","county","county_name","duration","edulevels","edulevels_name","employment_type","employment_type_name","expired","id","is_fortune100","is_fortune1000","is_fortune500","is_internship","is_supervisor","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","location","lot_career_area","lot_career_area_name","lot_occupation","lot_occupation_group","lot_occupation_group_name","lot_occupation_name","lot_specialized_occupation","lot_specialized_occupation_name","max_edulevels","max_edulevels_name","max_salary","max_years_experience","min_edulevels","min_edulevels_name","min_salary","min_years_experience","msa","msa_name","naics2","naics2_name","naics3","naics3_name","naics4","naics4_name","naics5","naics5_name","naics6","naics6_name","onet","onet_name","posted","remote_type","remote_type_name","salary","score","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","sources","state","state_name","title","title_name","title_raw","url"],"supportsAdvancedFilters":true,"taxonomies":{"area":"us_area_2024_4","cip":"cip2020","company":"acme_v2.87.0","lot":"7","naics":"naics_std_2022","onet":"onet26_emsi","skills":"skillsv9.39","soc":"soc_2021","title":"emsi_title_v5.53"},"taxonomy_versions":{"area":["us_area_2024_4","us_area_2024_3"],"company":["emsi_company"],"lot":["7","6"],"naics":["naics_std_2022"],"onet":["onet_2019","onet_2010"],"soc":["soc_2021","soc_emsi_2019"],"title":["emsi"]}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/meta.schema.json","properties":{"data":{"type":"object","properties":{"available_months":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":2},"attribution":{"type":"object","properties":{"title":{"type":"string","minLength":1},"body":{"type":"string","minLength":1}},"required":["title","body"],"additionalProperties":false},"facets":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9_]+?$"},"minItems":1},"filters":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"postingFields":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"latest_day":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"metrics":{"type":"array","items":{"type":"string","pattern":"^[a-z_]+$"},"minItems":1},"supportsAdvancedFilters":{"type":"boolean"},"taxonomies":{"type":"object","properties":{"area":{"type":"string","minLength":1},"naics":{"type":"string","minLength":1},"soc":{"type":"string","minLength":1},"cip":{"type":"string","minLength":1},"onet":{"type":"string","minLength":1},"skills":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"company":{"type":"string","minLength":1},"lot":{"type":"string","minLength":1},"area_us":{"type":"string","minLength":1},"cip_standard":{"type":"string","minLength":1},"companies":{"type":"string","minLength":1},"naics_standard":{"type":"string","minLength":1},"onet_standard":{"type":"string","minLength":1},"soc_lightcast":{"type":"string","minLength":1},"titles":{"type":"string","minLength":1}},"required":["skills","lot"],"additionalProperties":false},"taxonomy_versions":{"type":"object","properties":{"area":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"area_us":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"soc":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"onet":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"title":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"titles":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"company":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"companies":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"naics":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"naics_standard":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"onet_standard":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"soc_lightcast":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"lot":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":[],"additionalProperties":false},"distributionFacets":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"pipelineVersion":{"type":"string","minLength":0}},"required":["available_months","attribution","latest_day","facets","filters","metrics","postingFields","supportsAdvancedFilters","taxonomies","taxonomy_versions","distributionFacets","pipelineVersion"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"}},"description":"Get service metadata, including taxonomies, available months of data, facets, metrics, and attribution text. Caching is encouraged, but the metadata does change monthly.","operationId":"company_postings_get_meta","parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"}]}},"/totals":{"post":{"tags":["Totals"],"summary":"Get total postings","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"totals":{"median_salary":57024,"unique_postings":46990}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/totals.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false}},"required":["totals"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"422":{"$ref":"#/components/responses/422"}},"operationId":"company_postings_post_totals","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2020-01","end":"2020-12"},"state_name":["Idaho"],"skills_name":["Sales"]},"metrics":["median_salary","unique_postings"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/totals.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"metrics":{"title":"Metrics to include in the summary","description":"Some metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","max_salary","median_max_salary","average_salary"]},"minItems":1}},"required":["filter"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"}]}},"/timeseries":{"post":{"tags":["Timeseries"],"summary":"Get total postings over time","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"timeseries":{"month":["2020-01","2020-02","2020-03","2020-04","2020-05","2020-06","2020-07","2020-08","2020-09","2020-10","2020-11","2020-12"],"unique_postings":[300,207,171,127,167,186,225,279,259,202,162,179]},"totals":{"unique_postings":965}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/timeseries.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"timeseries":{"type":"object","properties":{"day":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"minItems":1},"week":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"minItems":1},"month":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"quarter":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"year":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"unique_postings":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"total_postings":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"unique_companies":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"median_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"max_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"min_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"median_max_salary":{"__internal":true,"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"average_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1}},"additionalProperties":false}},"required":["totals","timeseries"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"422":{"$ref":"#/components/responses/422"}},"operationId":"company_postings_post_timeseries","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2022-01","end":"2022-12"},"city_name":["Irvine, CA"],"company_name":["Activision Blizzard"]},"metrics":["unique_postings"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/timeseries.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"metrics":{"title":"Metrics to calculate per month or day","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"interval":{"title":"The interval of the timeseries","type":"string","enum":["day","week","month","quarter","year"]}},"required":["filter"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"}]}},"/rankings":{"get":{"tags":["Rankings"],"summary":"Get a list of current available ranking facets.","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":["certifications","certifications_name","city","city_name","cip2","cip2_name","cip4","cip4_name","cip6","cip6_name","company","company_name","county","county_name","edulevels","edulevels_name","employment_type","employment_type_name","fips","fips_name","specialized_skills","specialized_skills_name","common_skills","common_skills_name","max_years_experience","min_years_experience","msa","msa_name","naics2","naics2_name","naics3","naics3_name","naics4","naics4_name","naics5","naics5_name","naics6","naics6_name","onet","onet_name","skills","skills_name","soc2","soc2_name","soc3","soc3_name","soc4","soc4_name","soc5","soc5_name","sources","source_types","state","state_name","title","title_name","remote_type","remote_type_name","min_edulevels","min_edulevels_name","max_edulevels","max_edulevels_name","job_seniority","job_seniority_name"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/ranking-facets.schema.json","properties":{"data":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["data"],"additionalProperties":false}}}}},"operationId":"company_postings_get_rankings"}},"/rankings/{rankingFacet}":{"post":{"tags":["Rankings"],"summary":"Get a ranking of a selected facet","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ranking":{"buckets":[{"name":"Geisinger Inc","unique_postings":722},{"name":"Community Health Systems, Inc.","unique_postings":590},{"name":"Army National Guard","unique_postings":320},{"name":"Soliant Health, Inc","unique_postings":263},{"name":"Allied Services, L.L.C.","unique_postings":202}],"facet":"company_name","limit":5,"rank_by":"unique_postings"},"totals":{"unique_postings":20023}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/ranking.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"ranking":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"rank_by":{"type":"string","enum":["unique_postings","significance","total_postings","unique_companies","median_salary"]},"limit":{"type":"integer","minimum":0},"buckets":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","minLength":1},{"type":"integer","minimum":0}]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"significance":{"type":"number"},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"required":["name"],"additionalProperties":false}}},"required":["facet","rank_by","limit","buckets"],"additionalProperties":false}},"required":["totals","ranking"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"}},"description":"Group and rank postings by {rankingFacet}.","operationId":"company_postings_post_rankings_facet","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2020-01","end":"2020-12"},"city_name":["Scranton, PA"]},"rank":{"by":"unique_postings","limit":5}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/ranking.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"rank":{"title":"Choose how to rank your results","type":"object","properties":{"by":{"title":"What metric to use to rank the ranking facet","description":"Some metrics may be approximations for performance reasons.","default":"unique_postings","type":"string","enum":["unique_postings","total_postings","unique_companies","significance"]},"limit":{"title":"Limit the number of ranked items returned","description":"Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits:\n* Nested rankings: `100`","default":10,"type":"integer","minimum":0,"maximum":1000},"extra_metrics":{"title":"Request additional metrics for each ranked group returned","description":"In addition to 'by' metric, calculate these metrics for each ranked group. \n\nSome metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"min_unique_postings":{"title":"Filter ranked items by number of unique postings for the item","description":"Require ranked items to have at least this many unique postings matching the filter.\nDefault: `3` when ranking by `significance`.","default":1,"type":"integer","minimum":1},"include":{"title":"Filter ranked items to only those provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1},"exclude":{"title":"Filter ranked items to only those not provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1}},"additionalProperties":false}},"required":["filter","rank"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/rankingFacet"}]}},"/rankings/{rankingFacet}/timeseries":{"post":{"tags":["Rankings"],"summary":"Get a ranking of a selected facet with timeseries data","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ranking":{"buckets":[{"name":"Geisinger Inc","timeseries":{"day":["2020-01-15","2020-01-16","2020-01-17","2020-01-18","2020-01-19","2020-01-20"],"unique_postings":[189,190,196,196,201,200]},"unique_postings":722},{"name":"Community Health Systems, Inc.","timeseries":{"day":["2020-01-15","2020-01-16","2020-01-17","2020-01-18","2020-01-19","2020-01-20"],"unique_postings":[139,137,138,142,143,143]},"unique_postings":590},{"name":"Army National Guard","timeseries":{"day":["2020-01-15","2020-01-16","2020-01-17","2020-01-18","2020-01-19","2020-01-20"],"unique_postings":[84,85,85,85,86,85]},"unique_postings":320},{"name":"Soliant Health, Inc","timeseries":{"day":["2020-01-15","2020-01-16","2020-01-17","2020-01-18","2020-01-19","2020-01-20"],"unique_postings":[46,44,44,46,46,46]},"unique_postings":263},{"name":"Allied Services, L.L.C.","timeseries":{"day":["2020-01-15","2020-01-16","2020-01-17","2020-01-18","2020-01-19","2020-01-20"],"unique_postings":[76,77,78,78,78,78]},"unique_postings":202}],"facet":"company_name","limit":5,"rank_by":"unique_postings"},"totals":{"unique_postings":20023}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/ranking-timeseries.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"ranking":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"rank_by":{"type":"string","enum":["unique_postings","significance","total_postings","unique_companies","median_salary"]},"limit":{"type":"integer","minimum":0},"buckets":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","minLength":1},{"type":"integer","minimum":0}]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"significance":{"type":"number"},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"timeseries":{"type":"object","properties":{"day":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"minItems":1},"week":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"minItems":1},"month":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"quarter":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"year":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"minItems":1},"unique_postings":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"total_postings":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"unique_companies":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1},"median_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"max_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"min_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"median_max_salary":{"__internal":true,"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1},"average_salary":{"type":"array","items":{"type":["integer","null"],"minimum":0},"minItems":1}},"additionalProperties":false}},"required":["name","timeseries"],"additionalProperties":false}}},"required":["facet","rank_by","limit","buckets"],"additionalProperties":false}},"required":["totals","ranking"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"}},"description":"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.","operationId":"company_postings_post_rankings-timeseries","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2020-01","end":"2020-12"},"city_name":["Scranton, PA"]},"rank":{"by":"unique_postings","limit":5},"timeseries":{"when":{"start":"2020-01-15","end":"2020-01-20"},"metrics":["unique_postings"]}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/ranking-timeseries.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"revenue_bucket":{"title":"Filter by revenue bucket","description":"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).","example":["5001-10000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"rank":{"title":"Choose how to rank your results","type":"object","properties":{"by":{"title":"What metric to use to rank the ranking facet","description":"Some metrics may be approximations for performance reasons.","default":"unique_postings","type":"string","enum":["unique_postings","total_postings","unique_companies","significance"]},"limit":{"title":"Limit the number of ranked items returned","description":"Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits:\n* Nested rankings: `100`","default":10,"type":"integer","minimum":0,"maximum":1000},"extra_metrics":{"title":"Request additional metrics for each ranked group returned","description":"In addition to 'by' metric, calculate these metrics for each ranked group. \n\nSome metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"min_unique_postings":{"title":"Filter ranked items by number of unique postings for the item","description":"Require ranked items to have at least this many unique postings matching the filter.\nDefault: `3` when ranking by `significance`.","default":1,"type":"integer","minimum":1},"include":{"title":"Filter ranked items to only those provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1},"exclude":{"title":"Filter ranked items to only those not provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1}},"additionalProperties":false},"timeseries":{"type":"object","properties":{"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]},"metrics":{"title":"Metrics to calculate per month or day","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"interval":{"title":"The interval of the timeseries","type":"string","enum":["day","week","month","quarter","year"]}},"additionalProperties":false}},"required":["filter","rank","timeseries"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/rankingFacet"}]}},"/rankings/{rankingFacet}/distributions/{distributionFacet}":{"post":{"tags":["Rankings"],"summary":"Get a ranking of a selected facet with distribution data","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ranking":{"buckets":[{"distribution":{"buckets":[{"key":1,"value":0},{"key":2,"value":100000},{"key":3,"value":200000},{"key":4,"value":300000},{"key":5,"value":400000},{"key":6,"value":500000}],"domain":{"max":500000,"min":15100},"facet":"salary","interval":100000,"type":"histogram"},"name":"Unclassified","unique_postings":18621508},{"distribution":{"buckets":[{"key":1,"value":0},{"key":2,"value":100000},{"key":3,"value":200000},{"key":4,"value":300000},{"key":5,"value":400000},{"key":6,"value":500000}],"domain":{"max":500000,"min":17680},"facet":"salary","interval":100000,"type":"histogram"},"name":"Amazon","unique_postings":1257477}],"facet":"company_name","limit":2,"rank_by":"unique_postings"},"totals":{"unique_postings":163400492}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/ranking-distribution.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"ranking":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"rank_by":{"type":"string","enum":["unique_postings","significance","total_postings","unique_companies","median_salary"]},"limit":{"type":"integer","minimum":0},"buckets":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","minLength":1},{"type":"integer","minimum":0}]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"significance":{"type":"number"},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"distribution":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"interval":{"type":["null","number"],"minimum":0},"type":{"type":"string","enum":["histogram","percentile"]},"domain":{"type":"object","properties":{"min":{"type":["null","integer"],"minimum":0},"max":{"type":["null","integer"],"minimum":1}},"required":["min","max"],"additionalProperties":false},"buckets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"integer","minimum":0},"value":{"type":["null","integer"]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"required":["key","value"],"additionalProperties":false}}},"required":["facet","interval","type","domain","buckets"],"additionalProperties":false}},"required":["name","distribution"],"additionalProperties":false}}},"required":["facet","rank_by","limit","buckets"],"additionalProperties":false}},"required":["totals","ranking"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"}},"description":"Group and rank postings by {ranking_facet} with a distribution for each ranked item.","operationId":"company_postings_post_rankings_distributions","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2025-01","end":"2025-12"}},"rank":{"by":"unique_postings","limit":2},"distribution":{"type":"histogram","options":{"interval":50000,"domain":{"min":0,"max":500000}},"metrics":["unique_postings"]}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/ranking-distributions.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"rank":{"title":"Choose how to rank your results","type":"object","properties":{"by":{"title":"What metric to use to rank the ranking facet","description":"Some metrics may be approximations for performance reasons.","default":"unique_postings","type":"string","enum":["unique_postings","total_postings","unique_companies","significance"]},"limit":{"title":"Limit the number of ranked items returned","description":"Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits:\n* Nested rankings: `100`","default":10,"type":"integer","minimum":0,"maximum":1000},"extra_metrics":{"title":"Request additional metrics for each ranked group returned","description":"In addition to 'by' metric, calculate these metrics for each ranked group. \n\nSome metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"min_unique_postings":{"title":"Filter ranked items by number of unique postings for the item","description":"Require ranked items to have at least this many unique postings matching the filter.\nDefault: `3` when ranking by `significance`.","default":1,"type":"integer","minimum":1},"include":{"title":"Filter ranked items to only those provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1},"exclude":{"title":"Filter ranked items to only those not provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1}},"additionalProperties":false},"distribution":{"title":"Data distributions by percentiles or fixed interval","type":"object","properties":{"type":{"title":"Choose your distribution type","type":"string","enum":["histogram","percentile"]},"options":{"title":"Select distribution settings","description":"`keys` is required for percentile, `interval` is required for histogram.","type":"object","properties":{"keys":{"title":"Distribution percentiles","description":"Only valid for `percentile` type distribution.","type":"array","uniqueItems":true,"minItems":1},"interval":{"title":"Distribution interval","description":"Only valid for `histogram` type distribution.","type":"integer","minimum":1},"domain":{"title":"Select minimum and maximum values for the data range","description":"Only valid for `histogram` type distribution.","type":"object","properties":{"min":{"title":"Enforced minimum value of the distribution","type":"integer","minimum":0},"max":{"title":"Enforced maximum value of the distribution","type":"integer","minimum":1}},"required":["min","max"],"additionalProperties":false}},"additionalProperties":false},"metrics":{"title":"Request additional metrics","description":"Some metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1}},"required":["type","options"],"additionalProperties":false}},"required":["filter","rank","distribution"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/distributionFacet"},{"$ref":"#/components/parameters/rankingFacet"}]}},"/rankings/{rankingFacet}/rankings/{nestedRankingFacet}":{"post":{"tags":["Rankings"],"summary":"Get a nested ranking of two selected facets","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ranking":{"buckets":[{"name":"Geisinger Inc","ranking":{"buckets":[{"name":"Specialty Clinic Licensed Practical Nurses","significance":151.9881157958914,"unique_postings":5},{"name":"Evaluation Assistants","significance":125.88211732387495,"unique_postings":4},{"name":"Licensed Registered Nurses","significance":98.38387034949157,"unique_postings":8},{"name":"Medical Surgical Oncology Registered Nurses","significance":94.84830283499103,"unique_postings":10},{"name":"Operating Room Aides","significance":94.40743286825246,"unique_postings":6}],"facet":"title_name","limit":5,"rank_by":"significance"},"unique_postings":722},{"name":"Community Health Systems, Inc.","ranking":{"buckets":[{"name":"Nurse Extenders","significance":233.672283347697,"unique_postings":7},{"name":"Courtesy Drivers","significance":133.5236292253184,"unique_postings":6},{"name":"Behavioral Health Workers","significance":115.87300679197276,"unique_postings":9},{"name":"Medical Services Representatives","significance":114.45415192678624,"unique_postings":2},{"name":"Event Sales Planners","significance":66.76520444316768,"unique_postings":1}],"facet":"title_name","limit":5,"rank_by":"significance"},"unique_postings":590},{"name":"Army National Guard","ranking":{"buckets":[{"name":"Geospatial Engineers","significance":236.71707954494437,"unique_postings":11},{"name":"Track Vehicle Repairers","significance":215.64496055403308,"unique_postings":11},{"name":"Multi-Channel Transmission Systems Operators/Maintainers","significance":151.28722439236114,"unique_postings":8},{"name":"Fire Support Specialists","significance":148.92609588623046,"unique_postings":7},{"name":"Air Defense Battle Management System Operators","significance":94.2697801983173,"unique_postings":3}],"facet":"title_name","limit":5,"rank_by":"significance"},"unique_postings":320},{"name":"Soliant Health, Inc","ranking":{"buckets":[{"name":"Gifted Education Teachers","significance":697.8579777290183,"unique_postings":3},{"name":"Preschool Speech Language Pathologists","significance":226.79614314215908,"unique_postings":3},{"name":"Coverage Specialists","significance":201.6029088175339,"unique_postings":1},{"name":"Special Education Specialists","significance":174.45593929917473,"unique_postings":3},{"name":"Paraprofessionals/Teaching Assistants","significance":168.0017903010501,"unique_postings":1}],"facet":"title_name","limit":5,"rank_by":"significance"},"unique_postings":263},{"name":"Allied Services, L.L.C.","ranking":{"buckets":[{"name":"Transitional Interns","significance":3417.5311734143716,"unique_postings":2},{"name":"Assistant Directors of Health Information Management","significance":1708.7655867071858,"unique_postings":1},{"name":"Residence Assistants","significance":1708.7655867071858,"unique_postings":1},{"name":"Skilled Nursing Registered Nurses","significance":798.1785612831718,"unique_postings":16},{"name":"Allied Physical Therapists","significance":759.4436710997832,"unique_postings":2}],"facet":"title_name","limit":5,"rank_by":"significance"},"unique_postings":202}],"facet":"company_name","limit":5,"rank_by":"unique_postings"},"totals":{"unique_postings":20023}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/nested-ranking.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"ranking":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"rank_by":{"type":"string","enum":["unique_postings","significance","total_postings","unique_companies","median_salary"]},"limit":{"type":"integer","minimum":0},"buckets":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","minLength":1},{"type":"integer","minimum":0}]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"significance":{"type":"number"},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"ranking":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"rank_by":{"type":"string","enum":["unique_postings","significance","total_postings","unique_companies","median_salary"]},"limit":{"type":"integer","minimum":0},"buckets":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","minLength":1},{"type":"integer","minimum":0}]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"significance":{"type":"number"},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"required":["name"],"additionalProperties":false}}},"required":["facet","rank_by","limit","buckets"]}},"required":["name","ranking"],"additionalProperties":false}}},"required":["facet","rank_by","limit","buckets"],"additionalProperties":false}},"required":["totals","ranking"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"}},"description":"Get a nested ranking (e.g. top companies, then top skills per company).","operationId":"company_postings_post_nested_ranking","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2020-01","end":"2020-12"},"city_name":["Scranton, PA"]},"rank":{"by":"unique_postings","limit":5},"nested_rank":{"by":"significance","min_unique_postings":1,"limit":5}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/nested-ranking.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"rank":{"title":"Choose how to rank your results","type":"object","properties":{"by":{"title":"What metric to use to rank the ranking facet","description":"Some metrics may be approximations for performance reasons.","default":"unique_postings","type":"string","enum":["unique_postings","total_postings","unique_companies","significance"]},"limit":{"title":"Limit the number of ranked items returned","description":"Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits:\n* Nested rankings: `100`","default":10,"type":"integer","minimum":0,"maximum":1000},"extra_metrics":{"title":"Request additional metrics for each ranked group returned","description":"In addition to 'by' metric, calculate these metrics for each ranked group. \n\nSome metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"min_unique_postings":{"title":"Filter ranked items by number of unique postings for the item","description":"Require ranked items to have at least this many unique postings matching the filter.\nDefault: `3` when ranking by `significance`.","default":1,"type":"integer","minimum":1},"include":{"title":"Filter ranked items to only those provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1},"exclude":{"title":"Filter ranked items to only those not provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1}},"additionalProperties":false},"nested_rank":{"title":"Choose how to rank your results","type":"object","properties":{"by":{"title":"What metric to use to rank the ranking facet","description":"Some metrics may be approximations for performance reasons.","default":"unique_postings","type":"string","enum":["unique_postings","total_postings","unique_companies","significance"]},"limit":{"title":"Limit the number of ranked items returned","description":"Unlimited rankings (passing a maximum of `0`) are not valid for skills, and certifications facets. Additional maximum limits:\n* Nested rankings: `100`","default":10,"type":"integer","minimum":0,"maximum":1000},"extra_metrics":{"title":"Request additional metrics for each ranked group returned","description":"In addition to 'by' metric, calculate these metrics for each ranked group. \n\nSome metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1},"min_unique_postings":{"title":"Filter ranked items by number of unique postings for the item","description":"Require ranked items to have at least this many unique postings matching the filter.\nDefault: `3` when ranking by `significance`.","default":1,"type":"integer","minimum":1},"include":{"title":"Filter ranked items to only those provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1},"exclude":{"title":"Filter ranked items to only those not provided in this field","description":"This field does not affect totals matched by the request query, it only filters the items returned in the ranking.","type":"array","items":{"type":["string","integer"],"minLength":1},"minItems":1}},"additionalProperties":false}},"required":["filter","rank","nested_rank"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/rankingFacet"},{"$ref":"#/components/parameters/nestedRankingFacet"}]}},"/postings":{"post":{"tags":["Postings"],"summary":"Get individual postings that match your requested filters","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"limit":5,"page":1,"pages_available":2,"postings":[{"body":"<!--id: bc143b36b07b49c9b6e02895ba1e489e--> Data Analyst 2020-01-22T08:03:51Z Harvard University Credit Union Responsibilities include: <ul><li> Write, maintain and support a variety of lists and reports utilizing appropriate reporting tools. </li><li> Acquire data from primary or secondary data sources and maintain databases/data systems. </li><li> Assist in the creation of member segmentation tools and targeted marketing lists. </li><li> Assist in ongoing market research efforts and development of new research tools. </li><li> Enhance and maintain data collection processes to optimize statistical efficiency and data quality. </li><li> Work with Retail and Operational staff to ensure consistency and accuracy of data collection. </li><li> Audit data from various systems to ensure data is collected appropriately and maintain data integrity. </li><li> Identify and analyze trends or patterns in complex data sets. </li><li> Provide ongoing tracking of key metrics. </li><li> Share findings through effective reporting of data output to various stakeholders throughout the organization. </li><li> Other duties as assigned.</li></ul> <h5>Please note:</h5> Harvard University requires a pre-employment reference and background screening, which includes OFAC (Office of Foreign Assets Control) check . <ul><li> Harvard University is unable to provide work authorization and/or visa sponsorship. </li><li> This position has a 90-day orientation and review period.</li></ul> Harvard University Employees Credit Union website : https://www.huecu.org/ The Harvard University Employees Credit Union (HUECU) is one of the fastest growing Credit Unions in the country and a leader in our industry. As a not-for-profit cooperative, we put our members' best interests first in all that we do. We are passionate about service and fanatical about solving problems. Integrity and transparency are the foundation of HUECU's philosophy. Our mission is to enhance our members' lives by developing and offering trustworthy products that are easy to understand, easy to use and best suited to meet their financial needs. HUECU has a dynamic small-business atmosphere where every member of the team has a significant impact on our success. Our headquarters and flagship branch are located in the heart of Harvard Square, surrounded by shops, restaurants, and the vibrant University community. HUECU staff are employed by Harvard University and enjoy competitive salaries and a robust benefits package. We're looking for talented, member-centric stars to join our growing team. If you have energy, enthusiasm, and thrive in a fast-paced environment, you should check out the career opportunities with HUECU. Harvard University offers an outstanding benefits package including, but not limited to: <h5>Time Off:</h5> 3 - 4 weeks paid vacation, a paid winter recess break, 12 paid sick days, 11.5 paid holidays, and 3 paid personal days per year. <h5>Medical/Dental/Vision plans:</h5> We offer a variety of excellent medical plans, dental &amp; vision plans, all coverage begins as of your start date. <h5>Retirement:</h5> University-funded retirement plan with full vesting after 3 years of service. <h5>Tuition Assistance Programs:</h5> Competitive tuition assistance program, $40 per class at the Harvard Extension School and discounted options through participating Harvard grad schools. <h5>Transportation:</h5> Harvard offers a 50% subsidized MBTA pass as well as additional options to assist employees in their daily commute. Wellness options : Harvard offers programs and classes at little or no cost, including stress management, massages, nutrition, meditation and complimentary health services. Harvard access to athletic facilities, libraries, campus events and many discounts throughout the metro Boston area. For more information on Total Rewards at Harvard visit: https://hr.harvard.edu/totalrewards <h5>Salary Grade:</h5> 053 <h5>Union:</h5> 55 - Hvd Union Cler &amp; Tech Workers <ul><li> High School Diploma </li><li> A minimum of one year of professional related experience, preferably within a financial services industry. </li><li> Bachelor's Degree preferred. Major in Mathematics, Statistics or related field strongly preferred. </li><li> Strong ability to work with numbers </li><li> Analytical mind, able to process information logically </li><li> Advanced computer software knowledge, particularly MS Excel, and high level of comfort learning new software </li><li> Highly organized with a meticulous attention to detail </li><li> Ability to work independently with minimal supervision. </li><li> Ability to work collaboratively with cross-functional teams </li></ul><h5>EQUAL OPPORTUNITY EMPLOYER</h5> We are an equal opportunity employer and all qualified applicants will receive consideration for employment without regard to race, color, religion, sex, national origin, disability status, protected veteran status, or any other characteristic protected by law.","city_name":"Boston, MA","company_name":"Harvard University","expired":"2020-01-26","id":"bc143b36b07b49c9b6e02895ba1e489e","posted":"2020-01-22","score":0,"title_raw":"Data Analyst","url":[]},{"body":"<!--id: a89e44c28b0944569954c3b6a0f429b7--> Strategic Partnerships Manager, Venture Capital/Private Equity Boston, MA 4.0 1 hour ago Full-time Quick Apply Skills Private Equity Business Development Investment Banking Negotiation InsightSquared is the leading sales and marketing analytics provider for growing companies that want to run their business by the numbers. We help our customers make better decisions by equipping them with actionable, real-time intelligence that drives predictable growth. We're funded by a great team of investors including Accomplice, Tola Capital, DFJ, Bessemer, and Salesforce.com. We were named a leader in the G2 Crowd's Business Intelligence Platform GridSM, ranking #1 in customer satisfaction for the fourth year in a row. We are a four-time winner of both The Boston Business Journal's \"Best Places to Work\" and The Boston Globe's \"Top Places to Work.\" As Strategic Partnerships Manager, Venture Capital/Private Equity you will be a key member of our go-to-market organization tasked with maintaining and expanding our base of Private Equity and Venture Capital partnerships. You will report into the Head of BD, Alliances &amp; Investor Partnerships and assist in targeting new partnership opportunities and maintain existing ones by managing relationships with Investors and Operating Partners at PE/VC firms with the aim of expanding InsightSquared's footprint within their portfolios. <h5>Responsibilities:</h5> Assist in the targeting of new PE/VC partner prospects, the negotiation of new partnerships, and the development of commercial agreements Work with new partners to develop launch strategy for new partnerships Assist in overseeing the health of existing PE/VC partner channel and manage partner performance by leading QBRs with delivery of quarterly reporting highlighting key metrics such as progress toward goals, portfolio penetration &amp; pipeline reviews Maintain active relationships with PE/VC firms to ensure continued engagement and maximization of new business lead flow for InsightSquared's sales team Work with PE/VC Partners to develop a best practices framework aligned with PE/VC Partner's value creation initiatives for portfolio company customers Collaborate internally with the Services team to oversee the development of new partner offerings (i.e. use-case expansion to support due-diligence, cross-portfolio dashboards, standardized board reports, etc.) Identify areas of success and opportunity for each partner, develop strategies to fuel future growth and optimize results of each partnership Sales enablement - develop presentations and other selling tools in partnership with Marketing (white papers, case studies, ROI calculators, etc.) which articulate the value of InsightSquared to PE/VC Partners and portfolio companies Lead the development of sales strategy and process to leverage master agreements and coach sales reps through full-cycle channel sales engagements. Collaborate with Customer Success, Support, &amp; Services teams to drive adoption and ensure success of portfolio company customers Advocate for partner demand and needs internally. Develop and effectively manage internal relationships necessary to reach mutually beneficial objectives and the cross-functional commitments to achieve them <h5>Qualifications:</h5> 2-5 years experience in partner management, sales, marketing or business development Prior experience with a strategy consulting firm, investment banking, private equity, or venture capital is a plus Demonstrated presentation, negotiation and persuasion skills Ability to lead and influence cross-functional teams InsightSquared is the leading sales and marketing analytics provider for growing companies that want to run their business by the numbers. We help our customers make better decisions by equipping them with actionable, real-time intelligence that drives predictable growth. We're funded by a great team of investors including Accomplice, Tola Capital, DFJ, Bessemer, and Salesforce.com. We were named a leader in the G2 Crowd's Business Intelligence Platform GridSM, ranking #1 in customer satisfaction for the fourth year in a row. We are a four-time winner of both The Boston Business Journal's \"Best Places to Work\" and The Boston Globe's \"Top Places to Work.\" As Strategic Partnerships Manager, Venture Capital/Private Equity you will be a key member of our go-to-market organization tasked with maintaining and expanding our base of Private Equity and Venture Capital partnerships. You will report into the Head of BD, Alliances &amp; Investor Partnerships and assist in targeting new partnership opportunities and maintain existing ones by managing relationships with Investors and Operating Partners at PE/VC firms with the aim of expanding InsightSquared's footprint within their portfolios. <h5>Responsibilities:</h5> Assist in the targeting of new PE/VC partner prospects, the negotiation of new partnerships, and the development of commercial agreements Work with new partners to develop launch strategy for new partnerships Assist in overseeing the health of existing PE/VC partner channel and manage partner performance by leading QBRs with delivery of quarterly reporting highlighting key metrics such as progress toward goals, portfolio penetration &amp; pipeline reviews Maintain active relationships with PE/VC firms to ensure continued engagement and maximization of new business lead flow for InsightSquared's sales team Work with PE/VC Partners to develop a best practices framework aligned with PE/VC Partner's value creation initiatives for portfolio company customers Collaborate internally with the Services team to oversee the development of new partner offerings (i.e. use-case expansion to support due-diligence, cross-portfolio dashboards, standardized board reports, etc.) Identify areas of success and opportunity for each partner, develop strategies to fuel future growth and optimize results of each partnership Sales enablement - develop presentations and other selling tools in partnership with Marketing (white papers, case studies, ROI calculators, etc.) which articulate the value of InsightSquared to PE/VC Partners and portfolio companies Lead the development of sales strategy and process to leverage master agreements and coach sales reps through full-cycle channel sales engagements. Collaborate with Customer Success, Support, &amp; Services teams to drive adoption and ensure success of portfolio company customers Advocate for partner demand and needs internally. Develop and effectively manage internal relationships necessary to reach mutually beneficial objectives and the cross-functional commitments to achieve them <h5>Qualifications:</h5> 2-5 years experience in partner management, sales, marketing or business development Prior experience with a strategy consulting firm, investment banking, private equity, or venture capital is a plus Demonstrated presentation, negotiation and persuasion skills Ability to lead and influence cross-functional teams Quick Apply • ID#: 768266835 • <h5>Location:</h5> Boston, MA • <h5>Type:</h5> Other • <h5>Company:</h5> InsightSquared","city_name":"Boston, MA","company_name":"Insightsquared, Inc","expired":"2020-03-18","id":"a89e44c28b0944569954c3b6a0f429b7","posted":"2020-01-28","score":0,"title_raw":"Strategic Partnerships Manager, Venture Capital/Private Equity","url":[]},{"body":"<!--id: cda7a43ccdee44ada42704bf3b07f154--> Register Job Search Login FAQs Register Employer FAQs Login Apply for Jobs Apply for Jobs Post a Job Post a Job Local Jobs Home Register Here to Apply for Jobs or Post Jobs. X General Manager Job in Boston - MA Massachusetts - <h5>USA Apply Here Company:</h5> Related Full Time position Listed on 2020-08-26 Job specializations: <ul><li> Management Property Management </li><li> Real Estate/Property Property Management Job Description &amp; How to Apply Below Learn more about Related's innovated culture /434468879 </li></ul><h5>Role Summary:</h5> The Multi Property General Manager is responsible for leading all phases of operation of a three (3) residential buildings including, but not limited to, direct supervision and development of the onsite management team, financial performance to budget and accountability for the sales, resident relations and maintenance functions. This position ensures that Company standards are maintained across Related Rentals. The position provides inspirational leadership, successfully promotes Company values, and creates an environment of exceptional customer service for residents, prospects, and vendors. <ul><li> Understands and manages capital and expense budgets, including reporting to senior staff and stakeholder representatives. </li><li> Maintains verbal and written communication with stakeholders, vendors and residents (as needed) on issues relating to our management responsibilities, including but not limited to: quality control; vendor contract management; maintenance personnel responsibilities; access control for mechanical equipment rooms and utilities management. </li><li> Oversees all construction activities during initial development/lease up of the property </li><li> During construction and fit-outs, makes recommendations to eliminate potential problems and/or improve building operations. </li><li> Develops policies, procedures, and regulations to effectively manage the property, pertaining but not limited to, construction work, tenant alteration process and certificate of insurance requirements. </li><li> Develops, implements and assures continued implementation of preventive maintenance programs. </li><li> Assures that all outside vendors are in compliance with the tenets of their contractual agreements for all work performed. </li><li> Ensures that each staff member reviews and complies with the procedures outlined in the Emergency Preparedness Manual. </li><li> Develops and manages all contracts, i.e. Waste Removal, Janitorial and Electrical. </li><li> Supervises and coordinates loading dock access and deliveries. </li><li> Comprehensive understanding of all facets of accounts payable and account receivable in order to effectively supervise staff responsible for this function. </li><li> Confirm that the appropriate allocation methodology is established and ensure that all invoices are coded to and paid from the appropriate entity. </li><li> Ensures that all invoices are processed for timely payment in order to maintain good vendor relations and accounts. </li><li> Reviews and approves purchase orders that exceed amounts over site staff level up to designated approval limit of $1000. </li><li> Ensures that proper insurance documentation for all outside vendors is collect and available for supervisory review. </li><li> Participates in preparation of initial draft of the annual and capital operating budgets for the rental and overall condo entities.</li></ul>Prepares the monthly variance reports for the rental, co-op and overallcondentities. <ul><li> Ensures that budgetary guidelines approved for controllable expenses are met. </li><li> Ensures that staff is fully aware of budgetary goals and constraints. </li><li> Responsible for overseeing all maintenance operations and repairs at the property. </li><li> Responsible for the successful coordination of all move-in/move-outs. </li><li> Service Request System - Facilities </li><li> Confirms timely, efficient completion of all service requests. </li><li> As a general rule, resident-requested service requests should be completed within twenty-four (24) hours. Emergency repairs are addressed promptly, in particular when those situations may cause increasing damage to the property or may endanger the residents' health and safety. </li><li> All completed service requests are signed and placed in the respective resident files to provide documentation of requested services. </li><li> If appropriate, confirms that damage charges are applied to the resident's account for repairs attributable to cause beyond normal wear and tear. </li><li> Ensures that proper key control systems and procedures are in place at all times </li><li> Product Presentation </li><li> Apartment turnovers must produce units that are impeccably clean, painted, and mechanically in good working order prior to the pending move-in. </li><li> A resident survey that queries the conditions of the apartments and the residents' perceptions of the servicesRMCprovides is administered and distributed from the main office annually. Responsible to confirm that any deficiencies noted on the responses have been addressed and assures residents' satisfaction with the service. </li><li> Maintenance of Common Areas </li><li> Common areas, such as laundry rooms, hallways, offices, shops, storage areas, refuse areas, and grounds must be clean at all times. </li><li> Confirms that the routine janitorial schedule is maintained to ensure that the noted expectations are consistently met. </li><li> External Maintenance Services Under the supervision of the Vice President, solicits, reviews </li></ul><h5>Benefits:</h5> <ul><li> Incentive bonus program </li><li> Training and development programs </li><li> Benefits including: Medical, Dental, Life &amp; Disability, Paid Time Off, 401(K), Flexible Spending Accounts </li><li> Employee Recognition &amp; Wellness Programs Qualifications </li><li> Five (5) years of knowledge of property management compliance practice and procedures related to Class A and Affordable property preferred. </li><li> Experience in an affordable housing processing or demonstrate transferable skills </li><li> Demonstrate ability to learn recertification policies, procedures and principles </li><li> Experience in budget preparation and financial reporting, with a strong understanding of building operational systems, leasing and marketing, documentation and administration </li><li> Minimum of five (5) years' experience managing a team of people </li><li> Ability to manage a property as demonstrated by work experience including financial performance, customer service, communications, marketing, negotiation, crisis management, and staffing. </li><li> Ability to analyze data/reports to develop solutions to sustain high standards of customer service, optimal revenue generation and effective expense management as demonstrated by business results in previous position. </li><li> Ability to successfully resolve resident issues as demonstrated by work experience. </li><li> Ability to negotiate and manage contracts with 3rd party service providers as demonstrated by previous work experience. </li><li> Ability to supervise and develop employees and provide feedback and coaching to subordinates resulting in improved performance as demonstrated by experience in previous position. </li><li> Ability to work a flexible schedule; any day of the week, including being \"on-call\". </li><li> Ability to write and communicate professionally in English. </li><li> Ability to apply critical thinking and sound decision-making. </li><li> Ability to resolve residents' concerns while maintaining a friendly and professional demeanor. </li><li> Ability to demonstrate project management skills to ensure tasks are completed on schedule. </li><li> Ability to communicate professionally and adapt interpersonal skills to a variety of audiences. </li><li> Ability to demonstrate teamwork by assisting co-workers and direct reports. </li><li> Ability to provide coaching to direct reports to develop their knowledge and skill-set. </li><li> Ability to effectively convey ideas and influence the opinions of others. </li><li> Ability to demonstrate computer literacy using Microsoft Office software.</li></ul> Overview Related Management Company is the owner and operator of a premier portfolio of assets valued at over $60 billion. Our operating portfolio consists of a diversified mix of properties including luxury rental buildings, retail and commercial space, luxury condominium residences, affordable, and workforce housing located throughout the United States. As the owner and developer for the majority of the RMC portfolio, we have ensured that our buildings are the best assets in their respective submarkets. We provide a diligently maintained property management platform with dedicated professionals who consistently exceeds our residents' and commercial tenants' expectations. Our dedication to providing the highest and most personalized level of service is one of the hallmarks of the company and a key differentiator in the market. For more please visit (Please contact us using the \"Apply for this Job Posting\" box below) Related is an Equal Opportunity Employer For information about how we use your personal information, including information submitted for career opportunities, please review our Privacy Policy at https:// . Related is an Equal Employment Opportunity Employer and participates in E-Verify Position Requirements 1 to 2 Years work experience Go to Application Site Search for further <h5>Jobs Here:</h5> × [<h5>INS:</h5> :<br><br>INS] <h5>LANGUAGE ES DE</h5> Terms &amp; Privacy Policy Refund Policy Site Map Contact us © 2020 Learn4Good Job Posting Web Site - listing US Job Opportunities, Staffing Agencies, International / Overseas Employment. Find &amp; apply for expat jobs/ English teaching jobs abroad for Americans, Canadians, EU/British citizens, recent college graduates...","city_name":"Boston, MA","company_name":"Related Management Corporation","expired":"2020-09-03","id":"cda7a43ccdee44ada42704bf3b07f154","posted":"2020-08-26","score":0,"title_raw":"General Manager","url":[]},{"body":"<!--id: f0df162d10d64c1ab835e270fe28ad2b--> try the craigslist app » Android iOS CL <ul><li> boston </li><li> boston/camb/brook </li><li> skilled trades/artisan boston/camb/brook &gt; skilled trades/artisan favorite favorite hide unhide flag flagged Posted 2020-07-28 10:38 ELECTRICAL /APPRENTICES (BOSTON/FITCHBURG/NORTHSHORE) </li></ul><h5>WASHINGTON</h5> near LIBERTY compensation: <h5>PAY DETERMINED BY EXPERIENCE HOLIDAYS VACATIONS</h5> employment type: full-time <h5>SYLVIA ELECTRICAL CONTRACTING 3</h5> year minimum field electrical experience Own transportation basic hand tools Good work ethic Pay depends on experience. Payed vacation and holidays Friendly working atmosphere Please call 9784798723 <ul><li> Principals only. Recruiters, please don't contact this job poster. </li><li> do NOT contact us with unsolicited services or offers </li><li> OK to highlight this job opening for persons with disabilities post id: 7167361636 posted: 2020-07-28 10:38 updated: 2020-07-28 10:38</li></ul>","city_name":"Boston, MA","company_name":null,"expired":"2020-09-14","id":"f0df162d10d64c1ab835e270fe28ad2b","posted":"2020-07-28","score":0,"title_raw":"ELECTRICAL /APPRENTICES","url":[]},{"body":"<!--id: 2ac6df82e1634084907a7739baacb150--> Biology Lab Technician Co-op • <h5>Share This:</h5> Share on TwitterShare on LinkedinShare on Facebook • Copy Link Posted on: November 24, 2020 Apply Now Boston, MA Co-op Expires January 22, 2021 The Department of Sciences seeks a co-op employee to provide technical assistance to students and support to faculty and staff in the biology laboratories for the Spring 2021 semester. The co-op technician will be responsible for learning and understanding all instructional experiments for the Cell &amp; Molecular Biology and Anatomy &amp; Physiology courses. The co-op technician will also be responsible for supporting both the in-person and online labs for all biology courses. Primary responsibilities include setting up, organizing and testing instructional experiments as well as assisting with instruction. The co-op technician will be responsible for participating in all aspects of laboratory maintenance including safety inspections, organism care, equipment maintenance, dish washing, and the proper disposal of chemical and bio-hazardous waste. The co-op technician must follow all guidelines outlined in the biosafety manual, chemical hygiene plan, and laboratory safety plans. The co-op technician must attend all course meetings and training sessions. In addition to the daily lab responsibilities, the co-op technician will be expected to participate in an independent project that supports the work being done in the laboratory. This project can be but is not limited to a larger ongoing research project, redesign or innovation of labs being taught in any of the biology courses, an approved independent project of the co-op technician's choice. For training purposes, the start date may be earlier than the first day of the semester. This opportunity may also extend beyond the last day of the semester to ensure that all milestones and lab responsibilities are completed.","city_name":"Boston, MA","company_name":"Wentworth Institute of Technology, Inc.","expired":"2021-04-30","id":"2ac6df82e1634084907a7739baacb150","posted":"2020-12-02","score":0,"title_raw":"co-op technician","url":[]}],"unique_postings":322643,"viewable_postings":322643}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"responses/postings.schema.json","type":"object","properties":{"data":{"type":"object","properties":{"postings":{"type":"array","items":{"type":"object","properties":{"body":{"type":"string"},"city":{"type":"string","minLength":1},"city_name":{"type":"string","minLength":1},"company":{"type":["string","null"],"minLength":1},"company_name":{"type":["string","null"],"minLength":1},"company_v2":{"type":["integer","string","null"],"minLength":1},"company_name_v2":{"type":["string","null"],"minLength":1},"company_raw":{"type":["string","null"]},"company_is_staffing":{"type":["boolean","null"]},"contract_type":{"type":"integer","minLength":1},"contract_type_name":{"type":"string","minLength":1},"county":{"type":["integer","null"],"minLength":1},"county_name":{"type":["string","null"],"minLength":1},"duplicates":{"type":"number","minimum":0},"duration":{"__internal":true,"type":["number","null"],"minimum":0},"edulevels":{"type":"array","items":{"type":["integer","string"],"minLength":1}},"edulevels_name":{"type":"array","items":{"type":"string","minLength":1}},"employment_type":{"type":["integer","null"]},"employment_type_name":{"type":["string","null"],"minLength":1},"expired":{"type":["string","null"],"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"id":{"type":"string","minLength":1},"is_internship":{"type":"boolean"},"is_supervisor":{"type":"boolean"},"location":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"],"additionalProperties":false},"max_years_experience":{"type":["integer","null"],"minimum":0},"min_years_experience":{"type":["integer","null"],"minimum":0},"msa":{"type":["integer","null"],"minLength":1},"msa_name":{"type":["string","null"],"minLength":1},"naics2":{"type":["string","null"],"minLength":0},"naics2_name":{"type":["string","null"],"minLength":1},"naics3":{"type":["string","null"],"minLength":0},"naics3_name":{"type":["string","null"],"minLength":1},"naics4":{"type":["string","null"],"minLength":0},"naics4_name":{"type":["string","null"],"minLength":1},"naics5":{"type":["string","null"],"minLength":0},"naics5_name":{"type":["string","null"],"minLength":1},"naics6":{"type":["string","null"],"minLength":0},"naics6_name":{"type":["string","null"],"minLength":1},"onet":{"type":["string","null"],"minLength":1},"onet_name":{"type":["string","null"],"minLength":1},"posted":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"score":{"type":"number"},"skills":{"type":"array","items":{"type":"string","minLength":1}},"skills_name":{"type":"array","items":{"type":"string","minLength":1}},"cip2":{"type":"array","items":{"type":"string","minLength":1}},"cip2_name":{"type":"array","items":{"type":"string","minLength":1}},"cip4":{"type":"array","items":{"type":"string","minLength":1}},"cip4_name":{"type":"array","items":{"type":"string","minLength":1}},"cip6":{"type":"array","items":{"type":"string","minLength":1}},"cip6_name":{"type":"array","items":{"type":"string","minLength":1}},"soc2":{"type":"string","minLength":1},"soc2_name":{"type":"string","minLength":1},"soc3":{"type":"string","minLength":1},"soc3_name":{"type":"string","minLength":1},"soc4":{"type":"string","minLength":1},"soc4_name":{"type":"string","minLength":1},"soc5":{"type":"string","minLength":1},"soc5_name":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string","minLength":1}},"state":{"type":["integer","null"],"minLength":1},"state_name":{"type":["string","null"],"minLength":1},"title":{"type":"string","minLength":1},"title_name":{"type":"string","minLength":1},"title_raw":{"type":["string","null"]},"url":{"type":"array","items":{"type":"string","minLength":1}},"remote_type":{"type":["integer","null"],"minimum":0},"remote_type_name":{"type":["string","null"],"minLength":1},"occupation":{"type":["string","null"],"minLength":0},"occupation_name":{"type":["string","null"],"minLength":0},"occupation_group":{"type":["string","null"],"minLength":0},"occupation_group_name":{"type":["string","null"],"minLength":0},"specialized_occupation":{"type":["string","null"],"minLength":0},"specialized_occupation_name":{"type":["string","null"],"minLength":0},"career_area":{"type":["string","null"],"minLength":0},"career_area_name":{"type":["string","null"],"minLength":0},"lot_occupation":{"type":["string","null"],"minLength":0},"lot_occupation_name":{"type":["string","null"],"minLength":0},"lot_occupation_group":{"type":["string","null"],"minLength":0},"lot_occupation_group_name":{"type":["string","null"],"minLength":0},"lot_specialized_occupation":{"type":["string","null"],"minLength":0},"lot_specialized_occupation_name":{"type":["string","null"],"minLength":0},"lot_career_area":{"type":["string","null"],"minLength":0},"lot_career_area_name":{"type":["string","null"],"minLength":0},"skill_categories":{"type":"array","items":{"type":"string","minLength":1}},"skill_categories_name":{"type":"array","items":{"type":"string","minLength":1}},"skill_subcategories":{"type":"array","items":{"type":"string","minLength":1}},"skill_subcategories_name":{"type":"array","items":{"type":"string","minLength":1}},"is_hwol":{"type":"boolean"},"is_fortune100":{"type":"boolean"},"is_fortune1000":{"type":"boolean"},"is_fortune500":{"type":"boolean"},"revenue_bucket":{"type":["string","null"],"minLength":0},"min_edulevels":{"type":["integer","null"],"minimum":0},"min_edulevels_name":{"type":["string","null"],"minLength":1},"max_edulevels":{"type":["integer","null"],"minimum":0},"max_edulevels_name":{"type":["string","null"],"minLength":1},"job_seniority":{"type":["string","null"],"minLength":1},"job_seniority_name":{"type":["string","null"],"minLength":1},"laa_admin_area_1":{"type":["string","null"],"minLength":1},"laa_admin_area_1_name":{"type":["string","null"],"minLength":1},"laa_admin_area_2":{"type":["string","null"],"minLength":1},"laa_admin_area_2_name":{"type":["string","null"],"minLength":1},"laa_country":{"type":["string","null"],"minLength":1},"laa_country_name":{"type":["string","null"],"minLength":1},"laa_metro":{"type":["string","null"],"minLength":1},"laa_metro_name":{"type":["string","null"],"minLength":1},"language":{"type":["string","null"],"minLength":1},"language_name":{"type":["string","null"],"minLength":1}},"minProperties":1,"additionalProperties":false}},"unique_postings":{"description":"Count of unique postings that matched the given filters.","type":"integer","minimum":0},"page":{"description":"Requested page number.","type":"integer","minimum":1},"pages_available":{"description":"Number of available pages.","type":"integer","minimum":1},"limit":{"description":"Requested postings limit.","type":"integer","minimum":1},"viewable_postings":{"description":"Number of matched postings available to view.","type":"integer","minimum":0}},"required":["postings","unique_postings"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"422":{"$ref":"#/components/responses/422"}},"description":"Get data for individual postings that match your requested filters. Note that not all fields are present for all postings, and some may be `null` or `\"Unknown\"`.\nThe `url` field is only available for currently active postings, and the destination website is not guaranteed to be secure or functional.\n\nTo request more postings please contact us [here](https://docs.lightcast.dev/contact).","operationId":"company_postings_post_postings","requestBody":{"content":{"application/json":{"example":{"filter":{"when":{"start":"2020-01","end":"2020-12"},"city_name":["Boston, MA"],"employment_type_name":["Full-time (> 32 hours)"]},"fields":["id","posted","expired","body","city_name","company_name","title_raw","url","score"],"order":["score"],"limit":5},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/postings.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"fields":{"title":"Posting fields returned in the response","description":"See [/meta](#meta) `postingsFields` for available fields.","default":["id","posted","expired","body","city_name","company_name","title_raw","url","score"],"type":"array","minItems":1},"limit":{"title":"Limit the number of postings returned per page","description":"Maximum: `10` (or more for authorized consumers)","default":10,"type":"integer","minimum":1},"order":{"title":"The order in which to sort the search results","description":"Postings are sorted with respect to the order of the provided keys.\n* `score` - sort postings according to their relevance to the request filter.\n* `posted` - sort postings by their posted dates.\n\nI.e. using an order of `[\"score\", \"posted\"]` will sort postings first by their score then sort the ones with the same score by posted dates.","default":["score","posted"],"type":"array","minItems":1},"page":{"title":"Page number","default":1,"type":"integer","minimum":1}},"required":["filter"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"}]}},"/postings/{postingId}":{"get":{"tags":["Postings"],"summary":"Get a single posting by its id","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"body":"<!--id: 68078da7705941108426e4930941d323--> Keywords (e.g. nurse, sales) Category State City Radius Robotics Software Engineer Slide Brook Partners Email Job to a <h5>Friend Job Location:</h5> Boston, MA Robotics Software Engineer<ul><li>Boston Area (start-up) This Boston area start-up is seeking a lead software engineer with experience in robotics or computer vision-based software.</li></ul> ? The right candidate will be an adventurous and hard-working engineer who has worked in the fast paced world of robotics or vision based software. <h5>Qualifications:</h5><ul><li>Have at 2-4years of relevant job experience</li><li>Have been a part of a start-up or fast-paced environment</li><li>Have experience programming inC++ or Python, and ROS</li><li>Have a drive to solve complex robotics problems</li><li>Have experience working with a small team ?</li></ul> <h5>Responsibilities:</h5><ul><li>Generate software architecture</li><li>Design and build full-stack robot software</li><li>Oversee software engineers and contractors</li><li>Manage software builds and releases</li><li>Direct a QA and DVT program</li></ul>","city_name":"Boston, MA","company_name":"Brook Partners, Inc.","company_v2":"37658177","company_name_v2":"Brook Partners, Inc.","employment_type_name":"Full-time (> 32 hours)","expired":"2018-06-28","id":"68078da7705941108426e4930941d323","max_years_experience":null,"min_years_experience":null,"onet":"15-1132.00","posted":"2018-03-31","score":12.145,"skills":["KS440446CLVJYFGF0X6D","KS440QS66YCBN23Y8K25","KS125LS6N7WP4S6SFTCK","KS1283R6BBX34S61XLQS","KS7G4D96T7C2L619L5TH","KS123X777H5WFNXQ6BPM","KS120NP6J9YGDMN22JGF"],"skills_name":["Robot Operating Systems","Software Engineering","Python (Programming Language)","Software Architecture","Design Verification Test","Sales","Computer Vision"],"title":"ET6850661D6AE5FA86","title_name":"Software Engineers","url":[]}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"responses/single-posting.schema.json","type":"object","properties":{"data":{"type":"object","properties":{"body":{"type":"string"},"city":{"type":"string","minLength":1},"city_name":{"type":"string","minLength":1},"company":{"type":["string","null"],"minLength":1},"company_name":{"type":["string","null"],"minLength":1},"company_v2":{"type":["string","integer","null"],"minLength":1},"company_name_v2":{"type":["string","null"],"minLength":1},"company_raw":{"type":["string","null"]},"company_is_staffing":{"type":["boolean","null"]},"contract_type":{"type":"integer","minLength":1},"contract_type_name":{"type":"string","minLength":1},"county":{"type":["integer","null"],"minLength":1},"county_name":{"type":["string","null"],"minLength":1},"duplicates":{"type":"number","minimum":0},"duration":{"__internal":true,"type":["number","null"],"minimum":0},"edulevels":{"type":"array","items":{"type":["integer","string"],"minLength":1}},"edulevels_name":{"type":"array","items":{"type":"string","minLength":1}},"employment_type":{"type":["integer","null"]},"employment_type_name":{"type":["string","null"],"minLength":1},"expired":{"type":["string","null"],"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"id":{"type":"string","minLength":1},"is_internship":{"type":"boolean"},"is_supervisor":{"type":"boolean"},"location":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"],"additionalProperties":false},"max_years_experience":{"type":["integer","null"],"minimum":0},"min_years_experience":{"type":["integer","null"],"minimum":0},"msa":{"type":["integer","null"],"minLength":1},"msa_name":{"type":["string","null"],"minLength":1},"naics2":{"type":["string","null"],"minLength":0},"naics2_name":{"type":["string","null"],"minLength":1},"naics3":{"type":["string","null"],"minLength":0},"naics3_name":{"type":["string","null"],"minLength":1},"naics4":{"type":["string","null"],"minLength":0},"naics4_name":{"type":["string","null"],"minLength":1},"naics5":{"type":["string","null"],"minLength":0},"naics5_name":{"type":["string","null"],"minLength":1},"naics6":{"type":["string","null"],"minLength":0},"naics6_name":{"type":["string","null"],"minLength":1},"onet":{"type":["string","null"],"minLength":1},"onet_name":{"type":["string","null"],"minLength":1},"posted":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"score":{"type":"number"},"skills":{"type":"array","items":{"type":"string","minLength":1}},"skills_name":{"type":"array","items":{"type":"string","minLength":1}},"cip2":{"type":"array","items":{"type":"string","minLength":1}},"cip2_name":{"type":"array","items":{"type":"string","minLength":1}},"cip4":{"type":"array","items":{"type":"string","minLength":1}},"cip4_name":{"type":"array","items":{"type":"string","minLength":1}},"cip6":{"type":"array","items":{"type":"string","minLength":1}},"cip6_name":{"type":"array","items":{"type":"string","minLength":1}},"soc2":{"type":"string","minLength":1},"soc2_name":{"type":"string","minLength":1},"soc3":{"type":"string","minLength":1},"soc3_name":{"type":"string","minLength":1},"soc4":{"type":"string","minLength":1},"soc4_name":{"type":"string","minLength":1},"soc5":{"type":"string","minLength":1},"soc5_name":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string","minLength":1}},"state":{"type":["integer","null"],"minLength":1},"state_name":{"type":["string","null"],"minLength":1},"title":{"type":"string","minLength":1},"title_name":{"type":"string","minLength":1},"title_raw":{"type":["string","null"]},"url":{"type":"array","items":{"type":"string","minLength":1}},"remote_type":{"type":["integer","null"],"minimum":0},"remote_type_name":{"type":["string","null"],"minLength":1},"occupation":{"type":["string","null"],"minLength":0},"occupation_name":{"type":["string","null"],"minLength":0},"occupation_group":{"type":["string","null"],"minLength":0},"occupation_group_name":{"type":["string","null"],"minLength":0},"specialized_occupation":{"type":["string","null"],"minLength":0},"specialized_occupation_name":{"type":["string","null"],"minLength":0},"career_area":{"type":["string","null"],"minLength":0},"career_area_name":{"type":["string","null"],"minLength":0},"lot_occupation":{"type":["string","null"],"minLength":0},"lot_occupation_name":{"type":["string","null"],"minLength":0},"lot_occupation_group":{"type":["string","null"],"minLength":0},"lot_occupation_group_name":{"type":["string","null"],"minLength":0},"lot_specialized_occupation":{"type":["string","null"],"minLength":0},"lot_specialized_occupation_name":{"type":["string","null"],"minLength":0},"lot_career_area":{"type":["string","null"],"minLength":0},"lot_career_area_name":{"type":["string","null"],"minLength":0},"skill_categories":{"type":"array","items":{"type":"string","minLength":1}},"skill_categories_name":{"type":"array","items":{"type":"string","minLength":1}},"skill_subcategories":{"type":"array","items":{"type":"string","minLength":1}},"skill_subcategories_name":{"type":"array","items":{"type":"string","minLength":1}},"is_hwol":{"type":"boolean"},"is_fortune100":{"type":"boolean"},"is_fortune1000":{"type":"boolean"},"is_fortune500":{"type":"boolean"},"revenue_bucket":{"type":["string","null"],"minLength":0},"min_edulevels":{"type":["integer","null"],"minimum":0},"min_edulevels_name":{"type":["string","null"],"minLength":1},"max_edulevels":{"type":["integer","null"],"minimum":0},"max_edulevels_name":{"type":["string","null"],"minLength":1},"job_seniority":{"type":["string","null"],"minLength":1},"job_seniority_name":{"type":["string","null"],"minLength":1},"laa_admin_area_1":{"type":["string","null"],"minLength":1},"laa_admin_area_1_name":{"type":["string","null"],"minLength":1},"laa_admin_area_2":{"type":["string","null"],"minLength":1},"laa_admin_area_2_name":{"type":["string","null"],"minLength":1},"laa_country":{"type":["string","null"],"minLength":1},"laa_country_name":{"type":["string","null"],"minLength":1},"laa_metro":{"type":["string","null"],"minLength":1},"laa_metro_name":{"type":["string","null"],"minLength":1},"language":{"type":["string","null"],"minLength":1},"language_name":{"type":["string","null"],"minLength":1}},"minProperties":1,"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"}},"description":"Get a single posting by its id.","operationId":"company_postings_get_posting","parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/postingId"}]}},"/distributions":{"get":{"tags":["Distributions"],"summary":"Get a list of current available distribution facets","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":["salary","posting_duration","min_years_experience","max_years_experience"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/distribution-facets.schema.json","properties":{"data":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["data"],"additionalProperties":false}}}}},"description":"Get a list of available distribution facets.","operationId":"company_postings_get_distributions"}},"/distributions/{distributionFacet}":{"post":{"tags":["Distributions"],"summary":"Get a data distribution by percentiles or fixed interval for a selected facet","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"distribution":{"buckets":[{"key":25,"unique_postings":126445,"value":38178},{"key":50,"unique_postings":257335,"value":52000},{"key":75,"unique_postings":381181,"value":90000}],"domain":{"max":500000,"min":24980},"facet":"salary","interval":null,"type":"percentile"},"totals":{"unique_postings":1445428}}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/distribution.schema.json","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"distribution":{"type":"object","properties":{"facet":{"type":"string","minLength":1},"interval":{"type":["null","number"],"minimum":0},"type":{"type":"string","enum":["histogram","percentile"]},"domain":{"type":"object","properties":{"min":{"type":["null","integer"],"minimum":0},"max":{"type":["null","integer"],"minimum":1}},"required":["min","max"],"additionalProperties":false},"buckets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"integer","minimum":0},"value":{"type":["null","integer"]},"unique_postings":{"type":"integer","minimum":0},"total_postings":{"type":"integer","minimum":0},"unique_companies":{"type":"integer","minimum":0},"median_posting_duration":{"type":["integer","null"],"minimum":0},"median_salary":{"type":["integer","null"],"minimum":0},"median_max_salary":{"__internal":true,"type":["integer","null"],"minimum":0},"min_salary":{"type":["integer","null"],"minimum":0},"max_salary":{"type":["integer","null"],"minimum":0},"average_salary":{"type":["integer","null"],"minimum":0}},"required":["key","value"],"additionalProperties":false}}},"required":["facet","interval","type","domain","buckets"],"additionalProperties":false}},"required":["distribution","totals"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"}},"description":"Get a data distribution by percentiles or fixed interval for a selected facet.","operationId":"company_postings_post_distributions_facet","requestBody":{"content":{"application/json":{"example":{"filter":{"when":"active","state_name":["California"]},"distribution":{"type":"percentile","options":{"keys":[25,50,75]},"metrics":["unique_postings"]}},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/distribution.schema.json","type":"object","additionalProperties":false,"properties":{"filter":{"title":"Add filters to your postings query","description":"An object or a list of up to 10 objects.","oneOf":[{"type":"object","properties":{"title":{"title":"Filter by job title codes","description":"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).\n\nFor version see [/meta](#meta).","example":["ET6850661D6AE5FA86"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2":{"title":"Filter by 2-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip2_name":{"title":"Filter by 2-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["English Language and Literature/Letters"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4":{"title":"Filter by 4-digit CIP ids","description":"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).\n\nFor version see [/meta](#meta).","example":["23.13"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip4_name":{"title":"Filter by 4-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Rhetoric and Composition/Writing Studies"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6":{"title":"Filter by 6-digit CIP ids","description":"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)\n\nFor version see [/meta](#meta).","example":["23.1302"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"cip6_name":{"title":"Filter by 6-digit CIP names","description":"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).\n\nFor version see [/meta](#meta).","example":["Creative Writing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city":{"title":"Filter by city ids","description":"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).","example":["U2VhdHRsZSwgV0E="],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"city_name":{"title":"Filter by city names with state abbreviations","description":"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).","example":["Seattle, WA"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company":{"title":"Filter by normalized company codes","description":"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).","example":["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_v2":{"title":"Filter by normalized company v2 codes","description":"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).","example":["44184493"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_is_staffing":{"title":"Filter to or exclude postings from staffing companies","description":"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.","example":true,"type":"boolean"},"company_name":{"title":"Filter by normalized company names","description":"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).","example":["Microsoft Corporation"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"company_name_v2":{"title":"Filter by normalized company v2 names","description":"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).","example":["Boston Children's Hospital"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type":{"title":"Filter by normalized contract type codes","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"contract_type_name":{"title":"Filter by normalized contract type names","description":"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).","example":["Permanent contract"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"county_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels":{"title":"Filter by normalized education level codes","description":"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).","example":[0],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"edulevels_name":{"title":"Filter by normalized education level names","description":"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).","example":["High school or GED"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type":{"title":"Filter by employment type (Full/Part time) codes","description":"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).","example":[1],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"employment_type_name":{"title":"Filter by employment type (Full/Part time) names","description":"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).","example":["Full-time (> 32 hours)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips":{"title":"Filter by Lightcast county (FIPS) codes","description":"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).\n\nFor version see [/meta](#meta).","example":[16057],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"fips_name":{"title":"Filter by Lightcast county (FIPS) names","description":"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).\n\nFor version see [/meta](#meta).","example":["Latah County, ID"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"is_fortune100":{"title":"Filter by Fortune 100 postings","description":"Job postings by Fortune 100 companies","example":true,"type":"boolean"},"is_fortune1000":{"title":"Filter by Fortune 1000 postings","description":"Job postings by Fortune 1000 companies","example":true,"type":"boolean"},"is_fortune500":{"title":"Filter by Fortune 500 postings","description":"Job postings by Fortune 500 companies","example":true,"type":"boolean"},"is_hwol":{"title":"Filter by HWOL","description":"Job postings that are described as Help Wanted OnLine postions.","example":true,"type":"boolean","__internal":true},"is_internship":{"title":"Filter by internship postings","description":"Job postings that are described as internship positions.","example":true,"type":"boolean"},"is_supervisor":{"title":"Filter by supervisory positions","description":"Job postings that are described as supervisor postions.","example":true,"type":"boolean","__internal":true},"job_seniority":{"title":"Filter by job seniority","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"job_seniority_name":{"title":"Filter by job seniority name","description":"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).","example":["Senior"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"keywords":{"title":"Filter postings by keyword","type":"object","properties":{"type":{"title":"Type of keyword search to run","description":"How the keyword(s) are matched in a job posting.\n* `or` - Match postings with any of the keywords.\n* `and` - Match postings with all the keywords.\n* `phrase` - Match postings with the keywords as a phrase.\n* `expression` - Match postings using a complex boolean expression; e.g. `\"(uav OR drone) AND agriculture NOT surveillance\"`.\n\t* 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'.","default":"or","type":"string","enum":["or","and","phrase","expression"]},"query":{"title":"Keyword(s) by which to filter postings","description":"Keyword(s) to match in the original title and body of the postings.","example":"work/life balance","type":"string","minLength":1}},"required":["query"],"additionalProperties":false},"lightcast_sectors":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors","description":"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).\n\nFor version see [/meta](#meta).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lightcast_sectors_name":{"title":"**Beta (may change without warning)**\n\nFilter by Lightcast Sectors names","description":"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).\n\nFor version see [/meta](#meta).","example":["Professionals"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1":{"title":"Filter by Lightcast Administration Area 1 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT33"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_1_name":{"title":"Filter by Lightcast Administration Area 1 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Tyrol"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2":{"title":"Filter by Lightcast Administration Area 2 codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT112"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_admin_area_2_name":{"title":"Filter by Lightcast Administration Area 2 names","description":"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).\n\nFor version see [/meta](#meta).","example":["Nordburgenland"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country":{"title":"Filter by Lightcast Administration Area country codes","description":"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).\n\nFor version see [/meta](#meta).","example":["CZ"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_country_name":{"title":"Filter by Lightcast Administration Area country names","description":"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).\n\nFor version see [/meta](#meta).","example":["Czechia"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro":{"title":"Filter by Lightcast Administration Area metro codes","description":"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).\n\nFor version see [/meta](#meta).","example":["AT003M"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"laa_metro_name":{"title":"Filter by Lightcast Administration Area metro names","description":"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).\n\nFor version see [/meta](#meta).","example":["Linz Metropolitan Area"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language":{"title":"Filter by language codes","description":"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).\n\nFor version see [/meta](#meta).","example":["en"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"language_name":{"title":"Filter by language names","description":"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).\n\nFor version see [/meta](#meta).","example":["English"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area":{"title":"Filter by career area ids","description":"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).","example":["27"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_career_area_name":{"title":"Filter by career area names","description":"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).","example":["Marketing and Public Relations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation":{"title":"Filter by occupation ids","description":"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).","example":["271210"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group":{"title":"Filter by occupation group ids","description":"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).","example":["2712"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_group_name":{"title":"Filter by occupation group names","description":"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).","example":["Marketing Specialists"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_occupation_name":{"title":"Filter by occupation names","description":"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).","example":["E-Commerce Analyst"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation":{"title":"Filter by specialized occupation ids","description":"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).","example":["27121011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"lot_specialized_occupation_name":{"title":"Filter by specialized occupation names","description":"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).","example":["E-Commerce Assistant"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels":{"title":"Filter by maximum education level ids","description":"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).","example":["3"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_edulevels_name":{"title":"Filter by maximum education level names","description":"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).","example":["Master's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"max_salary":{"title":"Filter by maximum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"max_years_experience":{"title":"Filter on the maximum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for maximum years of experience","description":"Lower bound for the maximum years of experience required by a job posting (years are inclusive).","example":4,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for maximum years of experience","description":"Upper bound for the maximum years of experience required by a job posting (years are inclusive).","example":6,"type":"integer","minimum":0}},"additionalProperties":false},"min_edulevels":{"title":"Filter by minimum education level ids","description":"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).","example":["2"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_edulevels_name":{"title":"Filter by minimum education level names","description":"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).","example":["Bachelor's degree"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"min_salary":{"title":"Filter by minimum advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum advertised salary (inclusive).","example":55000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum advertised salary (inclusive).","example":80000,"type":"integer","minimum":0}},"additionalProperties":false},"min_years_experience":{"title":"Filter on the minimum years of experience requested in a posting","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for minimum years of experience","description":"Lower bound for the minimum years of experience required by a job posting (years are inclusive).","example":1,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for minimum years of experience","description":"Upper bound for the minimum years of experience required by a job posting (years are inclusive).","example":3,"type":"integer","minimum":0}},"additionalProperties":false},"msa":{"title":"Filter by Lightcast MSA codes (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":[10180],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"msa_name":{"title":"Filter by Lightcast MSA names (metro or micro)","description":"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).\n\nFor version see [/meta](#meta).","example":["Abilene, TX"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2":{"title":"Filter by normalized 2-digit company NAICS 2017 codes","description":"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).","example":["31"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics2_name":{"title":"Filter by normalized 2-digit company NAICS 2017 names","description":"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).","example":["Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3":{"title":"Filter by normalized 3-digit company NAICS 2017 codes","description":"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).","example":["334"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics3_name":{"title":"Filter by normalized 3-digit company NAICS 2017 names","description":"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).","example":["Computer and Electronic Product Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4":{"title":"Filter by normalized 4-digit company NAICS 2017 codes","description":"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).","example":["3341"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics4_name":{"title":"Filter by normalized 4-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5":{"title":"Filter by normalized 5-digit company NAICS 2017 codes","description":"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).","example":["33411"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics5_name":{"title":"Filter by normalized 5-digit company NAICS 2017 names","description":"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).","example":["Computer and Peripheral Equipment Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6":{"title":"Filter by normalized 6-digit company NAICS 2017 codes","description":"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).","example":["334111"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"naics6_name":{"title":"Filter by normalized 6-digit company NAICS 2017 names","description":"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).","example":["Electronic Computer Manufacturing"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet":{"title":"Filter by Lightcast O*NET codes","description":"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).\n\nFor version see [/meta](#meta).","example":["29-1141.00"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"onet_name":{"title":"Filter by Lightcast O*NET names","description":"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).\n\nFor version see [/meta](#meta).","example":["Registered Nurses"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"posting_duration":{"title":"Filter postings by how long they were active","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for posting duration","description":"Lower bound for the number of days a posting has been active for (days are inclusive).","example":0,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for posting duration","description":"Upper bound for the number of days a posting has been active for (days are inclusive).","example":30,"type":"integer","minimum":0}},"additionalProperties":false},"remote_type":{"title":"Filter by remote type ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"remote_type_name":{"title":"Filter by remote type names","description":"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).","example":["Remote"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"salary":{"title":"Filter by average advertised annual salary","description":"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.","type":"object","properties":{"lower_bound":{"title":"Lower bound for average advertised salary (inclusive).","example":60000,"type":"integer","minimum":0},"upper_bound":{"title":"Upper bound for average advertised salary (inclusive).","example":70000,"type":"integer","minimum":0}},"additionalProperties":false},"skill_categories":{"title":"Filter by skill category ids","description":"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).","example":["1"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_categories_name":{"title":"Filter by skill category names","description":"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).","example":["Administration"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories":{"title":"Filter by skill subcategory ids","description":"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).","example":["103"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skill_subcategories_name":{"title":"Filter by skill subcategory names","description":"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).","example":["General Administrative and Clerical Tasks"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills":{"title":"Filter by skill codes (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["KS440W865GC4VRBW6LJP"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"skills_name":{"title":"Filter by skill names (any skill type)","description":"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).\n\nFor version see [/meta](#meta).","example":["SQL (Programming Language)"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2":{"title":"Filter by Lightcast level 2 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-0000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc2_name":{"title":"Filter by Lightcast level 2 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Management Occupations"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3":{"title":"Filter by Lightcast level 3 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1000"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc3_name":{"title":"Filter by Lightcast level 3 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Top Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4":{"title":"Filter by Lightcast level 4 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1010"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc4_name":{"title":"Filter by Lightcast level 4 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5":{"title":"Filter by Lightcast level 5 SOC codes","description":"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).\n\nFor version see [/meta](#meta).","example":["11-1011"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"soc5_name":{"title":"Filter by Lightcast level 5 SOC names","description":"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).\n\nFor version see [/meta](#meta).","example":["Chief Executives"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"sources":{"title":"Filter by job posting source websites","description":"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).","example":["monster.com"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state":{"title":"Filter by state 2-digit FIPS","description":"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).\n\nFor version see [/meta](#meta).","example":[36],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"state_name":{"title":"Filter by state names","description":"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).\n\nFor version see [/meta](#meta).","example":["New York"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"title_name":{"title":"Filter by job title names","description":"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).\n\nFor version see [/meta](#meta).","example":["Software Engineers"],"oneOf":[{"type":"array","minItems":1},{"type":"object","properties":{},"additionalProperties":false}]},"when":{"title":"Filter postings by time","description":"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.","oneOf":[{"type":"string"},{"type":"object","properties":{"type":{"title":"Choose which date on a posting to filter by","description":"Determines how posting dates are evaluated.\n* `posted` - Match postings that were posted in your date range.\n* `active` - Match postings that were active within your date range.\n* `expired` - Match postings that expired in your date range.`","default":"active","type":"string","enum":["posted","active","expired"]},"end":{"title":"Filter to postings before this date (inclusive)","description":"The end of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2019-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"},"start":{"title":"Filter to postings after this date (inclusive)","description":"The start of a date range, an ISO-8061 year-month or year-month-day date format.","example":"2018-06","type":"string","pattern":"^[0-9]{4}-[0-9]{2}(-[0-9]{2})?$"}},"required":["start","end"],"additionalProperties":false}]}},"required":["when"],"additionalProperties":false},{"type":"array","minItems":1}]},"distribution":{"title":"Data distributions by percentiles or fixed interval","type":"object","properties":{"type":{"title":"Choose your distribution type","type":"string","enum":["histogram","percentile"]},"options":{"title":"Select distribution settings","description":"`keys` is required for percentile, `interval` is required for histogram.","type":"object","properties":{"keys":{"title":"Distribution percentiles","description":"Only valid for `percentile` type distribution.","type":"array","uniqueItems":true,"minItems":1},"interval":{"title":"Distribution interval","description":"Only valid for `histogram` type distribution.","type":"integer","minimum":1},"domain":{"title":"Select minimum and maximum values for the data range","description":"Only valid for `histogram` type distribution.","type":"object","properties":{"min":{"title":"Enforced minimum value of the distribution","type":"integer","minimum":0},"max":{"title":"Enforced maximum value of the distribution","type":"integer","minimum":1}},"required":["min","max"],"additionalProperties":false}},"additionalProperties":false},"metrics":{"title":"Request additional metrics","description":"Some metrics may be approximations for performance reasons.","default":["unique_postings"],"type":"array","items":{"type":"string","enum":["unique_postings","total_postings","unique_companies","median_posting_duration","min_salary","median_salary","median_max_salary","max_salary","average_salary"]},"minItems":1}},"required":["type","options"],"additionalProperties":false}},"required":["filter","distribution"]}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/distributionFacet"}]}},"/taxonomies":{"get":{"tags":["Taxonomies"],"summary":"Get a list of current available taxonomy facets","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":["cip2","cip4","cip6","city","company","company_v2","contract_type","county","currency","edulevels","employment_type","fips","language","laa_admin_area_1","laa_admin_area_2","laa_country","laa_metro","lightcast_sectors","lot_career_area","lot_occupation","lot_occupation_group","lot_specialized_occupation","msa","naics2","naics3","naics4","naics5","naics6","onet","remote_type","skill_categories","skill_subcategories","skills","soc2","soc3","soc4","soc5","state","title"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/taxonomy-facets.schema.json","properties":{"data":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["data"],"additionalProperties":false}}}}},"description":"Get a list of current available taxonomy facets.","operationId":"company_postings_get_taxonomies"}},"/taxonomies/{facet}":{"get":{"tags":["Taxonomies"],"summary":"Search taxonomies using keywords","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"ET3B93055220D592C8","name":"Data Scientists","properties":{"singular_name":"Data Scientist","unique_postings":2293},"score":8.407919},{"id":"ETFCE878A7B95881A6","name":"Data Specialists","properties":{"singular_name":"Data Specialist","unique_postings":1683},"score":5.7275753},{"id":"ET4FFD0730E6B6C21A","name":"Database Specialists","properties":{"singular_name":"Database Specialist","unique_postings":927},"score":5.7275753},{"id":"ET85FAA8C1FD151D5C","name":"Minimum Data Set (MDS) Nurses","properties":{"singular_name":"Minimum Data Set (MDS) Nurse","unique_postings":821},"score":4.0093026},{"id":"ETECC216EB6E8D41E0","name":"Minimum Data Set (MDS) Coordinators","properties":{"singular_name":"Minimum Data Set (MDS) Coordinator","unique_postings":764},"score":4.0093026}]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/taxonomy-search.schema.json","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["integer","string","null"],"minLength":1,"minimum":0},"name":{"type":"string","minLength":1},"description":{"description":"Taxonomy facet item description.","type":"string"},"properties":{"$schema":"http://json-schema.org/draft-07/schema","$id":"includes/taxonomy-properties.schema.json","type":"object","properties":{"singular_name":{"description":"Job title singular name (default is plural form).","type":"string","minLength":1},"skill_type":{"description":"Skills taxonomy type (Specialized Skill, Common Skill, or Certification).","type":"string","minLength":1},"is_software":{"description":"Boolean indicating if the skill is a software skill.","type":"boolean"},"ipeds_award_levels":{"description":"Corresponding IPEDS award level taxonomy codes.","type":"array","items":{"type":"integer"}},"soc_entry_levels":{"description":"Corresponding SOC typical entry level taxonomy codes.","type":"array","items":{"type":"integer"}},"parent":{"description":"Naics parent code.","type":["integer","string"],"minLength":1,"minimum":0},"naics":{"description":"Normalized 6-digit company naics code.","type":["string","integer","null"],"minLength":1},"website":{"description":"Company website.","type":["string","null"],"minLength":1},"state":{"description":"State a company is located in.","type":["string","null"],"minLength":1},"country":{"description":"Country a company is located in.","type":["string","null"],"minLength":1},"zip":{"description":"Zip code a company is located in.","type":["string","null"],"minLength":1},"city":{"description":"City a company is located in.","type":["string","null"],"minLength":1},"unique_postings":{"description":"The number of unique postings.","type":["integer","null"]},"address":{"description":"Company address.","type":["string","null"],"minLength":1},"band":{"description":"Job band.","type":["string","null"]},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"],"additionalProperties":false}},"additionalProperties":false},"score":{"type":"number"}},"required":["id","name"],"additionalProperties":false}}}}}}},"400":{"$ref":"#/components/responses/400"},"404":{"$ref":"#/components/responses/404"}},"description":"Search taxonomies using either whole keywords (relevance search) or partial keywords (autocomplete).","operationId":"company_postings_get_taxonomies_facet","parameters":[{"name":"q","in":"query","description":"A query string of whole or partial keywords to search for. Only when `autocomplete` is true is `q` is assumed to be a prefix. If `q` is omitted, the response will list results sorted by id of length `limit`.","schema":{"type":"string"}},{"name":"autocomplete","in":"query","description":"Autocomplete search terms. Only used in combination with `q`.<br><ul><li>`true` - Performs fast prefix-enabled search using only primary and, if available, alternate names (alternate names currently available for ONET and skills).</li><li>`false` - Performs more extensive search using both name(s) and, if available, description (description currently only available for SOC and ONET search).</li></ul>","schema":{"default":true,"type":"boolean"}},{"name":"limit","in":"query","description":"How many search results to return.","schema":{"default":10,"minimum":1,"maximum":10000,"type":"integer"}},{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/taxonomyFacet"}]}},"/taxonomies/{facet}/lookup":{"post":{"tags":["Taxonomies"],"summary":"Look up taxonomy items by ID","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"ET3B93055220D592C8","name":"Data Scientists","properties":{"singular_name":"Data Scientist","unique_postings":2293}}]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/taxonomy-lookup.schema.json","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Taxonomy facet item identifier.","type":["integer","string"],"minLength":1,"minimum":0},"name":{"description":"Taxonomy facet item name.","type":"string","minLength":1},"description":{"description":"Taxonomy facet item description.","type":"string"},"properties":{"$schema":"http://json-schema.org/draft-07/schema","$id":"includes/taxonomy-properties.schema.json","type":"object","properties":{"singular_name":{"description":"Job title singular name (default is plural form).","type":"string","minLength":1},"skill_type":{"description":"Skills taxonomy type (Specialized Skill, Common Skill, or Certification).","type":"string","minLength":1},"is_software":{"description":"Boolean indicating if the skill is a software skill.","type":"boolean"},"ipeds_award_levels":{"description":"Corresponding IPEDS award level taxonomy codes.","type":"array","items":{"type":"integer"}},"soc_entry_levels":{"description":"Corresponding SOC typical entry level taxonomy codes.","type":"array","items":{"type":"integer"}},"parent":{"description":"Naics parent code.","type":["integer","string"],"minLength":1,"minimum":0},"naics":{"description":"Normalized 6-digit company naics code.","type":["string","integer","null"],"minLength":1},"website":{"description":"Company website.","type":["string","null"],"minLength":1},"state":{"description":"State a company is located in.","type":["string","null"],"minLength":1},"country":{"description":"Country a company is located in.","type":["string","null"],"minLength":1},"zip":{"description":"Zip code a company is located in.","type":["string","null"],"minLength":1},"city":{"description":"City a company is located in.","type":["string","null"],"minLength":1},"unique_postings":{"description":"The number of unique postings.","type":["integer","null"]},"address":{"description":"Company address.","type":["string","null"],"minLength":1},"band":{"description":"Job band.","type":["string","null"]},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"],"additionalProperties":false}},"additionalProperties":false}},"required":["id","name"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/400"},"404":{"$ref":"#/components/responses/404"}},"description":"Look up taxonomy items by ID.","operationId":"company_postings_post_taxonomies_lookup","requestBody":{"content":{"application/json":{"example":{"ids":["ETEB3BB8E555C79368"]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","$id":"requests/taxonomy-lookup.schema.json","type":"object","properties":{"ids":{"title":"Array of taxonomy item IDs to look up","description":"Invalid IDs will be dropped.\n\nMaximum number of ids: `10000`","type":"array","items":{"type":["string","integer"],"minLength":1,"minimum":0},"minItems":1,"maxItems":10000}},"required":["ids"],"additionalProperties":false}}},"required":true},"parameters":[{"$ref":"#/components/parameters/socVersion"},{"$ref":"#/components/parameters/onetVersion"},{"$ref":"#/components/parameters/titleVersion"},{"$ref":"#/components/parameters/companyVersion"},{"$ref":"#/components/parameters/naicsVersion"},{"$ref":"#/components/parameters/newTaxonomyVersions"},{"$ref":"#/components/parameters/areaVersion"},{"$ref":"#/components/parameters/areaUsVersion"},{"$ref":"#/components/parameters/socLightcastVersion"},{"$ref":"#/components/parameters/onetStandardVersion"},{"$ref":"#/components/parameters/lotVersion"},{"$ref":"#/components/parameters/taxonomyFacet"}]}}},"components":{"responses":{"400":{"description":"Your request wasn't valid (bad parameter names or values).","content":{"application/json":{"example":{"errors":[{"status":400,"title":"Malformed Request","detail":"Expected array"}]},"schema":{"$schema":"http://json-schema.org/draft-07/schema","type":"object","$id":"responses/error.schema.json","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"integer","minimum":400,"maximum":599},"title":{"type":"string","minLength":1},"detail":{"type":["string","null"],"minLength":1}},"required":["status","title","detail"],"additionalProperties":false},"minItems":1}},"required":["errors"],"additionalProperties":false}}}},"401":{"description":"Your request wasn't unauthorized.","content":{"application/json":{"example":{"errors":[{"status":401,"title":"Unauthorized Request","detail":"You are not authorized to access this resource."}]},"schema":{"$ref":"#/components/responses/400/content/application~1json/schema"}}}},"404":{"description":"The facet you requested wasn't found.","content":{"application/json":{"example":{"errors":[{"status":404,"title":"URL not found","detail":"Unrecognized facet 'foo'"}]},"schema":{"$ref":"#/components/responses/400/content/application~1json/schema"}}}},"422":{"description":"Your request wasn't valid (bad keyword expression).","content":{"application/json":{"example":{"errors":[{"status":422,"title":"Invalid request content","detail":"Invalid keyword search expression syntax:\n\t\"general merchandise\" OR \"apparel\" OR \"grocery\" OR\n\t                                                  ^"}]},"schema":{"$ref":"#/components/responses/400/content/application~1json/schema"}}}},"500":{"description":"The service is not healthy (e.g. can't connect to datastore).","content":{"application/json":{"example":{"errors":[{"status":500,"title":"Internal server error","detail":"Failed to connect to data source"}]},"schema":{"$ref":"#/components/responses/400/content/application~1json/schema"}}}}},"parameters":{"areaVersion":{"name":"area_version","in":"query","description":"Specify area taxonomy version to use.","schema":{"default":"us_area_2024_4","enum":["us_area_2024_4","us_area_2024_3"],"type":"string"}},"areaUsVersion":{"name":"area_us_version","in":"query","description":"Specify area taxonomy version to use.","schema":{"default":"2.0.0","enum":["2.0.0","1.0.2"],"type":"string"}},"socVersion":{"name":"soc_version","in":"query","description":"Specify SOC taxonomy version to use.","schema":{"default":"soc_2021","enum":["soc_2021","soc_emsi_2019"],"type":"string"}},"onetVersion":{"name":"onet_version","in":"query","description":"Specify ONET taxonomy version to use.","schema":{"default":"onet_2019","enum":["onet_2019","onet_2010"],"type":"string"}},"titleVersion":{"name":"title_version","in":"query","description":"Specify Job Title taxonomy version to use.","schema":{"default":"emsi","enum":["emsi"],"type":"string"}},"companyVersion":{"name":"company_version","in":"query","description":"Specify company taxonomy version to use.","schema":{"default":"emsi_company","enum":["emsi_company"],"type":"string"}},"naicsVersion":{"name":"naics_version","in":"query","description":"Specify NAICS taxonomy version to use.","schema":{"default":"naics_std_2022","enum":["naics_std_2022"],"type":"string"}},"newTaxonomyVersions":{"name":"new_taxonomy_versions","in":"query","description":"Use new taxonomy versions.","schema":{"default":false,"enum":[true,false],"type":"boolean"}},"socLightcastVersion":{"name":"soc_lightcast_version","in":"query","description":"Specify SOC Lightcast taxonomy version to use.","schema":{"default":"2018.2021.0","enum":["2010.2019.0","2018.2021.0"],"type":"string"}},"onetStandardVersion":{"name":"onet_standard_version","in":"query","description":"Specify ONET Standard taxonomy version to use.","schema":{"default":"2019.0.0","enum":["2019.0.0","2010.0.0"],"type":"string"}},"lotVersion":{"name":"lot_version","in":"query","description":"Specify LOT taxonomy version to use.","schema":{"type":"string","default":"7","enum":["6","7"]}},"rankingFacet":{"name":"rankingFacet","in":"path","description":"The facet to rank by.","required":true,"schema":{"enum":["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"]},"example":"skills"},"distributionFacet":{"name":"distributionFacet","in":"path","description":"The facet used as the domain of the distribution.","required":true,"schema":{"enum":["max_years_experience","min_years_experience","posting_duration","salary"]},"example":"salary"},"nestedRankingFacet":{"name":"nestedRankingFacet","in":"path","required":true,"schema":{"enum":["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"]},"example":"skills"},"postingId":{"name":"postingId","in":"path","required":true,"schema":{"type":"string"},"description":"Job posting id.","example":"39460583579"},"taxonomyFacet":{"name":"facet","in":"path","description":"Which taxonomy to search for ID/name suggestions.","required":true,"schema":{"enum":["cip2","cip4","cip6","city","company","company_v2","contract_type","county","currency","edulevels","employment_type","fips","language","laa_admin_area_1","laa_admin_area_2","laa_country","laa_metro","lightcast_sectors","lot_career_area","lot_occupation","lot_occupation_group","lot_specialized_occupation","msa","naics2","naics3","naics4","naics5","naics6","onet","remote_type","skill_categories","skill_subcategories","skills","soc2","soc3","soc4","soc5","state","title"]},"example":"skills"}},"schemas":{},"examples":{},"requestBodies":{},"headers":{},"securitySchemes":{"oauth2":{"description":"OAuth 2.0 for authenticating all API requests.","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.emsicloud.com/connect/token","scopes":{"postings:company":"Access to Company Postings"}}}}},"links":{},"callbacks":{}},"security":[{"oauth2":["postings:company"]}]}