People Data Labs · Enrichment

People Data Labs / Enrich a person

Returns People Data Labs' best matching person record. Send any identifying fields: name, email, phone, company, location, a profile URL or pdlid; minlikelihood sets how sure the match must be. Returns data with experience, education, locations and contact fields. Priced per match.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

birth_date query · optional
The person's birth date: either the year or a full birth date in the format YYYY-MM-DD. Example: "1996-10-01"
company query · optional
A name, website, or social url of a company where the person has worked. Example: "Amazon"
country query · optional
A country in which the person lives. Example: "United States"
data_include query · optional
A comma-separated string of fields that you would like the response to include. Begin the string with a - if you would instead like to exclude the specified fields. If you would like to exclude all data from being returned, use data_include="". Example: "full_name,emails.address"
email query · optional
An email the person has used. Example: "jane.doe@example.com"
email_hash query · optional
A SHA-256 or MD5 email hash. Example: "e206e6cd7fa5f9499fd6d2d943dcf7d9c1469bad351061483f5ce7181663b8d4"
first_name query · optional
The person's first name. Example: "Jane"
include_if_matched query · optional
If set to true, includes a top-level (alongside "data", "status", etc) field "matched" which includes a value for each queried field parameter that was "matched-on" during our internal query.
last_name query · optional
The person's last name. Example: "Doe"
lid query · optional
The person's LinkedIn ID. Example: "145991517"
locality query · optional
A locality in which the person lives. Example: "Boise"
location query · optional
A location in which a person lives. Example: "Medford, OR USA"
middle_name query · optional
The person's middle name. Example: "Cassandra"
min_likelihood query · optional
The minimum likelihood score that a response must have in order to count as a match
name query · optional
The person's full name, at least first and last. Example: "Jane Doe"
pdl_id query · optional
The PDL ID of the person to enrich. Example: "qEnOZ5Oh0poWnQ1luFBfVw_0000"
phone query · optional
A phone number the person has used. Example: "+1 555-234-1234"
postal_code query · optional
The postal code where the person lives. If there is no value for country, the postal code is assumed to be US. Example: "83701"
pretty query · optional
Whether the output should have human-readable indentation
profile query · optional
A social profile the person has used. https://docs.peopledatalabs.com/docs/social-networks. Example: "https://linkedin.com/in/example"
region query · optional
A state or region in which the person lives. Example: "Idaho"
required query · optional
The fields a response must have in order to count as a match. Example: "education AND (emails OR phone_numbers)"
school query · optional
A name, website, or social url of a university or college the person has attended. Example: "University of Iowa"
street_address query · optional
A street address in which the person lives. Example: "1234 Main Street"
titlecase query · optional
Setting titlecase to true will titlecase the person data in 200 responses.

Provider docs How to run it