People Data Labs is a person and company data provider with a global dataset of 3B+ person profiles and 25M+ company records. 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.
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.
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.
| 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 |
| 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 |
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
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | People Data Labs API key |
email | string | No | No description |
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 | No description |
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 |
| Parameter | Type | Description |
|---|
matches | array | Up 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.
| 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 |
| 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 |
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
| 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 |
| Parameter | Type | Description |
|---|
results | array | Per-record results in the same order as the input requests |
Enrich a single company using People Data Labs. Match by name, website, LinkedIn URL, ticker, or PDL ID.
| 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 |
| 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 |
Search the People Data Labs company dataset using SQL or Elasticsearch DSL. Returns up to 100 matching companies per call.
| 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 |
| 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 |
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
| 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 |
| Parameter | Type | Description |
|---|
results | array | Per-record results in the same order as the input requests |
Normalize a company string into a canonical company record. Provide at least one of name, website, or profile (LinkedIn URL).
| 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 |
| 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 |
Normalize a freeform location string into a structured locality/region/country record with coordinates.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | People Data Labs API key |
location | string | Yes | Raw location string (e.g., "SF, CA") |
| 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 |
Normalize a school string into a canonical school record. Provide at least one of name, website, or profile (LinkedIn URL).
| 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 |
| 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 |
Get autocomplete suggestions for a PDL field (title, skill, company, industry, location, school, major, role, sub_role).
| 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 |
| Parameter | Type | Description |
|---|
suggestions | array | Autocomplete suggestions ordered by frequency |