Control optional person data
Choose optional contact, career, and developer data in a v3 person response.
The v3 person endpoint accepts separate query parameters for optional data. Each parameter defaults to exclude; set it to include when you need that data.
| Parameter | Response data |
|---|---|
socialLink | Social profile URLs in contactInformation.socialLinks and usernames in slug |
phoneNumber | Phone numbers in contactInformation.phoneNumbers |
personalEmail | Personal email addresses in contactInformation.emails.personal |
workEmail | Work email addresses in contactInformation.emails.work |
careerInsight | Estimated salary, seniority, and inferred skills in careerInsight |
developerProfile | GitHub developer data in developerProfile |
These are independent parameters. The current v3 contract does not expose sections or exclude as query parameters.
Request optional data
curl -G \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
'https://api.enrichlayer.com/v3/person' \
--data-urlencode 'profile=https://www.linkedin.com/in/williamhgates' \
--data-urlencode 'workEmail=include' \
--data-urlencode 'careerInsight=include'Shell
import requests
response = requests.get(
"https://api.enrichlayer.com/v3/person",
params={
"profile": "https://www.linkedin.com/in/williamhgates",
"workEmail": "include",
"developerProfile": "include",
},
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
response.raise_for_status()
data = response.json()Python
Freshness
maxAgeSeconds sets the maximum acceptable age of cached data in seconds. The default is 2592000 (30 days), and the minimum is 0. See the API reference for request validation and response details.