Job Title Schema

A breakdown of the Job Title fields we offer

Overview

This page details the Job Title data that we provide through the Job Title Enrichment API:


Base Job Title Fields

These fields are available to all customers by default.

Identifiers

cleaned_job_title

Description The identifier for the job title.
Data Type String

Field Details

The job title that matches the API input job_title after it's passed through our internal job title cleaner.

Example

  "cleaned_job_title": "pastry chef"

id

Description A placeholder for a future PDL entity ID and currently the same value as cleaned_job_title.
Data Type String

Field Details

Each PDL entity has an ID that allows you to join it to other values. In this case, you can join the id field to the job_title field in the Person Schema and to the relevant_job_titles field in the Skill Schema.

Example

  "id": "pastry chef"

Job Title Information

similar_job_titles

Description A list of up to five other job titles.
Data Type Array [String]

Field Details

Up to five of the most contextually-similar job titles to the cleaned_job_title, determined using PDL’s global resume data.

Example

  "similar_job_titles": ["executive pastry chef", "assistant pastry chef", "pastry cook", "head pastry chef", "pastry sous chef"]

relevant_skills

Description A list of up to five skills.
Data Type Array [String]

Field Details

Up to five of the most contextually-similar skills to the cleaned_job_title, determined using PDL’s global resume data.

Example

  "relevant_skills": ["pastry", "wedding cakes", "cakes", "chocolate", "cake decorating"]