---
title: "Get demand benchmark data"
method: POST
path: "/demand"
tags: ["Demand"]
---

# Get demand benchmark data

`POST /demand`

Lightcast aggregates job posting details from all over the web. The details in this endpoint provide aggregate totals for the top employers, top titles, and top skills associated with the postings matching your search. Demand data is based on the last year of active postings.

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

## Request body

- Schema — unresolved $ref

## 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
    - `summary` object, required
      - `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.
    - `companies` object[], required
      - `id` string, required
      - `name` string, required
      - `postings` integer, required
    - `titles` object[], required
      - `id` string, required
      - `name` string, required
      - `postings` integer, required
    - `skills` object[], required
      - `id` string, required
      - `name` string, required
      - `postings` integer, required

## Other responses

- `400` — bad request
- `401` — unauthorized request
- `404` — requested resource not found

---

[API](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)