Overview

Introduction

The Occupation Benchmark API provides access to Lightcast’s comprehensive dataset of occupations. It allows you to retrieve detailed information about a particular occupation, including benchmarking metrics for comparison and analysis.

Data is pulled together from multiple sources and standardized for consistency, providing a single convenient interface for occupation insights.

Note: By default, all clients are allowed a maximum of 5 requests per second. Contact us if you require higher limits.

API Endpoint

There are multiple endpoints within this category. Refer to individual API docs under the Occupation Benchmark section.

Request Headers

(*) Indicates the action is required

All requests must include the following headers:

Authentication

All endpoints in this category require an OAuth 2.0 Bearer Token for authentication. Tokens are granted through Lightcast’s Authentication API and are valid for 1 hour.

To access the Occupation Benchmark API, the token must include the following scope:

• occupation-benchmark (for access to occupational benchmarking data)

Sample Request

curl --request POST \
  --url https://auth.emsicloud.com/connect/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=CLIENT_ID \
  --data client_secret=CLIENT_SECRET \
  --data grant_type=client_credentials \
  --data scope=occupation-benchmark

Request Parameters

Sample Response

{
  "access_token": "<ACCESS_TOKEN>",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Note that the Tokens expire after 3600 seconds. To maintain uninterrupted access, refresh the token before it expires. To know more about this, refer to the Authentication guide.

Response Parameters

Status Code Summary