Status Page
API Reference

Normalize titles in bulk

post
https://api.lightcast.io/titles/versions//normalize/bulk

Normalize multiple raw job title strings to a list of best matching Lightcast titles

Supported document types and their expected Content-Type (Document must be UTF-8 encoded.):

  • JSON – application/json
  • Plain text – text/plain

There is a limit of 500 titles per request.

Raw title size is limited to 1kB per title.

This endpoint requires additional permissions, please contact us if you''d like access to bulk normalization. Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The title version.

Query Params
number
0 to 1
Defaults to 0.5

Filter out titles with a confidence value lower than this threshold (this query param does not apply for JSON requests).

string
Defaults to id,name

List of fields to return per title. See /versions/{version} for available fields (this query param does not apply for JSON requests).

Body Params
terms
array of strings
required
length ≥ 1

Maximum number of terms: 500

List of terms to normalize*
fields
array of strings
length ≥ 1
Defaults to id,name

See /versions/{version} for available fields.

mappings require additional permissions, please contact us if you'd like access to mappings.

List of fields to return per title
number
0 to 1
Defaults to 0.5
Responses

Updated 9 months ago

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 9 months ago