October 2024 Release Announcement

This data version was released on 10/1/2024.

Welcome to our October 2024 release notes! We have exciting updates to share as we head into the final quarter of 2024!

Here are some of the key highlights:

Excited yet? Read on to learn more, or jump to a specific section using the table of contents below.

Table of Contents

📣 Key Announcements

❗Breaking Changes

✨ New Products and Features

🚀 Data Updates

🛠 Improvements and Bug Fixes


📣 Key Announcements

Schema Changes

headline (Person Schema)

Field NameField TypeField DescriptionExample
headlineStringThe brief headline associated with a person profile."headline": "senior data engineer at people data labs"

We’ve added a new headline field to our Person Data schema that represents the text headline associated with person profiles.

This field is available in our premium resume field bundles. Any customers currently receiving summary fields will also have access to the new headline field. To get access to these field bundles, please reach out to your Customer Success team.


❗Breaking Changes

❗ New Role and Sub Role Job Title Taxonomy (Person / Company / IP)

Previous Announcements: v26 / April 2024, v27.0 / July 2024, v27.1 / August 2024, v27.2 / September 2024

Products Impacted: Person / Company / IP Schema

Person Fields ImpactedCompany Fields ImpactedIP Fields Impacted
job_title_role
job_title_sub_role
experience.title.role
experience.title.sub_role
average_tenure_by_role
employee_count_by_month_by_role
employee_count_by_role
recent_exec_departures
recent_exec_hires
top_next_employers_by_role
top_previous_employers_by_role
person.job_title_role
person.job_title_sub_role

Over the past few months, we have been making significant changes to our job_title_role and job_title_subrole enum values in order to improve our fill rates and categorization of job titles. In August 2024 (v27.1) we launched the first beta version of this new taxonomy to give customers an early opportunity to evaluate the data and provide feedback. As of this October release (v28.0), this new taxonomy has now entered General Availability (see coverage stats below).

The new taxonomy is now fully available to all customers via API and flat file deliveries. To access these new fields customers will have the option to explicitly opt-in for v28.0, v28.1, v28.2, and v29.0 (Oct - Jan releases) by reaching out to your CS / TS team to enable these fields in your data deliveries. API customers can access the new taxonomy by using a new updated_title_roles parameter in their API requests.

The previous (legacy) taxonomy has now entered its deprecation period with support fully ending as of February 2025 (v29.1). Existing customers using the legacy taxonomy can choose to delay opting-in to receive the new taxonomy until the legacy taxonomy is fully deprecated in the v29.1 release. In February 2025 (v29.1), all PDL datasets for all customers will be transitioned to the new taxonomy.

Our Recommendations

If you are an existing customer who has not yet evaluated the new taxonomy:

  • Please reach out to receive a sample as soon as possible.
  • Opt-in to the new taxonomy and begin transitioning your systems to the new taxonomy. The January 2025 (v29.0) release will be the last supported release that you will be able to receive the legacy taxonomy. In February (v29.1), all customers will be transitioned to the new taxonomy. Connect with your CS and TS team to plan and coordinate your migration process.
  • If you are an API customer, you can begin accessing the new taxonomy by including a new updated_title_roles parameter in your API requests and setting it to True.

If you an existing customer who has already begun evaluating the data or participated in the beta release:

  • Continue or begin your migration process. We strongly encourage you to fully transition your systems to using the new taxonomy as early as possible ahead of the February 2025 deprecation to provide time to address any unforeseen transition challenges you run into.

If you are a new customer or you do not currently use any of the fields impacted by this change:

  • Please opt-in to the new taxonomy as this will be the taxonomy supported moving forward.
  • Again, if you are an API customer, you can access the new taxonomy by including a new updated_title_roles parameter in your API requests and setting it to True.

Timeline

Given the scope of the changes, our goal is to provide clear visibility on the process and ample opportunity to work through this transition together. The projected timeline for this release is as follows:

  • July 2024 - Breaking Change Announcement and Resource Launch:
    • Public notice of our planned role / subrole transition and initial resources provided (see below)
  • August 2024 - Beta:
    • We will open up beta access to the new role / subrole taxonomy as well as a new data field title.class
    • Customers will be able to test sample data from our Technical Services team to explore the new taxonomy and the potential data impacts
    • We will release a guide documenting our recommended best practices for transitioning to the new taxonomy with the beta release as well
  • October 2024 - General Availability:
    • We will make the new role / subrole taxonomy generally available for all customers and begin the deprecation process for the previous taxonomy
    • Customers can opt in to accessing the new taxonomy via API (using a new updated_title_roles parameter) and flat file deliveries. Customers will have the ability to delay transitioning until their systems are updated
  • ⏭️ February 2025 - Final Deprecation:
    • We will fully deprecate and officially end support for the previous taxonomy
    • All new and existing customers will be moved onto the new role / subrole taxonomy.

Resources

Please use the following resources to better understand the upcoming changes and to start preparing for the transition. As always, reach out to your Customer Success and Technical Services teams for questions and support.

The new set of canonical classes, roles, and subroles is here:

The mapping from the current role/subrole taxonomy to the improved taxonomy is here:

Sample records using the updated role / subrole taxonomy are here:


❗Location Country Enum Updates

Previous Announcements: v27.0 / July 2024, v27.1 / August 2024, v27.2 / September 2024

Products Impacted: Person / Company / IP Schema

Person Fields ImpactedCompany Fields ImpactedIP Fields Impacted
countries
street_addresses.country
street_addresses.country
possible_street_addresses.country
job_company_location_country
experience.company.location.country
education.school.country
location.country
employee_count_by_country
ip.location.country
ip.company.location.country

This quarter we have updated the set of canonical countries values to better accommodate geographical renamings as well as correct redundancies in our set of country values.

This change is part of an ongoing effort to improve our overall location standardization process within our data. As such it impacts the location country values in our Person, Company and IP datasets, as shown in the table above.

The updated set of country values is available here:

Additionally, a mapping from the legacy country values to the updated country values can be found here:

Country (pre-October)Change TypeCountry (post-October)Comments
swazilandrenamedeswatini
antarcticadeleted--
macedoniarenamednorth macedonia
pitcairnrenamedpitcairn islands
gambiarenamedthe gambia
ivory coastdeleted--Redundant with côte d'ivoire

❗Company Type Enum Change

Previous Announcements: v27.0 / July 2024, v27.1 / August 2024, v27.2 / September 2024

Products Impacted: Person / Company Schema

Person Fields ImpactedCompany Fields Impacted
job_company_type
experience.company.type
type

This quarter, we have updated the set of canonical company type values to include a new public_subsidiary value in the set of canonical values:

Canonical Company Types (pre-October)Canonical Company Types (post-October)
educational
government
nonprofit
private
public
educational
government
nonprofit
private
public
public_subsidiary --> new type

This change is part of an ongoing effort to improve the coverage and accuracy of our stock ticker fields. The addition of the public_subsidiary company type is intended to provide customers a mechanism to easily filter and pull public companies and their subsidiaries, and to provide a more specific label indicating that the company is owned by a public company. Previously, companies like Slack (which is owned by Salesforce) would have been labeled as private in our data. With this release, Slack will be labeled as a public_subsidiary.


⚠️ Upcoming Breaking Changes

🚧

Upcoming Breaking Changes

Upcoming breaking changes may impact your current processes. We are announcing them here to provide ample time for you to adjust your processes accordingly.

⚠️ New Release Schedule (All Products)

Change expected in: v29.0 / January 2025
Products Impacted: All PDL Products

Beginning in January 2025 (v29.0), we will be modifying the schedule for our releases, shifting the release date by 15 days to the middle of the month.

Currently, all releases (major and minor) occur on the first Tuesday of every month. Under the new schedule, all releases will occur on the third Tuesday of the month, with the first release following this new schedule occurring on January 21, 2024 (v29.0).

Why are we making this change?
The primary goal for this change is to increase the freshness of our company insights data, which is built off the “last completed month” of data. Shifting our release schedule by half a month allows us to build our data immediately after the completion of a month. The end result is that we will be able to report our insights data with an extra month’s worth of freshness.

Timeline

❗️

Notice that between v28.2 and v29.0 there will be an additional gap of half a month as we shift from one release schedule to the other.

Release VersionRelease DateComments
v28.0Oct 1, 2024First Tuesday of the Month
v28.1Nov 5, 2024First Tuesday of the Month
v28.2Dec 3, 2024First Tuesday of the Month
v29.0Jan 21, 2025Third Tuesday of the Month
v29.1Feb 18, 2025Third Tuesday of the Month

⚠️ Deprecation of gics_sector (Company)

Change expected in: v29.0 / January 2025
Products Impacted: Company

Company Fields Impacted
gics_sector

In January 2025 (v29.0), we will be removing the gics_sector field from our data. This change will only impact a subset of records in our company dataset.

Currently, this field is only populated in ~27.8k PDL company records (0.003% of our company dataset) since it is derived from the self-identified industry sector reported in the filings of public companies. This field is redundant with other self-reported industry fields contained in our company records (and with much higher coverage). As a result, we have made the decision to deprecate this field in favor of our other industry field representations.

For customers interested in continuing to source public company sector information, we recommend the following resources:

  • Free web sources:
  • Paid API and programmatic resources:

⚠️ Deprecation of version_status (Person)

Change expected in: v29.0 / January 2025
Previous Announcements: v17.0 / January 2022

Products Impacted: Person

Person Fields Impacted
version_status

In January 2025 (v29.0), we will be removing the version_status field from our person dataset.

We officially deprecated this field in January 2022 (v17.0). While this field has continued to exist in our data since then, we have introduced more reliable references to a profile’s history / lineage across releases via the recommended alternatives below. As such, we are fully removing this field from our schema.

Recommended Alternatives
For customers that were using the version_status field to lookup the current version of the data, please use the dataset_version field available in both our Person and Company records.

For customers using this field to understand the change history of records, please use the ID Changelogs (Person / Company) for the relevant monthly / quarterly time period that you are looking to compare against.

⚠️ Free Tier Restructure for Self-Serve Plans

Change expected in: v29.0 / January 2025

Products Impacted: Person

In January 2025, we will be restructuring all existing free-tier plans to limit access to specific fields in our Person datasets. This change impacts all self-serve customers with free tier plans created before July 29, 2024.

Back in July 2024, we made the decision to limit access for new free tier plans to certain person fields that were prone to exploitation for unauthorized and potentially nefarious use cases. Based on the usage patterns we’ve observed since then, we have made the decision to migrate all legacy free tier users to this new free tier plan.

This migration will go into effect in January 2025, after which the person fields shown in the table above will be converted from values to true/false flags. To continue accessing these fields, customers will need to upgrade to a Pro plan with at least $100 minimum monthly commitment.

Example Free Tier Field

Legacy Plan (Pre-Migration)New Plan (Post-Migration)
”work_email”: “[email protected]”work_email”: true


✨ New Products and Features

API Dashboard Batch Enrichment Tool

Preview of the upcoming batch enrichment tool in the self-serve dashboard

Preview of the upcoming batch enrichment tool in the self-serve dashboard

This month, we will be launching a new batch enrichment tool in our API dashboard for Free and Pro-tier self-serve users. This service will allow users to run their own batch enrichments on a CSV file without writing a single line of code.

This new Batch Enrichment tool will replace our existing Data Stats tool which allows users to understand fill and match rates across our Person, Company and IP datasets. The Batch Enrichment tool will follow a similar workflow, where users can upload a CSV of Person/Company/IP records to process. After processing, users will be able to view a fill rate report as well as purchase the enriched records and premium field add-ons.

This service will be launching later this month in our self-serve dashboard, so stay tuned!

📘

Enterprise Customer? Try our Professional Services!

Note that this batch enrichment tool through the API Dashboard will only be available to self-serve users. For enterprise customers, our Technical Services team offers a variety of Professional Services including bulk enrichment of data as well as customizable reporting, query building support, and more.

If you are interested in learning more, please reach out to your Customer Success or Data Consultant team members.



🚀 Data Updates

Freshness

The number of jobs and locations verified in our datasets over the past quarter (based on the job_last_verified and location_last_updated fields).

DatasetGeographyFieldRecords Updated
ResumeGlobalexperience329,930,531
ResumeGloballocation414,033,487
ResumeUnited Statesexperience82,498,685
ResumeUnited Stateslocation102,331,975

Job Changes

The number of person records where the primary job experience changed in our Person Dataset over the past quarter (based on the job_last_changed field).

DatasetGeographyRecords Updated
ResumeGlobal11,218,923
ResumeUnited States4,547,294

Coverage (Full Stats: Person, Company)

Resume Dataset

LinkageCoverage in v27.0Coverage in v28.0Increase (%)
total_records721,091,212727,795,1790.93%
mobile_phone53,145,64867,619,57927.23%
birth_date8,953,51710,061,98312.38%

API Dataset

LinkageCoverage in v27.0Coverage in v28.0Increase (%)
total_records2,794,528,7252,466,332,645-11.74%
street_addresses763,464,633495,472,458-35.10%
birth_year510,506,896379,611,616-25.64%
emails890,326,394699,856,550-21.39%
phones1,156,838,256930,152,340-19.60%
sex2,009,628,7181,762,357,934-12.30%

Email Dataset

LinkageCoverage in v27.0Coverage in v28.0Increase (%)
total_records824,742,873636,349,647-22.84%
street_addresses353,772,740238,136,599-32.69%
personal_emails564,084,125407,345,043-27.79%
birth_year198,081,215147,086,729-25.74%

Company Dataset

LinkageCoverage in v27.0Coverage in v28.0Increase (%)
total_records66,496,32371,340,2787.28%
affiliated_profiles708,110277,363-60.83%
summary55,880,20023,520,617-57.91%
industry35,376,28445,736,80129.29%
mic_exchange22,79227,90722.44%
ticker23,63327,90718.08%

Special Coverage Stats: New Role / Sub Role Taxonomy Fill Rates

MetricLegacy TaxonomyNew TaxonomyIncrease (%)
Overall Fill Rate for experience.title.role37.5%57.5%20.0%

Commentary

  • Person
    • We saw a 20% increase in our coverage for roles across our Person data as a result of our recent Role / Subrole taxonomy improvements that have now entered General Availability. See the previous sections above for additional details on coverage and access.
    • A 27% increase in our coverage of mobile phones in our resume dataset based on previous improvements to our mobile phone sourcing and QA processes from September.
    • A 35% decrease in street address coverage in our API dataset as a result of our removal of a low-quality, legacy data source last month.
  • Company
    • We removed ~600k low quality records from our company dataset, the vast majority of which represented LinkedIn “Showcase” pages that had been inadvertently canonicalized as companies. This can be seen in the 60% decrease in affiliated_profile coverage highlighted above.
    • An 18% increase in our coverage of stock tickers in our company dataset as part of our ticker improvements released in September.
    • In our v27.1 August release we had removed ~35 million “autogenerated” or low quality company summaries, which is reflected in the decrease in summary field coverage seen in our company stats.

🛠 Improvements and Bug Fixes

Improvements

  • Person
    • We have released the headline field to all customers who are receiving the summary field
    • Based on customer feedback and poor user experience, we have removed a small percentage of person records that have a LinkedIn ID but no LinkedIn URL.
    • Inversely, we have also removed a small number of company profiles that had LinkedIn URLs but no LinkedIn ID
    • We improved our ability to deconstruct frankenstein records (i.e. falsely merged profiles), which will allow us to start removing them over time
  • Company
    • We launched a new canonical company type, public_subsidiary, that is applied to any company that has an ultimate_parent company that is public.
    • In response to user feedback, when a company has provided a Twitter, LinkedIn, Instagram, or Crunchbase URL as its primary website, we now also populate that website in the profiles and top-level social fields of those company records. This added 187,827 new social profiles, including 156,093 Instagram URLs. If there are other other social URL linkages that you’d like to see us target, please provide that feedback on the PDL Feature Request page.

Bug Fixes

  • We addressed a bug responsible for missing values in the ultimate_parent_ticker field.
  • We fixed an issue where a large number of VC investors were being dropped from the funding_details.investing_companies field.