Get total postings over time

post

https://api.lightcast.io/jpa/timeseries

Get summary metrics like /totals, broken out over time. YYYY-MM in when defaults to monthly buckets; YYYY-MM-DD defaults to daily (max 90 days). Use interval for week, quarter, or year. Response bucket dates are YYYY-MM-DD for day/week and YYYY-MM for month/quarter/year.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

soc_version

string

enum

Defaults to soc_2021

Specify SOC taxonomy version to use.

Allowed:

onet_version

string

enum

Defaults to onet_2019

Specify ONET taxonomy version to use.

Allowed:

title_version

string

enum

Defaults to emsi

Specify Job Title taxonomy version to use.

Allowed:

company_version

string

enum

Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:

new_taxonomy_versions

boolean

enum

Defaults to false

Use new taxonomy versions.

Allowed:

area_version

string

enum

Defaults to us_area_2024_4

Specify area taxonomy version to use.

Allowed:

area_us_version

string

enum

Defaults to 2.0.0

Specify area taxonomy version to use.

Allowed:

soc_lightcast_version

string

enum

Defaults to 2018.2021.0

Specify SOC Lightcast taxonomy version to use.

Allowed:

onet_standard_version

string

enum

Defaults to 2019.0.0

Specify ONET Standard taxonomy version to use.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use.

Allowed:

Body Params

filter

required

An object or a list of up to 10 objects.

metrics

array of strings

length ≥ 1

Defaults to unique_postings

Metrics to calculate per month or day

interval

string

enum

Allowed:

Responses

200OK

400Your request wasn't valid (bad parameter names or values).

401Your request wasn't unauthorized.

422Your request wasn't valid (bad keyword expression).