Overview

Introduction

The Classification API provides access to Lightcast taxonomies and classifiers. It allows you to:

• Query Lightcast taxonomies directly through the /taxonomies endpoint.
• Map between two taxonomies (either two versions of the same taxonomy or two different taxonomies) through the /mappings endpoint.
• Leverage Lightcast classifiers programmatically through the /classifications endpoint.

Taxonomies served by this API are typically hierarchical datasets describing a particular aspect of the labor market, such as skills, titles, or companies. A complete list of available taxonomies can be accessed through the API.

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 Classification section.

You can also customize responses using query options such as search, return fields, filters, and locales. See General Query Constructs for details.

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 Classification API, the token must include one of the following scopes:

• classification_api
• lightcast_open

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

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