Timeseries

Overview

The timeseries tool returns job posting metric values across time-based intervals. Use this tool when you need to analyze trends, seasonality, growth, decline, or changes in job posting activity over time.

Common Use Cases

Use timeseries tool to answer questions such as:

Use Case	Example
Demand trend	Has demand increased or decreased over the last six months?
Posting volume trends	How has posting volume changed by month, quarter, or year?
Salary trend	How have advertised salaries changed over time?
Demand monitoring	Track job posting volume and hiring activity over time.
Market change analysis	Identify increases, decreases, and seasonal patterns in hiring demand.
Compensation trend analysis	Monitor changes in advertised salary metrics across selected time intervals.

Supported Datasets

The timeseries tool supports the following datasets.

Dataset	Supported	Notes
Job Posting	Yes	Requires a `time` filter.
Profile	No	Use `count`, `distribution`, `estimate`, or `top` instead.

Inputs

The tool accepts the following inputs.

Input	Description
`dataset`	The dataset to analyze
`filter`	Filters are used to narrow the results. A `time` filter is required.
`metrics`	One or more metrics to return over time. If not specified, the tool defaults to: `postings.unique_postings`
`interval`	The time bucket used to group results. Supported values include: `day`, `week`, `month`, `quarter`, or `year`. Defaults to `month`.

Supported Metrics are postings.unique_postings, postings.duplicate_postings, postings.total_postings, postings.posting_intensity, postings.unique_companies, postings.min_salary, postings.median_salary, postings.max_salary, and postings.average_salary.

Depending on the metric, you can track hiring demand, employer activity, posting volume, or salary trends over time.

Example Request

{
  "dataset": "job_postings",
  "filter": {
    "time": {
      "level": 1,
      "values": {
        "start": "2024-01",
        "end": "2024-12",
        "postingType": "posted"
      }
    }
  },
  "metrics": [
    "postings.unique_postings",
    "postings.median_salary"
  ],
  "interval": "month"
}

Outputs

The response returns time-based metric data for the selected interval.

Output	Description
`interval`	Time bucket interval used in the response.
`totals`	Aggregate metrics calculated across the full filtered time range.
`timeseries`	An array of time buckets containing metric values for each period.

The results can be used to identify trends, compare periods, and track how metrics evolve.

Example Response

{
  "interval": "month",
  "totals": {
    "postings.unique_postings": 1250,
    "postings.median_salary": 95000
  },
  "timeseries": [
    {
      "time": "2024-01",
      "metrics": {
        "postings.unique_postings": 104,
        "postings.median_salary": 93000
      }
    }
  ]
}