Overview

Introduction

The Lightcast NaaS API provides an interface to normalize any string values into standardized Lightcast taxonomy values. These taxonomies are hierarchical datasets describing different aspects of the labor market, such as skills, titles, companies, and occupations. This allows users to map free-text or unstructured data to consistent, machine-readable identifiers across systems.

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

API Endpoint

There are multiple endpoints within this category. Refer to individual API docs under the NaaS API 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 NaaS API, the token must include the following scope:

• naas

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

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