Estimate

Overview

The estimate tool calculates statistical aggregates or estimated values for supported metrics. Use it when you need to retrieve salary or wage estimates, occupational employment, earnings, growth, openings, hires, or separations.

Common Use Cases

Use estimate tool to answer questions such as:

Use Case	Example
Posting salary	What is the median advertised salary for a job posting segment?
Profile wage	What is the median estimated wage for a profile segment?
Compensation benchmarking	Retrieve salary, wage, or earnings estimates.
Posting market diagnostics	Analyze posting intensity and posting duration to better understand hiring demand and market activity.

Supported Datasets

The estimate tool supports the following datasets.

Dataset	Supported	Notes
Job Posting	Yes	Requires a `time` filter.
Profile	Yes	Supports median estimated wage calculations.

Inputs

The tool accepts the following inputs.

Input	Description
`dataset`	The dataset to analyse.
`filter`	Dataset-specific filters built from supported dimensions.
`metrics`	Estimate metrics to return.

Supported Metric families.

Dataset	Metrics
`job_postings`	`postings.average_salary`, `postings.max_salary`, `postings.median_salary`, `postings.median_posting_duration`, `postings.min_salary`, `postings.posting_intensity`
`profiles`	`profiles.median_estimated_wage`

Depending on the dataset, you can retrieve salary estimates, wage estimates, employment figures, earnings data, growth projections, hiring activity, and other market indicators.

Example Request

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

Outputs

The tool returns an metrics object. Each requested metric is mapped to a numeric value or null.

Example Response

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