Setup

If you haven't already, you'll need to signup for a to test the API by reaching out here. You'll be able to see your API Key, along with a few example API calls once you've logged into your dashboard.

The API is meant for enriching information on exactly one person. Every enrichment request returns exactly one person or no persons. When an enrichment request returns one person, we refer to that as a match. API usage is billed based on the number of matches.

We currently don't provide what we refer to as a "search" API, where we return multiple persons based on a query. We have many customers who re-create this functionality on their own by licensing the data.

Note:

• All sample API calls below are made with the pretty url param, which denotes whether the output should be pretty printed set to true.
• All of these example calls are using the /v5/person/enrich endpoint, which is our most current endpoint and provides the most data fields.
• For a complete list of fields you can search by, see here
• For high volume usage, use our bulk enrichment endpoint, which enables you to enrich data on up to 100 persons at a time.

Examples

Enrich on a social profile url

https://api.peopledatalabs.com/v5/person/enrich?pretty=true&api_key=xxxx&profile=www.linkedin.com/in/seanthorne

Enrich on an email

https://api.peopledatalabs.com/v5/person/enrich?pretty=true&api_key=xxxx&[email protected]

Enrich on name and a company

https://api.peopledatalabs.com/v5/person/enrich?pretty=true&api_key=xxxx&name=Sean Thorne&company=People Data Labs

Enrich on name and a phone number

https://api.peopledatalabs.com/v5/person/enrich?pretty=true&api_key=xxxx&name=Sean Thorne&phone=14155688415

Code

You can use anything that can make web requests. Generally we use Python. Here are some examples.

import requests
 
API_KEY = # YOUR API KEY
PDL_VERSION = "v5"
PDL_URL = f"https://api.peopledatalabs.com/{PDL_VERSION}/person/enrich"
 
 
params = {
   "api_key": API_KEY,
   "name": ["sean thorne"],
   "company": ["peopledatalabs.com"]
}
 
json_response = requests.get(PDL_URL, params=params).json()

curl -X GET \
  'https://api.peopledatalabs.com/v5/person/enrich?api_key=xxxx&name=sean thorne&company=peopledatalabs.com'
  
# OR

curl -X GET \
  'https://api.peopledatalabs.com/v5/person/enrich?name=sean thorne&company=peopledatalabs.com' \ 
  -H 'X-Api-Key: xxxx'

For Non-Technical Users

While we currently provide no integration support, we recommend the following options for a non-technical person trying to test our API:

• In browser API calls: A few are provided as examples above
• A GUI wrapper like Postman: Useful for single API calls

Neither of these solutions work at scale since you can only manually make one call at a time using these tools. As you scale out with our product, we highly recommend having some technical experience working with APIs.

Companies like Pipedream provide tools that allow you to connect an API into your existing workflow and provide support and services surrounding this integration. Pipedream has a direct integration with People Data Labs as well as with tools like Google Sheets and Hubspot that allow you to directly enrich lists of people or inbound leads. We encourage you to use this service, if it is too burdensome to create these integrations on your own.