Skip to main content
Job Posting Data is currently in BetaPlease keep in mind that as an Beta product, the schema and field definitions may continue to evolve over the coming months.

Overview

This page details the fields that we have available in our Job Posting dataset.
Field AvailabilityPlease note: Not all fields are available in all bundles.

Job Posting


id

Field Details

PDL persistent job posting ID

Example

JSON

first_seen

Field Details

Date that PDL believes the job posting was posted. This field will be represented as null if the job posting was already live when PDL first crawled the job posting source. This string will always be a date in YYYY-MM-DD format.

Example

JSON

deactivated_date

Field Details

Date that the job posting was deactivated. This field is null if the job posting is still live. This string will always be a date in YYYY-MM-DD format.

Example

JSON

last_verified

Field Details

Last extraction date for the given job posting. This string will always be a date in YYYY-MM-DD format.

Example

JSON

title

Field Details

The PDL cleaned title listed on the job description

Example

JSON

title_raw

Field Details

The raw title listed on the job description

Example

JSON

title_class

Field Details

The derived title class from the listed job title. title_class represents the line item category this employee would fall into.

Example

JSON

title_role

Field Details

The derived title role from the listed job title. title_role represents the function the employee fulfills at the company.

Example

JSON

title_sub_role

Field Details

The derived title sub_role from the listed job title. title_sub_role represents the specific descriptive category a title falls under.

Example

JSON

title_levels

Field Details

The derived title levels from the listed job title. title_levels represent the seniority levels associated with a title.

Example

JSON

company_id

Field Details

PDL Company ID. This field is a foreign key for the PDL company dataset.

Example

JSON

company_name

Field Details

The company’s primary common name. This is enriched from the PDL company dataset.

Example

JSON

company_display_name

Field Details

The company name, capitalized using the company’s self-reported name. This is enriched from the PDL company dataset.

Example

JSON

company_website

Field Details

The company’s primary website. This is enriched from the PDL company dataset.

Example

JSON

company_linkedin_url

Field Details

The main LinkedIn profile URL for the company. This is enriched from the PDL company dataset.

Example

JSON

company_industry

Field Details

The company’s self-reported industry. This is enriched from the PDL company dataset and will be one of our Canonical Industries.

Example

JSON

company_industry_v2

Field Details

The company’s self-reported V2 industry. This is enriched from the PDL company dataset and will be one of our Canonical V2 Industries.

Example

JSON

locations

Field Details

All locations listed on this job posting.

Example

JSON

locations.name

Field Details

The display name of the location. This is generated by concatenating the locality, region, and country of the location.

Example

JSON

locations.locality

Field Details

The standardized locality of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic and typically represents the city, town, neighborhood, or local place name. Examples: san francisco, london, berkeley.

Example

JSON

locations.region

Field Details

The standardized administrative region of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic. Examples include california, ontario, bavaria, and queensland.

Example

JSON

locations.metro

Field Details

The standardized US metro area of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic.

Example

JSON

locations.country

Field Details

The standardized country of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic.

Example

JSON

locations.continent

Field Details

The standardized continent of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic.

Example

JSON

locations.geo

Field Details

The standardized geo of the location listed on the job posting. This is generated using PDL’s location cleaning and standardization logic.

Example

JSON

description_raw

Field Details

The raw HTML job description with no casing changes or modifications besides that PDL strips leading / trailing whitespace.

Example

JSON

description

Field Details

The job description with HTML tags removed, but formatting maintained using html2text.

Example

JSON

remote_work_policy

Field Details

The remote work policy indicated on the job posting as reported on the posting or extracted using generative AI. This value is an enum with the values [hybrid, remote, onsite].

Example

JSON

inferred_skills

Field Details

A list of skills extracted from the job description. These values are extracted from the description field if possible. If no skills can be extracted this array will be empty.

Example

JSON

inferred_skills.name

Field Details

The name of the skill that was extracted from the job description.

Example

JSON

salary_min

Field Details

The minimum salary as listed on the job posting. This value is extracted from the description field if possible. If no salary information, this value will be null.

Example

JSON

salary_max

Field Details

The maximum salary as listed on the job posting. This value is extracted from the description field if possible. If no salary information, this value will be null.

Example

JSON

salary_currency

Field Details

The currency of the salary listed on the job posting. This value is extracted from the description field if possible and will be one of the Canonical Currency Codes. If no salary information, this value will be null.

Example

JSON

salary_period

Field Details

The pay period for the listed salary in the job post. This value is extracted from the description field if possible and will be one of the Canonical Salary Period Values. If no salary information, this value will be null.

Example

JSON

posting_url

Field Details

The url where the posting was retrieved. This will always be a valid URL, but may no longer be active. If deactivated_date is not null, this URL should not resolve.

Example

JSON