Status Page
API Reference

Request Parameters - Totals

Totals Request Parameters

Detailed reference for all supported Job Postings - CA Totals request parameters, including property descriptions, supported operators, data types, and usage guidelines.

PropertyDescription
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: ["2610"]
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.cd
  • Filter by Lightcast Census Division 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: [1001]
filter.cd_name
  • Filter by Lightcast Census Division 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: ["Division No. 1, NL"]
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: ["1a8aa57b75584b589cbe6074d7e775e8"]
filter.city_name
  • 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: ["Vaughan"]
filter.cma
  • Filter by Lightcast CMA 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: [10015]
filter.cma_name
  • Filter by Lightcast CMA 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: ["Corner Brook"]
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: ["36704772"]
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.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.csd
  • Filter by Lightcast Census Subdivision 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: [1001519]
filter.csd_name
  • Filter by Lightcast Census Subdivision 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: ["St. John's, NL"]
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.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.is_internship
  • Filter by internship job postings.
  • This is an optional attribute.
  • Job postings that are described as internship positions.
    Example: true
filter.isced
  • 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.isced_max
  • 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.isced_max_name
  • 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.isced_min
  • 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.isced_min_name
  • 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.isced_name
  • 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.keywords
  • Filter postings by keyword.
  • This is an optional attribute.
filter.keywords_type
  • 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"
filter.keywords_query
  • 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.language
  • Filter by language.
  • 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: ["en"]
filter.language_name
  • Filter by language 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"]
filter.lot_career_area
  • 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.lot_career_area_name
  • 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.lot_occupation
  • 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.lot_occupation_group
  • 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.lot_occupation_group_name
  • 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.lot_occupation_name
  • 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.lot_specialized_occupation
  • 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.lot_specialized_occupation_name
  • 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.max_edulevels
  • 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.max_edulevels_name
  • 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.max_salary
  • 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.
filter.max_salary_lower_bound
  • Lower bound for maximum advertised salary (inclusive).
  • This is an optional attribute.
    Example: 55000
    Minimum: 0
filter.max_salary_upper_bound
  • Upper bound for maximum advertised salary (inclusive).
  • This is an optional attribute.
    Example: 80000
    Minimum: 0
filter.max_years_experience
  • 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.
filter.max_years_experience_lower_bound
  • 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
filter.max_years_experience_upper_bound
  • 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.min_edulevels
  • 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.min_edulevels_name
  • 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.min_salary
  • 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.
filter.min_salary_lower_bound
  • Lower bound for minimum advertised salary (inclusive).
  • This is an optional attribute.
    Example: 55000
    Minimum: 0
filter.min_salary_upper_bound
  • Upper bound for minimum advertised salary (inclusive).
  • This is an optional attribute.
    Example: 80000
    Minimum: 0
filter.min_years_experience
  • 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.
filter.min_years_experience_lower_bound
  • 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).
    Example: 1
    Minimum: 0
filter.min_years_experience_upper_bound
  • 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).
    Example: 3
    Minimum: 0
filter.naics2
  • Filter by normalized 2-digit company NAICS 2017 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: [31]
filter.naics2_name
  • Filter by normalized 2-digit company NAICS 2017 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: ["Manufacturing"]
filter.naics3
  • Filter by normalized 3-digit company NAICS 2017 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: [334]
filter.naics3_name
  • Filter by normalized 3-digit company NAICS 2017 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: ["Computer and Electronic Product Manufacturing"]
filter.naics4
  • Filter by normalized 4-digit company NAICS 2017 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: [3341]
filter.naics4_name
  • Filter by normalized 4-digit company NAICS 2017 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: ["Computer and Peripheral Equipment Manufacturing"]
filter.naics5
  • Filter by normalized 5-digit company NAICS 2017 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: [33411]
filter.naics5_name
  • Filter by normalized 5-digit company NAICS 2017 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: ["Computer and Peripheral Equipment Manufacturing"]
filter.naics6
  • Filter by normalized 6-digit company NAICS 2017 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: [334111]
filter.naics6_name
  • Filter by normalized 6-digit company NAICS 2017 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: ["Electronic Computer Manufacturing"]
filter.noc1
  • Filter by Lightcast level 1 NOC 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.noc1_name
  • Filter by Lightcast level 1 NOC 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: ["Natural and applied sciences and related occupations"]
filter.noc2
  • Filter by Lightcast level 2 NOC 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: [21]
filter.noc2_name
  • Filter by Lightcast level 2 NOC 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: ["Professional occupations in natural and applied sciences"]
filter.noc3
  • Filter by Lightcast level 3 NOC 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: [217]
filter.noc3_name
  • Filter by Lightcast level 3 NOC 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: ["Computer and information systems professionals"]
filter.noc4
  • Filter by Lightcast level 4 NOC 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: [2175]
filter.noc4_name
  • Filter by Lightcast level 4 NOC 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 designers and developers"]
filter.noc5
  • Filter by Lightcast level 5 NOC 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: [33101]
filter.noc5_name
  • Filter by Lightcast level 5 NOC 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: ["Medical laboratory assistants and related technical occupations"]
filter.posting_duration_lower_bound
  • 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).
    Example: 0
    Minimum: 0
filter.posting_duration_upper_bound
  • 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).
    Example: 30
    Minimum: 0
filter.pr
  • Filter by province 2-digit 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.pr_name
  • Filter by province 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: ["Ontario"]
filter.province
  • Filter by province 2-digit 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.province_name
  • Filter by province 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: ["Ontario"]
filter.remote_type
  • 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.remote_type_name
  • 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.laa_country
  • 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.laa_country_name
  • 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.laa_admin_area_1
  • 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.laa_admin_area_1_name
  • 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.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.
    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.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: ["glassdoor.ca"]
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: ["Web Developer"]
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
  • 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.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", "average_salary", "median_years_of_experience_required"

Updated about 2 hours ago

Did this page help you?

Updated about 2 hours ago

Did this page help you?