Overview

Introduction

The Defining, Distinguishing & Necessary (DDN) API provides an interface for categorizing skills as defining, distinguishing, or necessary in relation to a given occupation. It enables you to identify which skills are most relevant to specific occupations based on real-world job posting data.

The returned skills are derived from the Lightcast Skills Taxonomy and are calculated using two measures:

• Recall – the percentage of postings for the occupation that contain the skill.
• Concentration – the percentage of postings for the skill that are within the occupation.

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 DDN API section.

Request Headers

(*) Indicates the action to be 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 DDN API, the token must include the following scope:

• ddn (for expanded access)

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=ddn

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