Slice summary metrics by time

post

https://api.lightcast.io/global-postings/timeseries

Get summary metrics just like the /totals endpoint but broken out by month or day.

Use YYYY-MM date format in the time-frame filter, when, to get monthly summary, or use YYYY-MM-DD date format for daily summary data. When requesting a daily timeseries only up to 90 days may be requested at a time. Months or days with 0 postings will be included in the response.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

new_taxonomy_versions

boolean

enum

Defaults to false

Switch taxonomy versioning mode.
When false (default), use area_version, lot_version, and naics_version.
When true, use area_laa_version and lot_version (area_version and naics_version are not valid).

Allowed:

dataset

string

enum

Defaults to global

Specify dataset to query.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use. Valid in both taxonomy versioning modes.

Allowed:

area_version

string

enum

Defaults to lf_area_2025_1

Specify area taxonomy version to use. Valid only when new_taxonomy_versions=false.

Allowed:

area_laa_version

string

enum

Defaults to 2

Specify LAA area taxonomy version to use. Valid only when new_taxonomy_versions=true.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use. Valid only when new_taxonomy_versions=false.

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

The median_years_of_experience_required metric is the median experience required, based on job postings that include both a minimum and maximum requirement.

Metrics to calculate per month or day

interval

string

enum

Allowed:

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400bad request

401unauthorized request

405the HTTP method is not supported for this URL

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

500the service is not healthy (e.g. can't connect to datastore).