Setup
If you haven't already, you'll need to signup 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 only API available via self-serve currently is the Person Enrichment API.
This API endpoint is meant for enriching information on exactly one person. Every enrichment request returns exactly one person or no persons. We also have a "search" API, where we return multiple persons based on a query. This endpoint is in beta and only available if you talk to a Data Consultant.
Note:
- All sample API calls below are made with the
pretty
url param, which denotes whether the output should be pretty printed set totrue
. - All of these example calls are using the
/v5/person/enrich
endpoint, which is available via self-signup. - 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 and Tonkean provide tools that allow you to connect an API into your existing workflow and provide support and services surrounding this integration. Both of the aforementioned tools have 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.
Updated 24 days ago