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.
- For more information about data formatting, see Data Types.
- For a simplified overview of our Job Posting fields, check out the Job Posting Data Overview
Job Posting
id
Field Details
PDL persistent job posting IDExample
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 descriptionExample
JSON
title_raw
Field Details
The raw title listed on the job descriptionExample
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 includecalifornia, 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 thedescription 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 thedescription 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 thedescription 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 thedescription 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 thedescription 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
