---
title: "Get benchmark summary"
method: POST
path: "/"
tags: ["Summary"]
---

# Get benchmark summary

`POST /`

## Request

- Base URL: `https://api.lightcast.io/benchmark`
- URL: `https://api.lightcast.io/benchmark/`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `benchmark`

Get summary data on each metric that you have access to.

Advanced filtering is available for this endpoint. For more details, take a look at [Advanced Filtering](#advanced-filtering) section of this documentation.

## Request body

- object
  - `city` string, nullable
  - `title` string
  - `advanced` object
    - `occupations` string[], required: For version see [/meta](#meta).
    - `skills` string[]: For version see [/meta](#meta).
    - `counties` string[]: For version see [/meta](#meta).

## Response `200`

OK

- object
  - `searchParams` object, required
    - `area` union, required: This field will return a list of area objects if `advanced` filter was used. Otherwise, it will be an area object.
      - object
        - `id` string, required
        - `name` string, required
        - `level` string, required
      - object[]
        - `id` string, required
        - `name` string, required
        - `level` string, required
    - `title` object, nullable, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `occupations` object[], required
      - `id` string, required
      - `name` string, required
    - `skills` object[], required
      - `id` string, required
      - `name` string, required
  - `data` object, required
    - `supply` object
      - `benchmarkIndex` number, nullable, required: Our supply benchmark index is a multiplier, comparing regional supply to national supply. `1.0` indicates the region is on par with national supply `null` indicates a lack of information to estimate the index.
      - `profiles` integer, required
      - `companies` integer, required
      - `supplyRating` string, nullable, required: `null` if there's no modeled supply rating or insufficient data for given filters. Only MSA areas are modeled at this time.
    - `demand` object
      - `benchmarkIndex` number, nullable, required: Our demand benchmark index is a multiplier, comparing regional demand to national demand. `1.0` indicates the region is on par with national demand `null` indicates a lack of information to estimate the index.
      - `companies` integer, required
      - `postings` integer, required
      - `demandRating` string, nullable, required: `null` if there's no modeled demand rating or insufficient data for given filters. Only MSA areas are modeled at this time.
    - `compensation` object
      - `benchmarkIndex` number, nullable, required: Our compensation benchmark index is a multiplier, comparing regional compensation to national compensation. `1.0` indicates the region is on par with national compensation `null` indicates a lack of information to estimate the index.
      - `maxSalary` integer, nullable, required: `null` if compensation data does not exist for given filters.
      - `minSalary` integer, nullable, required: `null` if compensation data does not exist for given filters.
      - `medianSalary` integer, nullable, required: `null` if compensation data does not exist for given filters.
      - `medianAdvertisedSalary` integer, nullable, required: `null` if compensation data does not exist for given filters.
      - `wageRating` string, nullable, required: `null` if there's no modeled wage rating or insufficient data for given filters. Only MSA areas are modeled at this time.
    - `diversity` object
      - `regional` number, required
      - `regionalPct` number, required
      - `national` number, required
      - `nationalPct` number, required

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `401`: You don't have access to the endpoint.
- `404`: The facet you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/talent-benchmark.md) - [All operations](https://skmtc.dev/lightcast/apis/talent-benchmark/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/talent-benchmark/revisions/45f810840bb1?raw)