The PeopleDataLabs Developer Hub

Welcome to the PeopleDataLabs developer hub. You'll find comprehensive guides and documentation to help you start working with PeopleDataLabs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Changelog

Person Schema

Schema

You can access our schema here

Breakdown of the PDL Fields

The dot notation indicates that the property is one level deep inside a hash. If a field is not present then we’ll return an empty list or null value for that field.

Standard Fields

Field Name                                                       Field Type             Short DescriptionExample                                       
idStringPDL persistent IDqEnOZ5Oh0poWnQ1luFBfVw_0000
full_nameStringThe first and the last name fields appended with a spacesean thorne
first_nameStringA person's first namesean
middle_initialStringA person's middle initialf
middle_nameStringA person's middle namefong
last_nameStringA person's last namethorne
genderStringThe person's gendermale
birth_yearStringApproximated birth date associated with this person profile. If a profile has a birth_date, the birth_data_fuzzy field will match1990
birth_dateStringBirth date associated with this person profile1990-12-03
linkedin_urlStringMain linkedin profile for this record based on source agreementlinkedin.com/in/seanthorne
linkedin_usernameStringMain linkedin username for this record based on source agreementseanthorne
linkedin_idStringMain linkedin profile id for this record based on source agreement145991517
facebook_urlStringfacebook profilefacebook.com/deseanthorne
facebook_usernameStringfacebook usernamedeseanthorne
facebook_idStringpersistent facebook id associated with a person's facebook profile1089351304
twitter_urlStringTwitter URLtwitter.com/seanthorne5
twitter_usernameStringTwitter Usernameseanthorne5
github_urlStringMain github profile for this record based on source agreementgithub.com/deseanathan_thornolotheu
github_usernameStringMain github profile username for this record based on source agreementdeseanathan_thornolotheu
work_emailStringCurrent Professional email[email protected]
mobile_phoneStringHighly confident direct dial mobile phone associated with this person+17095944554
industryStringThe most relevant industry for this record based primarily on their tagged personal industries and secondarily on the industries of the companies that they have worked forcomputer software
job_titleStringA person's current job titleco-founder and chief executive officer
job_title_roleStringA person's current job title derived roleoperations
job_title_sub_roleEnum (String)A person's job title derived subrole. Each subrole maps to a rolelogistics
job_title_levelsStringA person's current job title derived levels["cxo", "owner"]
job_company_idStringA person's current company's PDL IDpeopledatalabs
job_company_nameStringA person's current company's namepeople data labs
job_company_websiteStringA person's current company's websitepeopledatalabs.com
job_company_sizeStringA person's current company's size range51-200
job_company_foundedStringA person's current company's founded date1911
job_company_industryStringA person's current company's industrycomputer software
job_company_linkedin_urlStringA person's current company's linkedin urllinkedin.com/company/peopledatalabs
job_company_linkedin_idStringA person's current company's linkedin id1640694639
job_company_facebook_urlStringA person's current company's facebook urlfacebook.com/peopledatalabs
job_company_twitter_urlStringA person's current company's twitter urltwitter.com/peopledatalabs
job_company_location_nameStringA person's current company's HQ canonical locationsan francisco, california, united states
job_company_location_localityStringA person's current company's HQ localitysan francisco
job_company_location_regionStringA person's current company's HQ regioncalifornia
job_company_location_geoStringA person's current company's HQ geo37.77,-122.41
job_company_location_street_addressStringA person's current company's HQ street_address455 Market Street Suite 1690
job_company_location_address_line_2StringA person's current company's HQ address line 2suite 1690
job_company_location_postal_codeStringA person's current company's HQ postal code94105
job_company_location_countryStringA person's current company's HQ countryunited states
job_company_location_continentStringA person's current company's HQ continentnorth america
job_last_updatedStringIndicates the timestamp of the most recent source that agrees with this information2018-11-05
job_start_dateStringIndicates the start period of the object. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY)2015-03
location_nameStringthe current canonical location of the personberkeley, california, united states
location_localityStringthe current locality of the personberkeley
location_regionStringthe current region of the personcalifornia
location_countryStringthe current country of the personunited states
location_continentStringthe current continent of the personnorth america
location_street_addressStringthe current street address of the person455 fake st
location_address_line_2Stringthe current address line 2 of the personapartment 12
location_postal_codeStringthe current postal code of the person94704
location_geoStringthe current geo of the person37.87,-122.27
location_last_updatedStringIndicates the timestamp of the most recent source that agrees with this information2018-11-05
phone_numbersArray (String)Phone numbers associated with this person profile in E164 format+17095944554
emailsArray (Object)Emails associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
emails.addressStringThe full parsed email[email protected]
emails.typeEnum (String)The type of email either current_professional, professional, personal or nullprofessional
interestsArray (Object)Interests associated with the profile
skillsArray (Object)Skills associated with the profile
location_namesList (String)list of all canonical location names associated with the person["berkeley, california, united states", "san francisco, california, united states"]
regionsArray (String)List of regions associated with the person["california, united states"]
countriesArray (String)list of countries associated with a person["united states"]
street_addressesArray (Object)List of full parsed addresses associated with the personList of full parsed addresses associated with the person
street_addresses.street_addressStringThe street address associated with the location object455 fake st
street_addresses.address_line_2StringThe secondary street address associated with the location objectapartment 12
street_addresses.nameStringA string that appends location fields together to create a standard location fieldberkeley, california, united states
street_addresses.localityStringThe administrative locality associated with the location objectberkeley
street_addresses.regionStringThe administrative region associated with the location objectcalifornia
street_addresses.postal_codeStringThe postal code associated with the location object94704
street_addresses.countryStringThe country associated with the location objectunited states
street_addresses.geoStringThe geolocation associated with the location object37.87,-122.27
street_addresses.continentEnum (String)The continent associated with the country in the location objectnorth america
experienceArray (Object)Experience objects associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
experience.titleObjectA dictionary object that provides a raw title, canonized title, and level
experience.title.nameStringThe inputted title from our data sources with some basic cleaning and mapping in order to help with mergingchief executive officer and co-founder
experience.title.levelsArray (Enum (String))Levels associated with a title["c"]
experience.title.roleEnum (String)A person's job title derived roleoperations
experience.title.sub_roleEnum (String)A person's job title derived subrole. Each subrole maps to a rolelogistics
experience.companyObjectA dictionary of information for the associated company
experience.company.idStringOur current NOT PERSISTENT ids that tie company data to the canonical datapeopledatalabs
experience.company.nameStringThe name associated with the companypeople data labs
experience.company.websiteStringThe website associated with the companypeopledatalabs.com
experience.company.foundedStringThe year that the company was founded1911
experience.company.sizeEnum (String)The size range of the company51-200
experience.company.industryEnum (String)The industry associated with the companycomputer software
experience.company.linkedin_urlStringThe linkedin url associated with the companylinkedin.com/company/peopledatalabs
experience.company.linkedin_idStringThe linkedin id associated with the company1640694639
experience.company.facebook_urlStringThe facebook url associated with the companyfacebook.com/peopledatalabs
experience.company.twitter_urlStringThe twitter associated with the companytwitter.com/peopledatalabs
experience.start_dateStringIndicates the start period of the object. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY)2015-03
experience.end_dateStringIndicates the end period of the object2011-07
experience.location_namesArray (String)Locations associated with this particular job/experience object (where the person is working)["san francisco, california, united states"]
experience.is_primaryBooleanIndicates if the experience is the primary experience object in our dataset. This experience object will exist in the job_XXX fieldstrue
experience.company.locationObjectA dictionary of information for the associated company location
experience.company.location.street_addressStringCompany HQ address455 Market Street Suite 1690
experience.company.location.address_line_2StringThe adress line 2 associated with the company HQsuite 1690
experience.company.location.nameStringThe canonical location name associated with the company HQsan francisco, california, united states
experience.company.location.localityStringCompany localitysan francisco
experience.company.location.regionStringCompany regioncalifornia
experience.company.location.countryStringCompany countryunited states
experience.company.location.postal_codeStringThe postal code associated with the company HQ94105
experience.company.location.continentStringThe continent associated with the company HQnorth america
experience.company.location.geoStringThe geo code associated with the company HQ37.77,-122.41
educationArray (Object)Education objects associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
education.degreesArray (String)A list of canonical degrees associated with this education object["bachelors", "bachelors of arts"]
education.majorsArray (String)A list of majors associated with this education object["entrepreneurship"]
education.minorsArray (String)A list of minors associated with this education object["business"]
education.schoolObjectA dictionary of information for the associated school
education.school.idStringOur current NOT PERSISTENT ids that tie company data to the canonical dataa56df063-4562-4e59-bc4c-68b33c14df1e
education.school.nameArray (String)The name associated with the schooluniversity of oregon
education.school.websiteStringThe website associated with the school, could include subdomainsbusiness.uoregon.edu
education.school.domainStringThe website associated with the schooluoregon.edu
education.school.typeArray (String)The type of schoolpost-secondary institution
education.school.linkedin_urlStringThe linkedin url associated with the schoollinkedin.com/school/university-of-oregon
education.school.linkedin_idStringThe linkedin ID associated with the school19207
education.school.facebook_urlStringThe website associated with the schoolThe website associated with the school
education.school.twitter_urlStringThe twitter url associated with the schooltwitter.com/uoregon
education.school.locationObjectThe location associated with the school
education.school.location.nameStringThe canonical name of the location associated with the schooleugene, oregon, united states
education.school.location.localityStringThe locality associated with the schooleugene
education.school.location.regionStringThe region associated with the schooloregon
education.school.location.countryStringThe country associated with the schoolunited states
education.school.location.continentStringThe continent associated with the schoolnorth america
education.start_dateStringIndicates the start period of the object2008-09
education.end_dateStringIndicates the end period of the object2013-06
education.gpaDecimalThe gpa associated with the given degree2.23
profilesArray (Object)Social media profiles associated with this person profile
profiles.urlStringThe url of the social profilelinkedin.com/in/seanthorne
profiles.idStringthe persistent id related to this social profile (varies by social network)145991517
profiles.networkEnum (String)The network the profile exists onlinkedin
profiles.usernameStringThe username associated with the profileseanthorne
version_statusObjectAllows customers track the pervious and current dataset version, any other persistent IDs that were merged into this record using improved entity resolution, and the status of the recordAllows customers track the pervious and current dataset version, any other persistent IDs that were merged into this record using improved entity resolution, and the status of the record
version_status.statusEnum (String)What happened to this ID between releases -- ID Changelogupdated
version_status.current_versionStringCurrent PDL data release versionv2.0
version_status.previous_versionStringMost recent previous PDL data release versoinv1.0
version_status.containsList (String)Any Persistent IDs from the pervious release merged into this ID["a3923482-ab938f893_0000"]

Restricted Fields

To access these fields talk to a data consultant

Field Name     Type                   Short Description                  Example Value
certificationsArray (Object)Certification objects associated with this person profile
certifications.end_dateStringExpiration of certification2018-03
certifications.nameStringInputted name of the certificationmachine learning certification
certifications.organizationStringInputted organization awarding certificationcoursera
certifications.start_dateStringStart date of certification2019-04
education.school.rawArray (String)Raw school namesuniversity of oregon
education.summaryStringUser-inputted summary of educationwhen i was at oregon i volunteered at a local homeless shelter 3 days a week
experience.company.rawArray (String)Raw company namesgoogle -- analytics team
experience.summaryStringUser-inputted summary of experienceworked on the "search analytics" team to understand our users better
experience.title.rawArray (String)Raw titleschief executive officer and co-founder
inferred_salaryStringinferred salary range -- Contact Us to learn how we infer70,000-85,000
inferred_years_experienceIntInferred years work experience7
job_summaryStringUser-inputted summary of experienceworked on the "search analytics" team to understand our users better
languagesArray (Object)Self-identified languages spoken
languages.nameStringName of the canonical language the person inputtedenglish
languages.proficiencyEnum (Int)Self-identified proficiency score 1 (limited) - 5 (fluent)5
linkedin_connectionsIntNumber of linkedin connections50
summaryStringSelf-written summaries tied to person profile (often linkedin summaries)growth-hacker and digital nomad

Updated 7 days ago


Person Schema


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.