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

  Example: 55000

  Minimum: 0

• Upper bound for maximum advertised salary (inclusive).

• This is an optional attribute.

  Example: 80000

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

  Example: 4

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

  Example: 6

  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.

  Example: 55000

  Minimum: 0

• Upper bound for minimum advertised salary (inclusive).

• This is an optional attribute.

  Example: 80000

  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.

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"

• Choose how to rank your results.

• What metric to use to rank the ranking facet.
• This is an optional attribute.
• Some metrics may be approximations for performance reasons.
• Must be one of these values: "unique_postings", "duplicate_postings", "total_postings", "posting_intensity", "unique_companies", "significance", "relevance", "average_salary"
• Default: "unique_postings"

• Limit the number of ranked items returned.
• This is an optional attribute.
• Unlimited rankings (passing a limit of 0) are not valid for job titles, cities, companies, skills, and certifications facets. Additional maximum limits:
• Nested rankings: 100
• Skills or certifications timeseries ranking when requesting a unique_companies metric: 100

Maximum: 1000

Default: 10

• Request additional metrics for each ranked group returned.

• This is an optional attribute.

• In addition to 'by' metric, calculate these metrics for each ranked group. 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", "average_salary", "median_years_of_experience_required"

• Filter ranked items by number of unique postings for the item.
• This is an optional attribute.
• Require ranked items to have at least this many unique postings matching the filter. Default: 3 when ranking by significance or relevance.

Default: 1

• Filter ranked skills by relevance.
• This is an optional attribute.
• Only applies when ranking by relevance. Require skills to have at least this relevance score.

Maximum: 1

Default: -1

• Filter ranked items to only those provided in this field.
• This is an optional attribute.
• This field does not affect totals matched by the request query, it only filters the items returned in the ranking.

• Filter ranked items to only those not provided in this field.
• This is an optional attribute.
• This field does not affect totals matched by the request query, it only filters the items returned in the ranking.