Quickstart - Job Title Enrichment API

A fast hands-on introduction to the Job Title Enrichment API

Getting Started

In order to use our Job Title Enrichment API, you must have an enterprise account. Contact us at [email protected] to learn more.

Simple Example

As mentioned in the Overview, the Job Title Enrichment API is a way to perform a one-to-one match of a job title with those included in our Job Title Dataset. In order to use the Job Title Enrichment API, you will need the job title that you want to look up.

Here's a quick example that demonstrates retrieving a record with a job_title of supply manager:

import requests

url = "https://api.peopledatalabs.com/v5/job_title/enrich"

query_string = {"job_title": "supply manager"}

headers = {
    'accept': "application/json",
    'content-type': "application/json",
    'x-api-key': "YOUR_API_KEY"

response = requests.request("GET", url, headers=headers, params=query_string)

curl -X GET -G \
  'https://api.peopledatalabs.com/v5/job_title/enrich' \
  -H 'X-Api-Key: YOUR API KEY' \
  --data-urlencode 'job_title=supply manager'

The response returned is a job title record if the job_title passed exists in our dataset:

  "cleaned_job_title": "supply manager",
  "similar_job_titles": [
    "senior supply manager",
    "supply chain manager",
    "supply specialist",
    "supply supervisor",
    "supply coordinator"
  "relevant_skills": [
    "supply management",
    "spend analysis",
    "supplier development",
    "demand planning",
    "strategic sourcing"

If you don't get this response, check out our errors page for more information.

Did this page help you?