---
title: "Get total postings over time"
method: POST
path: "/timeseries"
tags: ["Timeseries"]
---

# Get total postings over time

`POST /timeseries`

## Query parameters

- `soc_version` 'soc_2021'
- `onet_version` 'onet_2019'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `naics_version` 'naics_std_2022'
- `new_taxonomy_versions` true | false
- `area_version` 'us_area_2024_3' | 'us_area_2024_4'
- `area_us_version` '1.0.2' | '1.0.3'
- `soc_lightcast_version` '2018.2021.0'
- `onet_standard_version` '2019.0.0'
- `lot_version` '7' | '6'

## Request body

- object
  - `filter` object, required — An object or a list of up to 10 objects.
    - `title` object — 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).
    - `cip2` object — 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).
    - `cip2_name` object — 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).
    - `cip4` object — 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).
    - `cip4_name` object — 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).
    - `cip6` object — 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).
    - `cip6_name` object — 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).
    - `city` object — 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).
    - `city_name` object — 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).
    - `company` object — 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).
    - `company_v2` object — 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).
    - `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.
    - `company_name` object — 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).
    - `company_name_v2` object — 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).
    - `contract_type` object — 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).
    - `contract_type_name` object — 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).
    - `county` object — 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).
    - `county_name` object — 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).
    - `edulevels` object — 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).
    - `edulevels_name` object — 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).
    - `employment_type` object — 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).
    - `employment_type_name` object — 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).
    - `fips` object — 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).
    - `fips_name` object — 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).
    - `is_fortune100` boolean — Job postings by Fortune 100 companies
    - `is_fortune1000` boolean — Job postings by Fortune 1000 companies
    - `is_fortune500` boolean — Job postings by Fortune 500 companies
    - `is_hwol` boolean — Job postings that are described as Help Wanted OnLine postions.
    - `is_internship` boolean — Job postings that are described as internship positions.
    - `is_supervisor` boolean — Job postings that are described as supervisor postions.
    - `job_seniority` object — 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).
    - `job_seniority_name` object — 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).
    - `keywords` object
      - `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'.
      - `query` string, required — Keyword(s) to match in the original title and body of the postings.
    - `lightcast_sectors` object — 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).
    - `lightcast_sectors_name` object — 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).
    - `laa_admin_area_1` object — 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).
    - `laa_admin_area_1_name` object — 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).
    - `laa_admin_area_2` object — 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).
    - `laa_admin_area_2_name` object — 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).
    - `laa_country` object — 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).
    - `laa_country_name` object — 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).
    - `laa_metro` object — 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).
    - `laa_metro_name` object — 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).
    - `language` object — 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).
    - `language_name` object — 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).
    - `lot_career_area` object — 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).
    - `lot_career_area_name` object — 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).
    - `lot_occupation` object — 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).
    - `lot_occupation_group` object — 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).
    - `lot_occupation_group_name` object — 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).
    - `lot_occupation_name` object — 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).
    - `lot_specialized_occupation` object — 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).
    - `lot_specialized_occupation_name` object — 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).
    - `max_edulevels` object — 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).
    - `max_edulevels_name` object — 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).
    - `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
    - `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).
    - `min_edulevels` object — 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).
    - `min_edulevels_name` object — 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).
    - `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
    - `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).
    - `msa` object — 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).
    - `msa_name` object — 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).
    - `naics2` object — 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).
    - `naics2_name` object — 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).
    - `naics3` object — 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).
    - `naics3_name` object — 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).
    - `naics4` object — 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).
    - `naics4_name` object — 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).
    - `naics5` object — 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).
    - `naics5_name` object — 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).
    - `naics6` object — 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).
    - `naics6_name` object — 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).
    - `onet` object — 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).
    - `onet_name` object — 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).
    - `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).
    - `remote_type` object — 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).
    - `remote_type_name` object — 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).
    - `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
    - `skill_categories` object — 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).
    - `skill_categories_name` object — 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).
    - `skill_subcategories` object — 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).
    - `skill_subcategories_name` object — 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).
    - `skills` object — 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).
    - `skills_name` object — 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).
    - `soc2` object — 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).
    - `soc2_name` object — 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).
    - `soc3` object — 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).
    - `soc3_name` object — 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).
    - `soc4` object — 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).
    - `soc4_name` object — 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).
    - `soc5` object — 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).
    - `soc5_name` object — 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).
    - `sources` object — 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).
    - `state` object — 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).
    - `state_name` object — 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).
    - `title_name` object — 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).
    - `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
        - `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.`
        - `end` string, required — The end of a date range, an ISO-8061 year-month or year-month-day date format.
        - `start` string, required — The start of a date range, an ISO-8061 year-month or year-month-day date format.
  - `metrics` string[]
  - `interval` 'day' | 'week' | 'month' | 'quarter' | 'year'

## Response `200`

OK

- object
  - `data` object, required
    - `totals` object, required
      - `unique_postings` integer
      - `total_postings` integer
      - `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
    - `timeseries` object, required
      - `day` string[]
      - `week` string[]
      - `month` string[]
      - `quarter` string[]
      - `year` string[]
      - `unique_postings` integer[]
      - `total_postings` integer[]
      - `unique_companies` integer[]
      - `median_salary` integer[]
      - `max_salary` integer[]
      - `min_salary` integer[]
      - `median_max_salary` integer[]
      - `average_salary` integer[]

## Other responses

- `400` — bad request
- `401` — unauthorized request
- `422` — Your request wasn't valid (bad keyword expression).

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)