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 .
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 apiKeystring Yes People Data Labs API key emailstring No Email address to match phonestring No Phone number (E.164 format preferred) profilestring No LinkedIn profile URL lidstring No LinkedIn numeric ID namestring No Full name (use as an alternative to first_name + last_name) first_namestring No First name (use with last_name + company or location) last_namestring No Last name companystring No Company name or website schoolstring No School name locationstring No Location name (city, region, or country) min_likelihoodnumber No Minimum match likelihood (1-10) requiredstring No Required-fields expression (e.g., "emails AND job_title") titlecaseboolean No Return name fields in title case
Parameter Type Description matchedboolean Whether a person record was matched likelihoodnumber Match likelihood score (1-10), null if no match personobject 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 apiKeystring Yes People Data Labs API key emailstring No Email phonestring No Phone number profilestring No LinkedIn profile URL email_hashstring No SHA-256 email hash lidstring No LinkedIn numeric ID namestring No Full name first_namestring No First name middle_namestring No Middle name last_namestring No Last name companystring No Company name or website schoolstring No School locationstring No Location street_addressstring No Street address localitystring No City regionstring No State/region countrystring No Country postal_codestring No Postal code birth_datestring No Birth date (YYYY-MM-DD) data_includestring No Comma-separated fields to include in each match include_if_matchedboolean No Include matched_on for each match titlecaseboolean No Return name fields in title case
Parameter Type Description matchesarray 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 apiKeystring Yes People Data Labs API key sqlstring No PDL SQL query (e.g., "SELECT * FROM person WHERE job_title='engineer' AND location_country='united states'") querystring No Elasticsearch DSL query as JSON string. Use either sql or query, not both. sizenumber No Number of results to return (1-100, default 1) scroll_tokenstring No Pagination token returned from a prior response datasetstring No Dataset filter: all, resume, email, phone, mobile_phone, street_address, consumer_social, developer (combinable with commas, exclude with - prefix) titlecaseboolean No Return name fields in title case
Parameter Type Description totalnumber Total matching records in dataset scroll_tokenstring Pagination token to fetch the next page; null if no more results resultsarray 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 apiKeystring Yes People Data Labs API key requestsstring Yes JSON array of request objects, max 100. Each item: { "params": { email | profile | first_name+last_name+company | ... }, "metadata": {...optional...} } requiredstring No Required-fields expression applied globally to every request
Parameter Type Description resultsarray 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 apiKeystring Yes People Data Labs API key namestring No Company name websitestring No Company website domain profilestring No LinkedIn company URL tickerstring No Stock ticker pdl_idstring No PDL company ID locationstring No Company location (helps disambiguate) localitystring No City regionstring No State/region countrystring No Country min_likelihoodnumber No Minimum match likelihood (1-10) requiredstring No Required-fields expression titlecaseboolean No Return name fields in title case
Parameter Type Description matchedboolean Whether a company record was matched likelihoodnumber Match likelihood score (1-10), null if no match companyobject 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 apiKeystring Yes People Data Labs API key sqlstring No PDL SQL query (e.g., "SELECT * FROM company WHERE industry='computer software' AND size='51-200'") querystring No Elasticsearch DSL query as JSON string sizenumber No Number of results to return (1-100, default 1) scroll_tokenstring No Pagination token returned from a prior response titlecaseboolean No Return name fields in title case
Parameter Type Description totalnumber Total matching companies in dataset scroll_tokenstring Pagination token to fetch the next page; null if no more results resultsarray 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 apiKeystring Yes People Data Labs API key requestsstring Yes JSON array of request objects, max 100. Each item: { "params": { name | website | profile | ticker | pdl_id }, "metadata": {...optional...} } requiredstring No Required-fields expression applied globally to every request
Parameter Type Description resultsarray 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 apiKeystring Yes People Data Labs API key namestring No Raw company name to normalize websitestring No Company website profilestring No LinkedIn company URL
Parameter Type Description matchedboolean Whether the input was matched to a known company companyobject 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 apiKeystring Yes People Data Labs API key locationstring Yes Raw location string (e.g., "SF, CA")
Parameter Type Description matchedboolean Whether the input was matched to a known location locationobject 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 apiKeystring Yes People Data Labs API key namestring No Raw school name to normalize websitestring No School website profilestring No LinkedIn school URL
Parameter Type Description matchedboolean Whether the input was matched to a known school schoolobject 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 apiKeystring Yes People Data Labs API key fieldstring Yes Field to autocomplete: all_location, class, company, country, industry, location_name, major, region, role, school, sub_role, skill, title, website textstring No Search text prefix sizenumber No Number of suggestions to return (1-100, default 10) titlecaseboolean No Return name fields in title case
Parameter Type Description suggestionsarray Autocomplete suggestions ordered by frequency