filter | Add filters to your postings query An object or a list of up to 10 objects. |
filter.title |
- Filter by job title codes
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["ET6850661D6AE5FA86"]
|
filter.active_sources_info |
- Filter postings by active sources information
- This is an optional attribute.
- Source information for where the posting can be found online.
|
filter.active_sources_info_type |
- Choose the source
type to filter by
- This is an optional attribute. Example:
"Company"
|
filter.active_sources_info_source |
- Choose the
source to filter by
- This is an optional attribute. Example:
"ABCRecruiting.com"
|
filter.active_sources_info_url |
- Choose the source
url to filter by
- This is an optional attribute. Example:
"ABCRecruiting.com/job/GNkBaDoMWiyQbmlpFHfz"
|
filter.benefit |
- Filter by benefit ids
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example:
["1001"]
|
filter.benefit_categories |
- Filter by benefit category ids
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example:
["1"]
|
filter.benefit_categories_name |
- Filter by benefit category names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example:
["Education and Career Development"]
|
filter.benefit_name |
- Filter by benefit names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Financial Aid/Assistance"]
|
filter.cip2 |
- Filter by 2-digit CIP ids.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["23"]
|
filter.cip2_name |
- Filter by 2-digit CIP names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["English Language and Literature/Letters"]
|
filter.cip4 |
- Filter by 4-digit CIP ids
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["23.13"]
|
filter.cip4_name |
- Filter by 4-digit CIP names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Rhetoric and Composition/Writing Studies"]
|
filter.cip6 |
- Filter by 6-digit CIP ids
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["23.1302"]
|
filter.cip6_name |
- Filter by 6-digit CIP names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Creative Writing"]
|
filter.city |
- Filter by city ids
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["U2VhdHRsZSwgV0E="]
|
filter.city_name |
- Filter by city names with state abbreviations.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Seattle, WA"]
|
filter.company |
- Filter by normalized company codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["NC9d0d7c83-619e-46eb-ae10-7bd2876a6857"]
|
filter.company_v2 |
- Filter by normalized company v2 codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["37389368"]
|
filter.company_is_staffing |
- Filter to or exclude postings from staffing companies.
- This is an optional attribute.
- 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
|
filter.stars_qualified |
- Filter to or exclude postings with STARs qualification
- This is an optional attribute.
- STARs-friendly job postings based on requirements from partner Opportunities@Work.
Example: true
|
filter.company_name |
- Filter by normalized company names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Microsoft Corporation"]
|
filter.company_name_v2 |
- Filter by normalized company v2 names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["North Shore Medical Center"]
|
filter.contract_type |
- Filter by normalized contract type codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["2"]
|
filter.contract_type_name |
- Filter by normalized contract type names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Permanent contract"]
|
filter.county |
- Filter by Lightcast county (FIPS) codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: [16057]
|
filter.county_name |
- Filter by Lightcast county (FIPS) names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Latah County, ID"]
|
filter.edulevels |
- Filter by normalized education level codes
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: [0]
|
filter.edulevels_name |
- Filter by normalized education level names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["High school or GED"]
|
filter.employee_count_range |
- Filter by employee count range.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["1001-5000"]
|
filter.employment_type |
- Filter by employment type (Full/Part time) codes
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: [1]
|
filter.employment_type_name |
- Filter by employment type (Full/Part time) names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Full-time (> 32 hours)"]
|
filter.fips |
- Filter by Lightcast county (FIPS) codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: [16057]
|
filter.fips_name |
- Filter by Lightcast county (FIPS) names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Latah County, ID"]
|
filter.laa_admin_area_2 |
- Filter by LAA administrative area 2.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["US06A"]
|
filter.laa_admin_area_2_name |
- Filter by LAA administrative area 2 names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Los Angeles County"]
|
filter.laa_metro |
- Filter by LAA metro.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["US06AM"]
|
filter.laa_metro_name |
- Filter by LAA metro names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Los Angeles-Long Beach-Anaheim, CA Metro Area"]
|
filter.salary |
- Filter by average advertised annual salary.
- This is an optional attribute.
- 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.
|
filter.salary._lower_bound |
- Lower bound for average advertised salary (inclusive).
- This is an optional attribute.
Example: 60000
Minimum: 0
|
filter.salary._upper_bound |
- Upper bound for average advertised salary (inclusive).
- This is an optional attribute.
Example: 70000
Minimum: 0
|
filter.skill_categories |
- Filter by skill category ids.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see Filtering above).
Example: ["1"]
|
filter.skill_categories_name |
- Filter by skill category names.
- This is an optional attribute.
This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Administration"]
|
filter.skill_subcategories |
- Filter by skill subcategory ids.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["103"]
|
filter.skill_subcategories_name |
- Filter by skill subcategory names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["General Administrative and Clerical Tasks"]
|
filter.skills |
- Filter by skill codes (any skill type)
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["KS440W865GC4VRBW6LJP"]
|
filter.skills_name |
- Filter by skill names (any skill type).
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["SQL (Programming Language)"]
|
filter.soc2 |
- Filter by Lightcast level 2 SOC codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["11-0000"]
|
filter.soc2_name |
- Filter by Lightcast level 2 SOC names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Management Occupations"]
|
filter.soc3 |
- Filter by Lightcast level 3 SOC codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["11-1000"]
|
filter.soc3_name |
- Filter by Lightcast level 3 SOC names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Top Executives"]
|
filter.soc4 |
- Filter by Lightcast level 4 SOC codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["11-1010"]
|
filter.soc4_name |
- Filter by Lightcast level 4 SOC names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Chief Executives"]
|
filter.soc5 |
- Filter by Lightcast level 5 SOC codes.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["11-1011"]
|
filter.soc5_name |
- Filter by Lightcast level 5 SOC names
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Chief Executives"]
|
filter.source_types |
- Filter by job posting source types.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Job Board"]
|
filter.sources |
- Filter by job posting source websites.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["monster.com"]
|
filter.state |
- Filter by state 2-digit FIPS.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: [36]
|
filter.state_name |
- Filter by state names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["New York"]
|
filter.title_name |
- Filter by job title names.
- This is an optional attribute.
- This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering.
Example: ["Software Engineers"]
|
filter.when |
- Filter postings by time.
- 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.
|
filter.when_type |
- bChoose which date on a posting to filter by
- This is an optional attribute.
- Determines how posting dates are evaluated.
posted - Match postings that were posted in your date range.active - Match postings that were active within your date range.expired - Match postings that expired in your date range.
Must be one of these values: "posted", "active", "expired"
Default: "active" |
filter.when_end |
- Filter to postings before this date (inclusive).
- The end of a date range, an ISO-8061 year-month or year-month-day date format. Example:
"2019-06"
|
filter.when_start |
- Filter to postings after this date (inclusive).
- The start of a date range, an ISO-8061 year-month or year-month-day date format. Example:
"2018-06"
|
metrics |
- Metrics to include in the summary.
- This is an optional attribute.
- The
median_posting_duration metric only applies to closed job postings. Some metrics may be approximations for performance reasons.
- The
median_years_of_experience_required metric is the median experience required, based on job postings that include both a minimum and maximum requirement.
Default: ["unique_postings"]
Array Items:
This is an optional attribute.
Must be one of these values: "unique_postings", "duplicate_postings", "total_postings", "posting_intensity", "unique_companies", "median_posting_duration", "min_salary", "median_salary", "max_salary", "median_max_salary", "average_salary", "median_years_of_experience_required"
|
