SpringDB Data Exchange Search data fieldsData vendorsAI Data ConsultantList your data

Person Search API (GET /v5/person/search)

A People Data Labs dataset with 249 fields. View the People Data Labs profile.

Product details

Match keysid
Geo coverageGlobal
Refresh cadenceOn-demand
LifecycleActive
Pricing modelPer-record
Last verified2026-08-15

Person Search API (GET /v5/person/search) fields

FieldAPI nameCategoryTypeFill rateDescription
Person Job O*NET Specific Occupationjob_onet_specific_occupationString-The O*NET Specific Occupation associated with the person's current job title.
Person Current Company Namejob_company_nameString-The person's current company's name.
Person Possible Emails Objectpossible_emailsArray of Objects-PARENT: Lower-confidence email addresses associated with the person.
Person SexsexEnum (String)-The person's sex (renamed from 'gender' in PDL v26.0).
Profile Score Attribute Fill Rateattribute_fill_rateFloat-The share of selected resume attributes present on the profile.
Education School Twitter URLtwitter_urlURL (String)-The school's Twitter/X URL.
Full Namefull_nameString-Full name (or full display name) of a person, contact, executive, officer, or social-media account. Entity-differentiated: Contact, Executive, Officer/Director, Person, Social Profile, Social Post (tagged account).
Person Possible Profiles Objectpossible_profilesArray of Objects-PARENT: Lower-confidence social profiles associated with the person (same shape as profiles).
Person Num Raw Recordsnum_recordsInteger-The number of unique raw records contributing to this specific PDL person profile.
Experience Company ObjectcompanyObject-PARENT: The company where the person worked during this experience entry.
Possible Email Last Seen Datelast_seenDate (String)-The date this possible email was last associated with the Person record.
Person Location Regionlocation_regionString-The administrative region of the person's current address.
Experience Company HQ CountrycountryEnum (String)-Country of the experience company HQ.
Person Current Company Websitejob_company_websiteURL (String)-The person's current company's website.
First Namefirst_nameString-Contact first name.
GitHub URLgithub_urlURL (String)-URL of the person's GitHub profile.
Person Last Initiallast_initialString (1 character)-The first letter of the person's last name.
Experience Title Raw InputrawArray of Strings-Raw job title input for this experience entry.
Person Mobile Phonemobile_phonePhone (String)-The personal mobile phone associated with this individual. Mobile phones can only be associated with 1 person in PDL data.
Experience SummarysummaryString-User-inputted summary of the person's work experience at this company.
Person Location Address Line 2location_address_line_2String-The person's current street address line 2.
Person Location Localitylocation_localityString-The locality of the person's current address.
Person Birth Datebirth_dateDate (String)-The day the person was born.
Email Num Sourcesnum_sourcesInteger-The number of sources that have contributed to the association of this email with the Person record.
Person Street Address (Historical)street_addressString-The street address line for this entry.
Education School ObjectschoolObject-PARENT: The school the person attended (name, type, location, social/web links).
Experience Company HQ Location NamenameString-Combined cleaned location name of the experience company HQ.
Person Recommended Personal Emailrecommended_personal_emailString-PDL's best available personal email to reach the person, selected from personal_emails.
Education School Location LocalitylocalityString-The locality the school is in.
Phone NumbernumberPhone (String)-Phone number in international format, from a vendor's generic (type-classified) phone array rather than a type-specific field.
Person Location Geo Coordinateslocation_geoString-The geo code of the city center of the person's current address.
Person Current Company HQ Geo Coordinatesjob_company_location_geoString-The person's current company's headquarters' city-center geographic coordinates.
Experience Company Raw NamerawString-Raw experience company name.
Job History Company IDcompany_idString-PDL Company ID for the prior position.
Person Operation IDoperation_idString-An identifier for an operation in a PDL Data License delivery, used for troubleshooting.
Person Location Last Updated Datelocation_last_updatedDate (String)-The timestamp a new data source contributed to the record for the person's current address.
Person LinkedIn SkillsskillsArray of Strings-Skills listed on the person's LinkedIn profile.
Person Inferred Salary Rangeinferred_salaryEnum (String)-The inferred salary range (USD) for the person's current job.
Possible Profile URLurlURL (String)-The possible profile URL.
Email Last Seen Datelast_seenDate (String)-Unix date the email was last seen via validation or other verifiable data.
Experience Company HQ Address Line 2address_line_2String-Street address line 2 of the experience company HQ.
Last Namelast_nameString-Contact last name.
Education School IDidString-The non-persistent ID for the school in PDL's records.
Person Location Namelocation_nameString-Combined cleaned location name of the person's current address.
Person Possible Birth Datespossible_birth_datesArray of Strings-Birthdays associated with this person that have a lower level of confidence than birth_date.
Activity Score Months Since Last Resume Endmonths_since_last_end_resumeInteger-The number of months since the profile's latest resume end date, when no active experience or education is present.
Facebook URLfacebook_urlURL (String)-URL of the person's or company's Facebook profile.
Person Current Company HQ Regionjob_company_location_regionString-The person's current company's headquarters' administrative region (e.g. state/province).
Education SummarysummaryString-User-inputted summary of the person's education at this school.
Person Current Company LinkedIn URLjob_company_linkedin_urlURL (String)-The person's current company's LinkedIn URL.
Education School TypetypeEnum (String)-The school type.
Twitter URLtwitter_urlURL (String)-URL of the person's or company's Twitter/X profile.
Education MajorsmajorsArray of Strings-All majors the person earned at the school.
Person Street Address Postal Code (Historical)postal_codeString-Postal code for this address entry.
Experience Start Datestart_dateDate (String)-The date the person started at the company for this experience entry.
Experience Company HQ Street Addressstreet_addressString-Street address of the experience company HQ.
Experience Is Primary Flagis_primaryBoolean-Whether this experience entry is the person's current job (populates the flattened job_ fields).
Person Current Company Typejob_company_typeEnum (String)-The person's current company's type (e.g. public, private, nonprofit).
Profile Score Profile Age (Months)profile_age_monthsInteger-The age of the profile in months, based on PDL's first observation of the trusted LinkedIn profile.
Person Job O*NET Codejob_onet_codeString-The 8-digit O*NET code for the person's current job title.
Person Job O*NET Minor Groupjob_onet_minor_groupString-The O*NET Minor Group associated with the person's current job title.
Person Job Last Verified Datejob_last_verifiedDate (String)-The timestamp reflecting when the top-level current job information was last validated by a data source.
Person Job O*NET Major Groupjob_onet_major_groupString-The O*NET Major Group associated with the person's current job title.
Profile NetworknetworkEnum (String)-The social network the profile is on.
Profile Last Seen Datelast_seenDate (String)-The date this profile was last associated with the Person record.
Person Profiles ObjectprofilesArray of Objects-PARENT: Social profiles associated with the person across all covered networks.
Profile IDidString-The profile ID (format varies based on social network).
Person HeadlineheadlineString-Short professional tagline for the person (e.g. "Founder & CEO at Apollo"), distinct from their job title.
Person Location Street Addresslocation_street_addressString-The person's current street address.
Person Current Company HQ Street Addressjob_company_location_street_addressString-The person's current company's headquarters' street address.
Email TypetypeEnum (String)-Classification of an email address (e.g. work, personal).
Certification OrganizationorganizationString-The organization awarding the certification.
Person Current Company Facebook URLjob_company_facebook_urlURL (String)-The person's current company's Facebook URL.
Education Start Datestart_dateDate (String)-Start date/time of an education record.
Education End Dateend_dateDate (String)-End date/time of an education record.
LinkedIn URLlinkedin_urlURL (String)-URL of the person's or company's LinkedIn profile.
Email AddressaddressString-The fully parsed email address.
Person Job O*NET Broad Occupationjob_onet_broad_occupationString-The O*NET Broad Occupation associated with the person's current job title.
Person Location Names (All)location_namesArray of Strings-All location names associated with the person (current + historical).
Person LinkedIn Connections Countlinkedin_connectionsInteger-LinkedIn connections count for the individual.
Person LinkedIn CertificationscertificationsArray of Objects-PARENT: Professional certifications the person has (name, organization, start/end dates). PDL confirms this sub-structure; Lusha's original 'needs live verification' flag is resolved for PDL usage, though Lusha's own…
Person Name Aliasesname_aliasesArray of Strings-Any other names the person goes by, besides the primary name.
Person Middle Initialmiddle_initialString (1 character)-The first letter of the person's middle name.
PDL Person IDidString-A unique persistent identifier for the person (PDL hashed ID).
Person Middle Namemiddle_nameString-The person's middle name.
Email MD5 Hashmd5_hashString-A 128-bit hash of the email in md5 format.
Person Emails ObjectemailsArray of Objects-PARENT: Email addresses associated with the person, each with type and provenance metadata.
Phone Last Seen Datelast_seenDate (String)-The date this number was last associated with the Person record.
Phone Num Sourcesnum_sourcesInteger-The number of sources that have contributed to the association of this number with the Person record.
Person Phone Numbersphone_numbersArray of Strings-All phone numbers associated with the person.
Phone First Seen Datefirst_seenDate (String)-The date this number was first associated with the Person record.
Person Phones ObjectphonesArray of Objects-PARENT: Phone numbers associated with the person, with provenance metadata.
Person Work Emailwork_emailString-The person's current work email.
Person Personal Emailspersonal_emailsArray of Strings-All personal emails associated with the person (subset of emails tagged type=personal).
Person Current Company 12-Month Employee Growth Ratejob_company_12mo_employee_growth_rateNumber (Decimal)-The person's current company's percentage increase in total headcount over the past 12 months.
Job History TitletitleString-Job title for the prior position.
Email SHA-256 Hashsha_256_hashString-A 256-bit hash of the email in sha256 format.
Person Current Company Inferred Revenuejob_company_inferred_revenueEnum (String)-The estimated annual revenue range (USD) of the person's current company.
Person Current Company Industryjob_company_industryEnum (String)-The person's current company's industry.
Person Current Company PDL IDjob_company_idString-The person's current company's PDL ID.
Person Current Company Industry V2job_company_industry_v2Enum (String)-The v2 (expanded canonical list) industry for the person's current company.
Person Current Company LinkedIn IDjob_company_linkedin_idString-The person's current company's LinkedIn ID.
Person Current Company Founded Yearjob_company_foundedInteger-The person's current company's founding year.
Person Current Company HQ Address Line 2job_company_location_address_line_2String-The person's current company's headquarters' street address line 2.
Person Current Company Employee Countjob_company_employee_countInteger-The total number of PDL profiles associated with the person's current company.
Person Current Company HQ Countryjob_company_location_countryEnum (String)-The person's current company's headquarters' country.
Person Current Company HQ Localityjob_company_location_localityString-The person's current company's headquarters' locality (city/town).
Person Current Company HQ Postal Codejob_company_location_postal_codeString-The person's current company's headquarters' postal code.
Person Current Company HQ Continentjob_company_location_continentEnum (String)-The person's current company's headquarters' continent.
Person Current Company HQ Metrojob_company_location_metroEnum (String)-The person's current company's headquarters' metro area.
Person Current Company HQ Location Namejob_company_location_nameString-The person's current company's headquarters' combined location name.
Email First Seen Datefirst_seenDate (String)-The date this email was first associated with the Person record.
Person Current Company Tickerjob_company_tickerString-The stock ticker for the person's current company (only populated if company type is public).
Person Current Company Twitter URLjob_company_twitter_urlURL (String)-The person's current company's Twitter/X URL.
Person Job Last Changed Datejob_last_changedDate (String)-The timestamp reflecting when the top-level current job information changed (observed data; may lag real life).
Person Current Company Total Funding Raisedjob_company_total_funding_raisedInteger-The cumulative amount of money raised (USD) by the person's current company across all publicly disclosed funding rounds.
Person Current Company Size Rangejob_company_sizeEnum (String)-The person's current company's self-reported size range.
Person Job Start Datejob_start_dateDate (String)-The date the person started their current job.
Person Current Job Title Levelsjob_title_levelsArray of Strings-The derived seniority level(s) of the person's current job title (e.g. cxo, vp, manager).
Person Language NamenameEnum (String)-The language.
Person Current Job Title Classjob_title_classEnum (String)-The expense line item category the person's current job would fall into.
Person Current Job Title Rolejob_title_roleEnum (String)-The derived canonical role of the person's current job title.
Person Language ProficiencyproficiencyInteger (1-5)-Self-ranked language proficiency from 1 (limited) to 5 (fluent).
Person Birth Yearbirth_yearInteger-The year the person was born.
Person Current Job Summaryjob_summaryString-User-inputted summary of the person's current job.
Person Languages ObjectlanguagesArray of Objects-PARENT: Languages the person knows, with self-ranked proficiency.
Person Current Job Title Sub-Rolejob_title_sub_roleEnum (String)-The derived canonical sub-role of the person's current job title.
Person Current Job Titlejob_titleString-The person's current job title.
Education School DomaindomainString-The primary website domain associated with the school.
Education Raw DatarawArray of Strings-Raw education data parsed into the degrees, majors, and minors fields.
Education School LinkedIn IDlinkedin_idString-The school's LinkedIn ID.
Education School Facebook URLfacebook_urlURL (String)-The school's Facebook URL.
Education GPAgpaFloat-The GPA the person earned at the school.
Education School LinkedIn URLlinkedin_urlURL (String)-The school's LinkedIn URL.
Education DegreesdegreesArray of Strings-The degrees the person earned at the school.
Person Education ObjecteducationArray of Objects-PARENT: The person's education history (school, degrees, majors/minors, dates, GPA).
Education MinorsminorsArray of Strings-All minors the person earned at the school.
Education School Location ObjectlocationObject-PARENT: The location of the school (continent, country, locality, region, name).
Education School Location ContinentcontinentEnum (String)-The continent the school is in.
Education School Location CountrycountryEnum (String)-The country the school is in.
Education School Location RegionregionString-The region the school is in.
Education School WebsitewebsiteString-The website URL associated with the school.
Education School Raw NamerawArray of Strings-Raw school name.
Education School NamenameString-The name of the school.
Education School Location NamenameString-Combined cleaned location name for the school (locality, region, country).
Person Location Countrylocation_countryEnum (String)-The country of the person's current address.
Person Location Countries (All)countriesArray of Strings-All countries associated with the person.
Person Location Postal Codelocation_postal_codeString-The postal code of the person's current address.
Person Location Continentlocation_continentEnum (String)-The continent of the person's current address.
Person Location Metrolocation_metroEnum (String)-The metro area of the person's current address.
Person Street Address Locality (Historical)localityString-Locality for this address entry.
Person Street Address Country (Historical)countryEnum (String)-Country for this address entry.
Person Street Address Last Seen Datelast_seenDate (String)-The date this address was last associated with the Person record.
Person Street Address Geo (Historical)geoString-City-center geo coordinates for this address entry.
Person Location Regions (All)regionsArray of Strings-All administrative regions associated with the person.
Person Street Address First Seen Datefirst_seenDate (String)-The date this address was first associated with the Person record.
Person Street Address Line 2 (Historical)address_line_2String-Street address line 2 for this address entry.
Person Street Address Continent (Historical)continentEnum (String)-Continent for this address entry.
Person Street Addresses Objectstreet_addressesArray of Objects-PARENT: All street addresses associated with the person, with provenance metadata.
Person Street Address Region (Historical)regionString-Region for this address entry.
Person Street Address Metro (Historical)metroEnum (String)-Metro area for this address entry.
Person Street Address Location Name (Historical)nameString-Combined cleaned location name for this address entry.
Possible Email AddressaddressString-The fully parsed lower-confidence email address.
Possible Email First Seen Datefirst_seenDate (String)-The date this possible email was first associated with the Person record.
Person Possible Phones Objectpossible_phonesArray of Objects-PARENT: Lower-confidence phone numbers associated with the person.
Possible Phone Last Seen Datelast_seenDate (String)-The date this possible phone number was last associated with the Person record.
Possible Email Num Sourcesnum_sourcesInteger-Number of sources contributing to this possible email's association.
Possible Phone NumbernumberPhone (String)-The lower-confidence phone number.
Possible Phone Num Sourcesnum_sourcesInteger-Number of sources contributing to this possible phone number's association.
Possible Email TypetypeEnum (String)-The type of the possible email address.
Possible Phone First Seen Datefirst_seenDate (String)-The date this possible phone number was first associated with the Person record.
Person Facebook Usernamefacebook_usernameString-The person's Facebook profile username based on source agreement.
Possible Profile Num Sourcesnum_sourcesInteger-Number of sources contributing to this possible profile's association.
Possible Profile First Seen Datefirst_seenDate (String)-The date this possible profile was first associated with the Person record.
Person Facebook IDfacebook_idString-The person's Facebook profile ID based on source agreement.
Possible Profile IDidString-The possible profile ID (format varies by network).
Person Possible Street Addresses Objectpossible_street_addressesArray of Objects-PARENT: Lower-confidence street addresses associated with the person (same shape as street_addresses).
Person Facebook Friends Countfacebook_friendsInteger-The number of Facebook friends the person has.
Possible Profile Last Seen Datelast_seenDate (String)-The date this possible profile was last associated with the Person record.
Possible Profile NetworknetworkEnum (String)-The social network of the possible profile.
Possible Profile UsernameusernameString-The possible profile username.
Person GitHub Usernamegithub_usernameString-The person's GitHub profile username based on source agreement.
Person LinkedIn Usernamelinkedin_usernameString-The person's LinkedIn profile username. Null when no values in the profiles array are active.
Person LinkedIn IDlinkedin_idString-The person's LinkedIn profile ID. Null when no values in the profiles array are active.
Profile Score Has Valid URL Signalhas_valid_urlFloat-Signal indicating whether the profile has a valid LinkedIn URL (1=valid, 0.5=unknown, 0=invalid).
Profile Score Meets Connection Threshold Signalmeets_connection_thresholdInteger-Signal indicating whether the profile meets PDL's LinkedIn connection threshold.
Profile UsernameusernameString-The profile username.
Person Twitter Usernametwitter_usernameString-The person's Twitter/X profile username based on source agreement.
Profile URLurlURL (String)-The profile URL.
Profile Num Sourcesnum_sourcesInteger-Number of sources contributing to this profile's association.
Person Profile Scoreprofile_scoreString-A PDL-generated signal indicating how likely a profile is to represent a real person (positive/neutral/negative signals). Resume Slice only.
Person Profile Score Factors Objectprofile_score_factorsObject-PARENT: Supporting factors used to generate profile_score. Resume Slice only, premium bundle.
Person Activity Score Factors Objectactivity_score_factorsObject-PARENT: Supporting factors used to generate activity_score. Resume Slice only, premium bundle.
Certification Start Datestart_dateDate (String)-The date the certification was awarded.
Activity Score Profile Change Signalprofile_changeInteger-Signal indicating whether PDL has observed user-edited profile changes recently.
Certification NamenameString-The certification name.
Person Activity Scoreactivity_scoreString-A PDL-generated signal indicating how likely a profile is to be actively maintained (positive/neutral/negative signals). Resume Slice only.
Person Experience ObjectexperienceArray of Objects-PARENT: The person's work experience history (company, title, dates, primary flag).
Activity Score Connection Change Signalconnection_changeFloat-Signal indicating whether PDL has observed changes in the profile's LinkedIn connection count.
Certification End Dateend_dateDate (String)-The expiration date of the certification.
Experience Company LinkedIn URLlinkedin_urlURL (String)-The experience company's LinkedIn URL.
Experience Company IndustryindustryEnum (String)-The experience company's self-identified industry.
Experience Company HQ ContinentcontinentEnum (String)-Continent of the experience company HQ.
Experience Company Facebook URLfacebook_urlURL (String)-The experience company's Facebook URL.
Experience Company Industry V2industry_v2Enum (String)-The v2 industry for the experience company.
Experience Company LinkedIn IDlinkedin_idString-The experience company's LinkedIn ID.
Experience Company Founded YearfoundedInteger-The experience company's founding year.
Experience Company Location ObjectlocationObject-PARENT: The location of the experience company's headquarters.
Experience Company PDL IDidString-The experience company's PDL ID.
Experience Company HQ MetrometroEnum (String)-Metro area of the experience company HQ.
Experience Company Size RangesizeEnum (String)-The experience company's self-reported size range.
Experience Company HQ Postal Codepostal_codeString-Postal code of the experience company HQ.
Experience Company HQ Geo CoordinatesgeoString-City-center geo coordinates of the experience company HQ.
Experience Company HQ RegionregionString-Region of the experience company HQ.
Experience Company HQ LocalitylocalityString-Locality of the experience company HQ.
Experience Company NamenameString-The experience company's name, cleaned and standardized.
Experience First Seen Datefirst_seenDate (String)-The date this experience entry was first associated with the Person record.
Experience Company TypetypeEnum (String)-The experience company's type (e.g. public, private).
Experience Last Seen Datelast_seenDate (String)-The date this experience entry was last associated with the Person record.
Experience End Dateend_dateDate (String)-The date the person left the company for this experience entry (null if still working there).
Experience Location Nameslocation_namesArray of Strings-Locations where the person worked while with this company.
Experience Company TickertickerString-The experience company's ticker (only if type is public).
Experience Company Twitter URLtwitter_urlURL (String)-The experience company's Twitter/X URL.
Experience Company WebsitewebsiteString-The experience company's primary website, cleaned and standardized.
Experience Num Sourcesnum_sourcesInteger-Number of sources contributing to this experience entry's association.
Experience Title LevelslevelsArray of Strings-The seniority level(s) of the job title for this experience entry.
Person Inferred Years Experienceinferred_years_experienceInteger (0-100)-The person's inferred total years of work experience.
Person IndustryindustryEnum (String)-The most relevant industry for this person based on their tagged personal industries and work history.
Experience Title Sub-Rolesub_roleEnum (String)-The canonical sub-role for this experience entry's job title.
Experience Title ObjecttitleObject-PARENT: The person's job title while at the company for this experience entry.
Experience Title NamenameString-The cleaned job title for this experience entry.
Person InterestsinterestsArray of Strings-The person's self-reported interests (cleaned, deduplicated free text).
Experience Title RoleroleEnum (String)-The canonical role for this experience entry's job title.
Experience Title ClassclassEnum (String)-The expense line item category for this experience entry's job title.
Person Dataset Versiondataset_versionString-The major or minor PDL dataset release version this record reflects.
Job History Num Sourcesnum_sourcesInteger-Number of sources contributing to this prior position's association.
Job History First Seen Datefirst_seenDate (String)-The date this prior position was first associated with the Person record.
Job History Company Namecompany_nameString-Company name for the prior position.
Person Job History Objectjob_historyArray of Objects-PARENT: Additional professional positions PDL has that may have been removed or changed on resumes (premium Person Risk Attributes bundle).
Person SummarysummaryString-The self-written summary tied to the person profile (often a LinkedIn summary).
Person Record First Seen Datefirst_seenDate (String)-The date when this PDL person record was first created in PDL's data.
Job History Last Seen Datelast_seenDate (String)-The date this prior position was last associated with the Person record.
Person Num Sourcesnum_sourcesInteger-The number of unique sources contributing to this specific PDL person profile.
Search Total Matching RecordstotalInteger-The total number of person records matching the search query across the entire dataset, not just the current page of results.
Search Scroll Tokenscroll_tokenString-An opaque token returned with a search response, used to retrieve the next page of results for the same search query.
Person Street Address Num Sourcesnum_sourcesInteger-Number of sources contributing to the association of this address with the Person record.
Profile First Seen Datefirst_seenDate (String)-The date this profile was first associated with the Person record.
Person Job O*NET Specific Occupation Detailjob_onet_specific_occupation_detailString-A more granular occupation detail for the person's current job title where O*NET's standard hierarchy isn't specific enough (e.g. type of C-suite executive).
Person Possible Location Namespossible_location_namesArray of Strings-Locations associated with this person that have a lower level of confidence (inferred from phone area codes, university location, etc).

More from People Data Labs

Person Search API (GET /v5/person/search) FAQ

What fields are in Person Search API (GET /v5/person/search)?

Person Search API (GET /v5/person/search) from People Data Labs has 249 fields, including Person Job O*NET Specific Occupation, Person Current Company Name and Person Possible Emails Object.

What do I need to match against Person Search API (GET /v5/person/search)?

Person Search API (GET /v5/person/search) matches on id.

How is Person Search API (GET /v5/person/search) priced?

Per-record. Request a quote or a sample on SpringDB.