People Data Labs

People Data Labs provides person and company data. The Sim 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.

Use the block

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.

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`email`	string	No	Email address to match
`phone`	string	No	Phone number (E.164 format preferred)
`profile`	string	No	LinkedIn profile URL
`lid`	string	No	LinkedIn numeric ID
`name`	string	No	Full name (use as an alternative to first_name + last_name)
`first_name`	string	No	First name (use with last_name + company or location)
`last_name`	string	No	Last name
`company`	string	No	Company name or website
`school`	string	No	School name
`location`	string	No	Location name (city, region, or country)
`min_likelihood`	number	No	Minimum match likelihood (1-10)
`required`	string	No	Required-fields expression (e.g., "emails AND job_title")
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`matched`	boolean	Whether a person record was matched
`likelihood`	number	Match likelihood score (1-10), null if no match
`person`	object	Matched person record
↳ `id`	string	PDL person ID
↳ `full_name`	string	Full name
↳ `first_name`	string	First name
↳ `last_name`	string	Last name
↳ `gender`	string	Gender
↳ `birth_year`	number	Birth year
↳ `linkedin_url`	string	LinkedIn profile URL
↳ `linkedin_username`	string	LinkedIn username
↳ `twitter_url`	string	Twitter profile URL
↳ `github_url`	string	GitHub profile URL
↳ `facebook_url`	string	Facebook profile URL
↳ `work_email`	string	Primary work email
↳ `personal_emails`	array	Personal email addresses
↳ `emails`	array	All known email addresses
↳ `phone_numbers`	array	Known phone numbers
↳ `mobile_phone`	string	Mobile phone number
↳ `job_title`	string	Current job title
↳ `job_title_role`	string	Normalized job role
↳ `job_title_sub_role`	string	Normalized job sub-role
↳ `job_title_levels`	array	Seniority levels (e.g., manager, director)
↳ `job_company_name`	string	Current employer name
↳ `job_company_website`	string	Current employer website
↳ `job_company_industry`	string	Current employer industry
↳ `job_company_size`	string	Current employer size band
↳ `job_company_linkedin_url`	string	Current employer's LinkedIn URL
↳ `job_start_date`	string	Start date at current employer (YYYY-MM)
↳ `location_name`	string	Full location name
↳ `location_locality`	string	City
↳ `location_region`	string	State/region
↳ `location_country`	string	Country
↳ `location_continent`	string	Continent
↳ `industry`	string	Industry
↳ `skills`	array	Skills
↳ `interests`	array	Interests
↳ `experience`	array	Work history entries
↳ `education`	array	Education 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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`email`	string	No	Email
`phone`	string	No	Phone number
`profile`	string	No	LinkedIn profile URL
`email_hash`	string	No	SHA-256 email hash
`lid`	string	No	LinkedIn numeric ID
`name`	string	No	Full name
`first_name`	string	No	First name
`middle_name`	string	No	Middle name
`last_name`	string	No	Last name
`company`	string	No	Company name or website
`school`	string	No	School
`location`	string	No	Location
`street_address`	string	No	Street address
`locality`	string	No	City
`region`	string	No	State/region
`country`	string	No	Country
`postal_code`	string	No	Postal code
`birth_date`	string	No	Birth date (YYYY-MM-DD)
`data_include`	string	No	Comma-separated fields to include in each match
`include_if_matched`	boolean	No	Include `matched_on` for each match
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`matches`	array	Up to 20 candidate matches, ordered by score

PDL Person Search

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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`sql`	string	No	PDL SQL query (e.g., "SELECT * FROM person WHERE job_title='engineer' AND location_country='united states'")
`query`	string	No	Elasticsearch DSL query as JSON string. Use either sql or query, not both.
`size`	number	No	Number of results to return (1-100, default 1)
`scroll_token`	string	No	Pagination token returned from a prior response
`dataset`	string	No	Dataset filter: all, resume, email, phone, mobile_phone, street_address, consumer_social, developer (combinable with commas, exclude with `-` prefix)
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`total`	number	Total matching records in dataset
`scroll_token`	string	Pagination token to fetch the next page; null if no more results
`results`	array	Person records matching the query
↳ `id`	string	PDL person ID
↳ `full_name`	string	Full name
↳ `first_name`	string	First name
↳ `last_name`	string	Last name
↳ `gender`	string	Gender
↳ `birth_year`	number	Birth year
↳ `linkedin_url`	string	LinkedIn profile URL
↳ `linkedin_username`	string	LinkedIn username
↳ `twitter_url`	string	Twitter profile URL
↳ `github_url`	string	GitHub profile URL
↳ `facebook_url`	string	Facebook profile URL
↳ `work_email`	string	Primary work email
↳ `personal_emails`	array	Personal email addresses
↳ `emails`	array	All known email addresses
↳ `phone_numbers`	array	Known phone numbers
↳ `mobile_phone`	string	Mobile phone number
↳ `job_title`	string	Current job title
↳ `job_title_role`	string	Normalized job role
↳ `job_title_sub_role`	string	Normalized job sub-role
↳ `job_title_levels`	array	Seniority levels (e.g., manager, director)
↳ `job_company_name`	string	Current employer name
↳ `job_company_website`	string	Current employer website
↳ `job_company_industry`	string	Current employer industry
↳ `job_company_size`	string	Current employer size band
↳ `job_company_linkedin_url`	string	Current employer's LinkedIn URL
↳ `job_start_date`	string	Start date at current employer (YYYY-MM)
↳ `location_name`	string	Full location name
↳ `location_locality`	string	City
↳ `location_region`	string	State/region
↳ `location_country`	string	Country
↳ `location_continent`	string	Continent
↳ `industry`	string	Industry
↳ `skills`	array	Skills
↳ `interests`	array	Interests
↳ `experience`	array	Work history entries
↳ `education`	array	Education 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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`requests`	string	Yes	JSON array of request objects, max 100. Each item: { "params": { email \| profile \| first_name+last_name+company \| ... }, "metadata": {...optional...} }
`required`	string	No	Required-fields expression applied globally to every request

Output

Parameter	Type	Description
`results`	array	Per-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.

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`name`	string	No	Company name
`website`	string	No	Company website domain
`profile`	string	No	LinkedIn company URL
`ticker`	string	No	Stock ticker
`pdl_id`	string	No	PDL company ID
`location`	string	No	Company location (helps disambiguate)
`locality`	string	No	City
`region`	string	No	State/region
`country`	string	No	Country
`min_likelihood`	number	No	Minimum match likelihood (1-10)
`required`	string	No	Required-fields expression
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`matched`	boolean	Whether a company record was matched
`likelihood`	number	Match likelihood score (1-10), null if no match
`company`	object	Matched company record
↳ `id`	string	PDL company ID
↳ `name`	string	Company name
↳ `display_name`	string	Display name
↳ `website`	string	Website domain
↳ `ticker`	string	Stock ticker
↳ `type`	string	Company type (public, private, etc.)
↳ `industry`	string	Industry
↳ `size`	string	Employee size band
↳ `employee_count`	number	Estimated employee count
↳ `founded`	number	Year founded
↳ `headline`	string	Company headline/tagline
↳ `summary`	string	Company description
↳ `linkedin_url`	string	LinkedIn URL
↳ `linkedin_id`	string	LinkedIn ID
↳ `twitter_url`	string	Twitter URL
↳ `facebook_url`	string	Facebook URL
↳ `location_name`	string	HQ location name
↳ `location_locality`	string	HQ city
↳ `location_region`	string	HQ state/region
↳ `location_country`	string	HQ country
↳ `tags`	array	Company tags
↳ `tickers`	array	All stock tickers

PDL Company Search

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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`sql`	string	No	PDL SQL query (e.g., "SELECT * FROM company WHERE industry='computer software' AND size='51-200'")
`query`	string	No	Elasticsearch DSL query as JSON string
`size`	number	No	Number of results to return (1-100, default 1)
`scroll_token`	string	No	Pagination token returned from a prior response
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`total`	number	Total matching companies in dataset
`scroll_token`	string	Pagination token to fetch the next page; null if no more results
`results`	array	Company records matching the query
↳ `id`	string	PDL company ID
↳ `name`	string	Company name
↳ `display_name`	string	Display name
↳ `website`	string	Website domain
↳ `ticker`	string	Stock ticker
↳ `type`	string	Company type (public, private, etc.)
↳ `industry`	string	Industry
↳ `size`	string	Employee size band
↳ `employee_count`	number	Estimated employee count
↳ `founded`	number	Year founded
↳ `headline`	string	Company headline/tagline
↳ `summary`	string	Company description
↳ `linkedin_url`	string	LinkedIn URL
↳ `linkedin_id`	string	LinkedIn ID
↳ `twitter_url`	string	Twitter URL
↳ `facebook_url`	string	Facebook URL
↳ `location_name`	string	HQ location name
↳ `location_locality`	string	HQ city
↳ `location_region`	string	HQ state/region
↳ `location_country`	string	HQ country
↳ `tags`	array	Company tags
↳ `tickers`	array	All 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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`requests`	string	Yes	JSON array of request objects, max 100. Each item: { "params": { name \| website \| profile \| ticker \| pdl_id }, "metadata": {...optional...} }
`required`	string	No	Required-fields expression applied globally to every request

Output

Parameter	Type	Description
`results`	array	Per-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).

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`name`	string	No	Raw company name to normalize
`website`	string	No	Company website
`profile`	string	No	LinkedIn company URL

Output

Parameter	Type	Description
`matched`	boolean	Whether the input was matched to a known company
`company`	object	Canonical company record
↳ `id`	string	PDL company ID
↳ `name`	string	Company name
↳ `display_name`	string	Display name
↳ `website`	string	Website domain
↳ `ticker`	string	Stock ticker
↳ `type`	string	Company type (public, private, etc.)
↳ `industry`	string	Industry
↳ `size`	string	Employee size band
↳ `employee_count`	number	Estimated employee count
↳ `founded`	number	Year founded
↳ `headline`	string	Company headline/tagline
↳ `summary`	string	Company description
↳ `linkedin_url`	string	LinkedIn URL
↳ `linkedin_id`	string	LinkedIn ID
↳ `twitter_url`	string	Twitter URL
↳ `facebook_url`	string	Facebook URL
↳ `location_name`	string	HQ location name
↳ `location_locality`	string	HQ city
↳ `location_region`	string	HQ state/region
↳ `location_country`	string	HQ country
↳ `tags`	array	Company tags
↳ `tickers`	array	All stock tickers

PDL Location Cleaner

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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`location`	string	Yes	Raw location string (e.g., "SF, CA")

Output

Parameter	Type	Description
`matched`	boolean	Whether the input was matched to a known location
`location`	object	Canonical location record
↳ `name`	string	Normalized location name
↳ `locality`	string	City
↳ `region`	string	State/region
↳ `subregion`	string	Subregion (e.g., county)
↳ `country`	string	Country
↳ `continent`	string	Continent
↳ `type`	string	Location type
↳ `geo`	string	Latitude,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).

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`name`	string	No	Raw school name to normalize
`website`	string	No	School website
`profile`	string	No	LinkedIn school URL

Output

Parameter	Type	Description
`matched`	boolean	Whether the input was matched to a known school
`school`	object	Canonical school record
↳ `id`	string	PDL school ID
↳ `name`	string	School name
↳ `type`	string	School type (e.g., university, secondary)
↳ `website`	string	Website domain
↳ `linkedin_url`	string	LinkedIn URL
↳ `linkedin_id`	string	LinkedIn ID
↳ `facebook_url`	string	Facebook URL
↳ `twitter_url`	string	Twitter URL
↳ `domain`	string	School domain
↳ `location_name`	string	Location name
↳ `location_locality`	string	City
↳ `location_region`	string	State/region
↳ `location_country`	string	Country
↳ `location_continent`	string	Continent

PDL Autocomplete

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

Inputs and outputs

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	People Data Labs API key
`field`	string	Yes	Field to autocomplete: all_location, class, company, country, industry, location_name, major, region, role, school, sub_role, skill, title, website
`text`	string	No	Search text prefix
`size`	number	No	Number of suggestions to return (1-100, default 10)
`titlecase`	boolean	No	Return name fields in title case

Output

Parameter	Type	Description
`suggestions`	array	Autocomplete suggestions ordered by frequency