People Data Labs

People Data Labs provides person and company data. The Studio block exposes the core REST endpoints so agents can enrich a single contact, look up a company, or run dataset-wide search queries.

Use this block to:

  • Person Enrich — resolve a single person by email, phone, LinkedIn URL, or name + company/location, and pull back their work history, contact info, and skills.
  • Person Search — run SQL or Elasticsearch DSL queries against the person dataset to build prospect lists or audience segments.
  • Company Enrich — resolve a single company by name, website, ticker, LinkedIn URL, or PDL ID, and pull back firmographics.
  • Company Search — query the company dataset with SQL or Elasticsearch DSL.
  • Autocomplete — get suggested values for fields like title, skill, industry, or location to build well-formed search queries.

Authentication uses an API key passed as the X-Api-Key header. Get a key from the PDL dashboard.

Usage Instructions

Enrich a single person or company with People Data Labs, or search the global person and company datasets with SQL or Elasticsearch DSL. Useful for sales enrichment, contact lookup, and CRM hygiene.

Actions

PDL Person Enrich

Enrich a single person profile using People Data Labs. Match by email, phone, LinkedIn URL, or name + company/location. Returns work history, contact details, location, and skills.

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
emailstringNoEmail address to match
phonestringNoPhone number (E.164 format preferred)
profilestringNoLinkedIn profile URL
lidstringNoLinkedIn numeric ID
namestringNoFull name (use as an alternative to first_name + last_name)
first_namestringNoFirst name (use with last_name + company or location)
last_namestringNoLast name
companystringNoCompany name or website
schoolstringNoSchool name
locationstringNoLocation name (city, region, or country)
min_likelihoodnumberNoMinimum match likelihood (1-10)
requiredstringNoRequired-fields expression (e.g., "emails AND job_title")
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
matchedbooleanWhether a person record was matched
likelihoodnumberMatch likelihood score (1-10), null if no match
personobjectMatched person record
↳ idstringPDL person ID
↳ full_namestringFull name
↳ first_namestringFirst name
↳ last_namestringLast name
↳ genderstringGender
↳ birth_yearnumberBirth year
↳ linkedin_urlstringLinkedIn profile URL
↳ linkedin_usernamestringLinkedIn username
↳ twitter_urlstringTwitter profile URL
↳ github_urlstringGitHub profile URL
↳ facebook_urlstringFacebook profile URL
↳ work_emailstringPrimary work email
↳ personal_emailsarrayPersonal email addresses
↳ emailsarrayAll known email addresses
↳ phone_numbersarrayKnown phone numbers
↳ mobile_phonestringMobile phone number
↳ job_titlestringCurrent job title
↳ job_title_rolestringNormalized job role
↳ job_title_sub_rolestringNormalized job sub-role
↳ job_title_levelsarraySeniority levels (e.g., manager, director)
↳ job_company_namestringCurrent employer name
↳ job_company_websitestringCurrent employer website
↳ job_company_industrystringCurrent employer industry
↳ job_company_sizestringCurrent employer size band
↳ job_company_linkedin_urlstringCurrent employer's LinkedIn URL
↳ job_start_datestringStart date at current employer (YYYY-MM)
↳ location_namestringFull location name
↳ location_localitystringCity
↳ location_regionstringState/region
↳ location_countrystringCountry
↳ location_continentstringContinent
↳ industrystringIndustry
↳ skillsarraySkills
↳ interestsarrayInterests
↳ experiencearrayWork history entries
↳ educationarrayEducation history

PDL Person Identify

Return up to 20 candidate person matches with confidence scores. Useful when you want to see all plausible matches rather than the single best one. Reference: https://docs.peopledatalabs.com/docs/identify-api-quickstart

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
emailstringNoEmail
phonestringNoPhone number
profilestringNoLinkedIn profile URL
email_hashstringNoSHA-256 email hash
lidstringNoLinkedIn numeric ID
namestringNoFull name
first_namestringNoFirst name
middle_namestringNoMiddle name
last_namestringNoLast name
companystringNoCompany name or website
schoolstringNoSchool
locationstringNoLocation
street_addressstringNoStreet address
localitystringNoCity
regionstringNoState/region
countrystringNoCountry
postal_codestringNoPostal code
birth_datestringNoBirth date (YYYY-MM-DD)
data_includestringNoComma-separated fields to include in each match
include_if_matchedbooleanNoInclude matched_on for each match
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
matchesarrayUp to 20 candidate matches, ordered by score

Search the People Data Labs person dataset using SQL or Elasticsearch DSL. Returns up to 100 matching records per call.

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
sqlstringNoPDL SQL query (e.g., "SELECT * FROM person WHERE job_title='engineer' AND location_country='united states'")
querystringNoElasticsearch DSL query as JSON string. Use either sql or query, not both.
sizenumberNoNumber of results to return (1-100, default 1)
scroll_tokenstringNoPagination token returned from a prior response
datasetstringNoDataset filter: all, resume, email, phone, mobile_phone, street_address, consumer_social, developer (combinable with commas, exclude with - prefix)
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
totalnumberTotal matching records in dataset
scroll_tokenstringPagination token to fetch the next page; null if no more results
resultsarrayPerson records matching the query
↳ idstringPDL person ID
↳ full_namestringFull name
↳ first_namestringFirst name
↳ last_namestringLast name
↳ genderstringGender
↳ birth_yearnumberBirth year
↳ linkedin_urlstringLinkedIn profile URL
↳ linkedin_usernamestringLinkedIn username
↳ twitter_urlstringTwitter profile URL
↳ github_urlstringGitHub profile URL
↳ facebook_urlstringFacebook profile URL
↳ work_emailstringPrimary work email
↳ personal_emailsarrayPersonal email addresses
↳ emailsarrayAll known email addresses
↳ phone_numbersarrayKnown phone numbers
↳ mobile_phonestringMobile phone number
↳ job_titlestringCurrent job title
↳ job_title_rolestringNormalized job role
↳ job_title_sub_rolestringNormalized job sub-role
↳ job_title_levelsarraySeniority levels (e.g., manager, director)
↳ job_company_namestringCurrent employer name
↳ job_company_websitestringCurrent employer website
↳ job_company_industrystringCurrent employer industry
↳ job_company_sizestringCurrent employer size band
↳ job_company_linkedin_urlstringCurrent employer's LinkedIn URL
↳ job_start_datestringStart date at current employer (YYYY-MM)
↳ location_namestringFull location name
↳ location_localitystringCity
↳ location_regionstringState/region
↳ location_countrystringCountry
↳ location_continentstringContinent
↳ industrystringIndustry
↳ skillsarraySkills
↳ interestsarrayInterests
↳ experiencearrayWork history entries
↳ educationarrayEducation history

PDL Bulk Person Enrich

Enrich up to 100 person records in a single call. Provide a JSON array of request objects, each with a params object (and optional metadata echoed back). Reference: https://docs.peopledatalabs.com/docs/bulk-person-enrichment-api

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
requestsstringYesJSON array of request objects, max 100. Each item: { "params": { email | profile | first_name+last_name+company | ... }, "metadata": {...optional...} }
requiredstringNoRequired-fields expression applied globally to every request

Output

ParameterTypeDescription
resultsarrayPer-record results in the same order as the input requests

PDL Company Enrich

Enrich a single company using People Data Labs. Match by name, website, LinkedIn URL, ticker, or PDL ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
namestringNoCompany name
websitestringNoCompany website domain
profilestringNoLinkedIn company URL
tickerstringNoStock ticker
pdl_idstringNoPDL company ID
locationstringNoCompany location (helps disambiguate)
localitystringNoCity
regionstringNoState/region
countrystringNoCountry
min_likelihoodnumberNoMinimum match likelihood (1-10)
requiredstringNoRequired-fields expression
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
matchedbooleanWhether a company record was matched
likelihoodnumberMatch likelihood score (1-10), null if no match
companyobjectMatched company record
↳ idstringPDL company ID
↳ namestringCompany name
↳ display_namestringDisplay name
↳ websitestringWebsite domain
↳ tickerstringStock ticker
↳ typestringCompany type (public, private, etc.)
↳ industrystringIndustry
↳ sizestringEmployee size band
↳ employee_countnumberEstimated employee count
↳ foundednumberYear founded
↳ headlinestringCompany headline/tagline
↳ summarystringCompany description
↳ linkedin_urlstringLinkedIn URL
↳ linkedin_idstringLinkedIn ID
↳ twitter_urlstringTwitter URL
↳ facebook_urlstringFacebook URL
↳ location_namestringHQ location name
↳ location_localitystringHQ city
↳ location_regionstringHQ state/region
↳ location_countrystringHQ country
↳ tagsarrayCompany tags
↳ tickersarrayAll stock tickers

Search the People Data Labs company dataset using SQL or Elasticsearch DSL. Returns up to 100 matching companies per call.

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
sqlstringNoPDL SQL query (e.g., "SELECT * FROM company WHERE industry='computer software' AND size='51-200'")
querystringNoElasticsearch DSL query as JSON string
sizenumberNoNumber of results to return (1-100, default 1)
scroll_tokenstringNoPagination token returned from a prior response
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
totalnumberTotal matching companies in dataset
scroll_tokenstringPagination token to fetch the next page; null if no more results
resultsarrayCompany records matching the query
↳ idstringPDL company ID
↳ namestringCompany name
↳ display_namestringDisplay name
↳ websitestringWebsite domain
↳ tickerstringStock ticker
↳ typestringCompany type (public, private, etc.)
↳ industrystringIndustry
↳ sizestringEmployee size band
↳ employee_countnumberEstimated employee count
↳ foundednumberYear founded
↳ headlinestringCompany headline/tagline
↳ summarystringCompany description
↳ linkedin_urlstringLinkedIn URL
↳ linkedin_idstringLinkedIn ID
↳ twitter_urlstringTwitter URL
↳ facebook_urlstringFacebook URL
↳ location_namestringHQ location name
↳ location_localitystringHQ city
↳ location_regionstringHQ state/region
↳ location_countrystringHQ country
↳ tagsarrayCompany tags
↳ tickersarrayAll stock tickers

PDL Bulk Company Enrich

Enrich up to 100 companies in a single call. Provide a JSON array of request objects, each with a params object. Reference: https://docs.peopledatalabs.com/docs/bulk-company-enrichment-api

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
requestsstringYesJSON array of request objects, max 100. Each item: { "params": { name | website | profile | ticker | pdl_id }, "metadata": {...optional...} }
requiredstringNoRequired-fields expression applied globally to every request

Output

ParameterTypeDescription
resultsarrayPer-record results in the same order as the input requests

PDL Company Cleaner

Normalize a company string into a canonical company record. Provide at least one of name, website, or profile (LinkedIn URL).

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
namestringNoRaw company name to normalize
websitestringNoCompany website
profilestringNoLinkedIn company URL

Output

ParameterTypeDescription
matchedbooleanWhether the input was matched to a known company
companyobjectCanonical company record
↳ idstringPDL company ID
↳ namestringCompany name
↳ display_namestringDisplay name
↳ websitestringWebsite domain
↳ tickerstringStock ticker
↳ typestringCompany type (public, private, etc.)
↳ industrystringIndustry
↳ sizestringEmployee size band
↳ employee_countnumberEstimated employee count
↳ foundednumberYear founded
↳ headlinestringCompany headline/tagline
↳ summarystringCompany description
↳ linkedin_urlstringLinkedIn URL
↳ linkedin_idstringLinkedIn ID
↳ twitter_urlstringTwitter URL
↳ facebook_urlstringFacebook URL
↳ location_namestringHQ location name
↳ location_localitystringHQ city
↳ location_regionstringHQ state/region
↳ location_countrystringHQ country
↳ tagsarrayCompany tags
↳ tickersarrayAll stock tickers

PDL Location Cleaner

Normalize a freeform location string into a structured locality/region/country record with coordinates.

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
locationstringYesRaw location string (e.g., "SF, CA")

Output

ParameterTypeDescription
matchedbooleanWhether the input was matched to a known location
locationobjectCanonical location record
↳ namestringNormalized location name
↳ localitystringCity
↳ regionstringState/region
↳ subregionstringSubregion (e.g., county)
↳ countrystringCountry
↳ continentstringContinent
↳ typestringLocation type
↳ geostringLatitude,longitude string

PDL School Cleaner

Normalize a school string into a canonical school record. Provide at least one of name, website, or profile (LinkedIn URL).

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
namestringNoRaw school name to normalize
websitestringNoSchool website
profilestringNoLinkedIn school URL

Output

ParameterTypeDescription
matchedbooleanWhether the input was matched to a known school
schoolobjectCanonical school record
↳ idstringPDL school ID
↳ namestringSchool name
↳ typestringSchool type (e.g., university, secondary)
↳ websitestringWebsite domain
↳ linkedin_urlstringLinkedIn URL
↳ linkedin_idstringLinkedIn ID
↳ facebook_urlstringFacebook URL
↳ twitter_urlstringTwitter URL
↳ domainstringSchool domain
↳ location_namestringLocation name
↳ location_localitystringCity
↳ location_regionstringState/region
↳ location_countrystringCountry
↳ location_continentstringContinent

PDL Autocomplete

Get autocomplete suggestions for a PDL field (title, skill, company, industry, location, school, major, role, sub_role).

Input

ParameterTypeRequiredDescription
apiKeystringYesPeople Data Labs API key
fieldstringYesField to autocomplete: all_location, class, company, country, industry, location_name, major, region, role, school, sub_role, skill, title, website
textstringNoSearch text prefix
sizenumberNoNumber of suggestions to return (1-100, default 10)
titlecasebooleanNoReturn name fields in title case

Output

ParameterTypeDescription
suggestionsarrayAutocomplete suggestions ordered by frequency