---
title: "Get total postings"
method: POST
path: "/totals"
tags: ["Totals"]
---

# Get total postings

`POST /totals`

## Request

- Base URL: `api.lightcast.io/jpa` (relative, and the document’s source URL is not known)
- URL: `api.lightcast.io/jpa/totals`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `postings:us`

## Query parameters

- `soc_version` 'soc_2021' | 'soc_emsi_2019'
- `onet_version` 'onet_2019' | 'onet_2010'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `naics_version` 'naics_std_2022'
- `new_taxonomy_versions` true | false
- `soc_lightcast_version` '2010.2019.0' | '2018.2021.0'
- `onet_standard_version` '2019.0.0' | '2010.0.0'

## Request body

- object
  - `filter` object, required: An object of filters.
    - `active_sources_info` object: Source information for where the posting can be found online.
      - `type` string
      - `source` string
      - `url` string
    - `when` union, required: 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.
      - string
      - object
        - `start` string, required: The start of a date range, an ISO-8061 year-month or year-month-day date format.
        - `end` string, required: The end of a date range, an ISO-8061 year-month or year-month-day date format.
        - `type` 'posted' | 'active' | 'expired': 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.`
    - `keywords` object
      - `query` string, required: Keyword(s) to match in the original title and body of the job postings.
      - `type` 'or' | 'and' | 'phrase' | 'expression': 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'.
    - `cip6` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above) For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `cip6_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `cip4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `cip4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `cip2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `cip2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `city` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `city_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `county` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `county_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `fips` County (unresolved $ref)
    - `fips_name` CountyName (unresolved $ref)
    - `msa` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `msa_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `state` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `state_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `title` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `title_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `onet` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `onet_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `soc2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc3_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc5` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `soc5_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `company` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `company_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `company_is_staffing` boolean: 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.
    - `naics2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics2_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics3_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics4_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics5` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics5_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics6` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `naics6_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `national_skill_cluster` union: A list of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `state_skill_cluster` union: A list of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `msa_skill_cluster` union: A list of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `skills` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `skills_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `sources` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `source_types` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `employment_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `employment_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `min_years_experience` object: 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` integer: Lower bound for the minimum years of experience required by a job posting (years are inclusive).
      - `upper_bound` integer: Upper bound for the minimum years of experience required by a job posting (years are inclusive).
      - `include_missing` true | false: Include postings that don't contain the requested field.
    - `max_years_experience` object: 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` integer: Lower bound for the maximum years of experience required by a job posting (years are inclusive).
      - `upper_bound` integer: Upper bound for the maximum years of experience required by a job posting (years are inclusive).
      - `include_missing` true | false: Include postings that don't contain the requested field.
    - `salary` object: 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` integer
      - `upper_bound` integer
      - `include_missing` true | false: Include postings that don't contain the requested field.
    - `min_salary` object: 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` integer
      - `upper_bound` integer
    - `max_salary` object: 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` integer
      - `upper_bound` integer
    - `posting_duration` object: 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` integer: Lower bound for the number of days a posting has been active for (days are inclusive).
      - `upper_bound` integer: Upper bound for the number of days a posting has been active for (days are inclusive).
    - `is_supervisor` boolean: Job postings that are described as supervisor postions.
    - `is_internship` boolean: Job postings that are described as internship positions.
    - `remote_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `remote_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `lightcast_sectors` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `lightcast_sectors_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta).
      - FilterItems[] (unresolved $ref)
      - object
    - `lot_specialized_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `lot_specialized_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `lot_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `lot_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `lot_occupation_group` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `lot_occupation_group_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `lot_career_area` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `lot_career_area_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `skill_categories` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `skill_categories_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `skill_subcategories` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `skill_subcategories_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `is_hwol` boolean: Job postings that are described as Help Wanted OnLine postions.
    - `min_edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `min_edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `max_edulevels` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `max_edulevels_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
    - `contract_type` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterIntItems[] (unresolved $ref)
      - object
    - `contract_type_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above).
      - FilterItems[] (unresolved $ref)
      - object
  - `metrics` string[]: <div class="internal-only">The `median_posting_duration` metric only applies to closed job postings. </div> Some metrics may be approximations for performance reasons.

## Response `200`

OK

- object
  - `data` object, required
    - `totals` object, required
      - `unique_postings` integer
      - `duplicate_postings` integer
      - `total_postings` integer
      - `posting_intensity` number
      - `unique_companies` integer
      - `median_posting_duration` integer, nullable
      - `median_salary` integer, nullable
      - `max_salary` integer, nullable
      - `min_salary` integer, nullable
      - `median_max_salary` integer, nullable
      - `average_salary` integer, nullable

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `401`: Your request wasn't unauthorized.
- `422`: Your request wasn't valid (bad keyword expression).
- `500`: The service is not healthy (e.g. can't connect to datastore).

---

[API](https://skmtc.dev/lightcast/apis/chaetest.md) - [All operations](https://skmtc.dev/lightcast/apis/chaetest/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/chaetest/revisions/89fbbbbd2b7f?raw)