Overview

Introduction

The Search API provides robust functionality for searching, matching, and managing resumes and jobs within the Lightcast data repository. It supports creating, retrieving, deleting, and fetching both resumes and job records, allowing seamless integration with recruitment, workforce analytics, and job-matching systems.

This API powers search-driven use cases such as candidate matching, job recommendations, and resume parsing, providing high-performance retrieval through optimized search criteria.

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 Search 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 Search API, the token must include the following scope:

• search (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=search

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