• Add filters to your postings query.
• An object or a list of up to 10 objects.

• 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: ["53.30837"]

• Filter postings by active sources information.
• This is an optional attribute.
• Source information for where the posting can be found online.

• Choose the source type to filter by.

• This is an optional attribute.

  Example: "Company"

• Choose the source to filter by.

• This is an optional attribute.

  Example: "ABCRecruiting.com"

• Choose the source url to filter by.

• This is an optional attribute.

  Example: "ABCRecruiting.com/job/GNkBaDoMWiyQbmlpFHfz"

• 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: ["TG9uZG9u"]

• Filter by city 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: ["London"]

• 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: ["NC95f2bd68-11c7-4140-92ab-7b82fd2d9f7e"]

• 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: ["100136425"]

• 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 by 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"]

• Filter by 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: ["Glenholme Healthcare Group Limited"]

• 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: ["10"]

• 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: ["Apprenticeship"]

• Filter by abbreviated country 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: ["ENG"]

• Filter by country 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: ["England"]

• 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 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 by ISCED 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: [6]

• Filter by maximum ISCED 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: [7]

• Filter by maximum ISCED 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: ["Master's or equivalent level"]

• Filter by minimum ISCED 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: [5]

• Filter by minimum ISCED 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: ["Short-cycle tertiary education"]

• Filter by ISCED 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: ["Bachelor's or equivalent level"]

• 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 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 by apprenticeship job postings.

• This is an optional attribute.

• Job postings that are described as apprenticeship positions.

  Example: true

• Filter by internship job postings.

• This is an optional attribute.

• Job postings that are described as internship positions.

  Example: true

• Filter by voluntary job postings.

• This is an optional attribute.

• Job postings that are described as voluntary positions.

  Example: true

• Filter postings by keyword.
• This is an optional attribute.

• Type of keyword search to run.
• This is an optional attribute.
• How the keyword(s) are matched in a job posting.
• or - Match postings with any of the keywords.
• and - Match postings with all the keywords.
• phrase - Match postings with the keywords as a phrase.
• expression - Match postings using a complex boolean expression; e.g. "(uav OR drone) AND agriculture NOT surveillance".
• Alternatively, you can prefix a word with - to exclude it; e.g. "games Android -iOS" would match postings that mention 'games' and 'Android' but exclude those that mention 'iOS'.
• Must be one of these values: "or", "and", "phrase", "expression"
• Default: "or"

• Keyword(s) by which to filter postings.

• Keyword(s) to match in the original title and body of the job postings.

  Example: "work/life balance"

• Filter by Lightcast LAU1 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: ["00FY"]

• Filter by Lightcast LAU1 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: ["Nottingham"]

• Filter by career area 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: ["27"]

• Filter by career area 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: ["Marketing and Public Relations"]

• Filter by occupation 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: ["271210"]

• Filter by occupation group 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: ["2712"]

• Filter by occupation group 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: ["Marketing Specialists"]

• Filter by occupation 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: ["E-Commerce Analyst"]

• Filter by specialized occupation 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: ["27121011"]

• Filter by specialized occupation 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: ["E-Commerce Assistant"]

• Filter by maximum education level 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: ["3"]

• Filter by maximum 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: ["Master's degree"]

• Filter by maximum advertised annual salary.
• This is an optional attribute.
• This filter operates on the maximum advertised annual salary found in a job posting. Not all postings advertise salaries, when using this filter only postings with advertised salaries will be included in your results.

• Lower bound for maximum advertised salary (inclusive).
• This is an optional attribute.

Minimum: 0

• Upper bound for maximum advertised salary (inclusive).
• This is an optional attribute.

Minimum: 0

• Filter on the maximum years of experience requested in a posting.
• This is an optional attribute.
• This filter operates on the advertised maximum years of experience found in a job posting. Not all postings advertise maximum years of experience, when using this filter only postings with a maximum years of experience will be included in your results.

• Lower bound for maximum years of experience.
• This is an optional attribute.
• Lower bound for the maximum years of experience required by a job posting (years are inclusive).

Minimum: 0

• Upper bound for maximum years of experience.
• This is an optional attribute.
• Upper bound for the maximum years of experience required by a job posting (years are inclusive).

Minimum: 0

• Filter by minimum education level 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: ["2"]

• Filter by minimum 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: ["Bachelor's degree"]

• Filter by minimum advertised annual salary.
• This is an optional attribute.
• This filter operates on the minimum advertised annual salary found in a job posting. Not all postings advertise salaries, when using this filter only postings with advertised salaries will be included in your results.

• Lower bound for minimum advertised salary (inclusive).
• This is an optional attribute.

Minimum: 0

• Upper bound for minimum advertised salary (inclusive).
• This is an optional attribute.

Minimum: 0

• Filter on the minimum years of experience requested in a posting.
• This is an optional attribute.
• This filter operates on the advertised minimum years of experience found in a job posting. Not all postings advertise minimum years of experience, when using this filter only postings with a minimum years of experience will be included in your results.

• Lower bound for minimum years of experience.
• This is an optional attribute.
• Lower bound for the minimum years of experience required by a job posting (years are inclusive).

Minimum: 0

• Upper bound for minimum years of experience.
• This is an optional attribute.
• Upper bound for the minimum years of experience required by a job posting (years are inclusive).

Minimum: 0

• Filter by standard level 1 NUTS 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: ["UKF"]

• Filter by standard level 1 NUTS 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: ["East Midlands"]

• Filter by standard level 3 NUTS 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: ["UKF14"]

• Filter by standard level 3 NUTS 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: ["Nottingham"]

• Filter postings by how long they were active.
• This is an optional attribute.
• This filter operates on the number of days a posting has been active. This filter differs from the 'posting_duration' metric in that it will take into account currently active posting durations, where the metric only calculates duration of expired postings.

• Lower bound for posting duration.
• This is an optional attribute.
• Lower bound for the number of days a posting has been active for (days are inclusive).

Minimum: 0

• Upper bound for posting duration.
• This is an optional attribute.
• Upper bound for the number of days a posting has been active for (days are inclusive).

Minimum: 0

• Filter by remote type 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 by remote 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: ["Remote"]

• Filter by LAA country.

• 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: ["US"]

• Filter by LAA country 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: ["United States"]

• Filter by LAA administrative area 1.

• 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: ["US06"]

• Filter by LAA administrative area 1 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: ["California"]

• 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 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 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 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 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.

• Lower bound for average advertised salary (inclusive).
• This is an optional attribute.

Minimum: 0

• Upper bound for average advertised salary (inclusive).

• This is an optional attribute.

  Example: 70000

  Minimum: 0

• 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.

  Example: ["1"]

• 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 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 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 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: ["KS7G2FY662ZPN6H4DZND"]

• 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 by Lightcast 1-digit UK 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: ["3"]

• Filter by Lightcast UK SOC1 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: ["Associate Professional and Technical Occupations"]

• Filter by Lightcast 2-digit UK 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: ["35"]

• Filter by Lightcast UK SOC2 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: ["Business and Public Service Associate Professionals"]

• Filter by Lightcast 3-digit UK 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: ["354"]

• Filter by Lightcast UK SOC3 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: ["Sales, Marketing and Related Associate Professionals"]

• Filter by Lightcast 4-digit UK 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: ["3545"]

• Filter by Lightcast UK SOC4 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: ["Sales accounts and business development managers"]

• 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.co.uk"]

• 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: ["Web Developer"]

• Filter by travel to work area 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: ["E30000234"]

• Filter by travel to work area 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: ["London"]

• 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.

• Choose 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 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 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 to calculate per month or day.

• This is an optional attribute.

• 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", "min_salary", "median_salary", "max_salary", "average_salary", "median_years_of_experience_required"

• The interval of the timeseries.
• This is an optional attribute.
• Must be one of these values: "day", "week", "month", "quarter", "year"