---
title: "Get skills benchmark data"
method: POST
path: "/skills"
tags: ["Skills"]
---

# Get skills benchmark data

`POST /skills`

Lightcast aggregates job posting details, and online social profiles from all over the web. The details in this endpoint provide top skills associated with the postings and profiles matching your search. Skill data is based on the last year of active postings and profiles that were updated within the last two years.

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
    - `demand` object, required
      - `specializedSkills` object[], required
        - `id` string, required
        - `name` string, required
        - `postings` integer, required
      - `commonSkills` object[], required
        - `id` string, required
        - `name` string, required
        - `postings` integer, required
    - `supply` object, required
      - `specializedSkills` object[], required
        - `id` string, required
        - `name` string, required
        - `profiles` integer, required
      - `commonSkills` object[], required
        - `id` string, required
        - `name` string, required
        - `profiles` integer, required

## Other responses

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

---

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