People Data Labs

People Data Labs

This connector calls the People Data Labs API (https://api.peopledatalabs.com/v5) with the user's own API key: person and company enrichment, person identification, person and company search with SQL or Elasticsearch, IP-to-company enrichment, job title enrichment, and the free cleaner and autocomplete helpers.

Personal data and GDPR. Person results describe real people: names, employers, work history, locations and, depending on the plan, emails and phone numbers. Use them only for a legitimate purpose the user can justify (for example B2B sales or recruiting under legitimate interest), keep only what is needed, and remember that people in the EU have the right to be informed and to object. Do not look up private individuals out of curiosity, and do not combine results to profile someone beyond the user's stated purpose.

Every lookup can cost credits. PDL bills from the account's monthly credits (Free plan: up to 100 a month; Pro from $98 a month with 350 credits and up), separately per API:

• Person and company enrichment, IP enrichment and job title enrichment: 1 credit only when a match is found (HTTP 200). A 404 means no match and is free.
• Person identify: 1 credit per call, also when nothing is found (404), whatever the number of profiles returned.
• Person and company search: 1 credit per record returned. size defaults to 1 here; check total before asking for more.
• Company, location and school cleaners and autocomplete: free (cleaners up to 10,000 calls a month; autocomplete 1,000 a day on self-serve). Ask the user before a search with a large size or a long series of lookups.

Setup (about 2 minutes)

1. Sign up at https://dashboard.peopledatalabs.com (the Free plan needs no card).
2. Open API Keys in the dashboard and copy the key.
3. Paste it into PEOPLE_DATA_LABS_API_KEY and install. It is sent as the X-Api-Key header and only to People Data Labs.

Which tool

• people_data_labs_enrich_person: one person from an email, phone (+country code), LinkedIn URL, or a name plus company, school or location. Raise min_likelihood when inputs are thin, use required (e.g. emails) to only pay for matches that have what the user needs, and data_include to keep the answer short.
• people_data_labs_identify_person: up to 20 candidates for loose inputs; costs a credit even without a result.
• people_data_labs_search_people and people_data_labs_search_companies: lists by criteria, with sql (SELECT * FROM person WHERE ...) or an Elasticsearch query. Values in PDL are lower case. Use people_data_labs_autocomplete and the cleaners to find the exact values first (titles, companies, locations), and scroll_token for the next page.
• people_data_labs_enrich_company: one company from website, name, profile or ticker.
• people_data_labs_enrich_ip: the company behind an IP address.
• people_data_labs_enrich_job_title: similar titles and skills for a title.
• people_data_labs_clean_company, people_data_labs_clean_location, people_data_labs_clean_school, people_data_labs_autocomplete: free helpers for canonical values.

Rate limits (defaults): enrichment 100 a minute on Free and 1,000 on paid plans (company enrichment 10 a minute on Free); identify, searches and cleaners 10 a minute.

Common errors (status and error.type, error.message in the body)

• 404 not_found: no match. Not an error of the request and, except for identify, not charged.
• 401 authentication_error: the key is wrong, revoked or missing.
• 402 payment_required: the credits of this API are used up for the month; upgrade or wait for the reset.
• 400 invalid_request_error: too few inputs (e.g. a name without company or location), a malformed SQL or Elasticsearch query, or an IP that belongs to a hosting provider or proxy.
• 429 rate_limit_error: too many calls a minute; wait and retry once.

Out of scope here: bulk enrichment, person changelog, job posting search, skill enrichment, preview APIs and the sandbox.