Job Title Schema

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 An 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 Placeholder for a future PDL entity ID, 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 the id can be joined to the job_title field in the Person entity and the relevant_job_titles field in the Skill entity.

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"]


Did this page help you?