Person Profile Endpoint
Look up a person by any identifier: an email address, or a LinkedIn, Facebook, Twitter/X, or GitHub username or profile URL. One of them is required.
Authorization
BearerAuth AuthorizationBearer <token>
Enrich Layer API key, sent as Authorization: Bearer <key>
In: header
Query Parameters
email?string
Email address
profile?string
LinkedIn username or profile URL
facebook?string
Facebook username or profile URL
twitter?string
Twitter/X username or profile URL
github?string
GitHub username or profile URL
socialLink?string
Include the social profile URLs, returned in the contactInformation.socialLinks section, along with the corresponding usernames in the slug section
Default
"exclude"Value in
"exclude" | "include"phoneNumber?string
Include phone numbers, returned in the contactInformation.phoneNumbers section
Default
"exclude"Value in
"exclude" | "include"personalEmail?string
Include personal emails, returned in the contactInformation.emails.personal section
Default
"exclude"Value in
"exclude" | "include"workEmail?string
Include work emails, returned in the contactInformation.emails.work section
Default
"exclude"Value in
"exclude" | "include"careerInsight?string
Include the estimated salary, seniority, and inferred skills, returned in the careerInsight section
Default
"exclude"Value in
"exclude" | "include"developerProfile?string
Include the GitHub developer profile data, returned in the developerProfile section
Default
"exclude"Value in
"exclude" | "include"maxAgeSeconds?integer
Maximum acceptable age of cached data, in seconds.
Default
2592000Range
0 <= valueResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.enrichlayer.com/v3/person?profile=https%3A%2F%2Flinkedin.com%2Fin%2Fsatyanadella%2F&personalEmail=include&maxAgeSeconds=86400" \ -H "Authorization: Bearer YOUR_API_KEY"{
"summary": {
"fullName": "string",
"profileImage": "string",
"jobTitle": "string",
"currentCompanies": [
"string"
],
"location": "string"
},
"slug": {
"linkedin": "string",
"github": "string",
"facebook": "string",
"twitter": "string"
},
"profileImageUrl": {
"linkedin": "string",
"twitter": "string",
"github": "string"
},
"backgroundImageUrl": {
"linkedin": "string",
"twitter": "string",
"github": "string"
},
"firstName": "string",
"lastName": "string",
"fullName": "string",
"middleName": "string",
"nickname": "string",
"suffix": "string",
"headline": "string",
"headlineTimeseries": [
{
"date": "string",
"value": 0
}
],
"jobTitle": "string",
"about": "string",
"location": {
"country": "string",
"countryIso3": "string",
"countryFullName": "string",
"city": "string",
"state": "string",
"stateFullName": "string",
"rawLocationString": "string",
"coordinates": {
"latitude": 0,
"longitude": 0
}
},
"experience": {
"work": [
{
"startDate": "string",
"endDate": "string",
"companyName": "string",
"companyInfo": {
"linkedin": {
"slug": "string",
"companyId": 0,
"logoUrl": "string",
"website": "string",
"industries": [
"string"
]
},
"facebook": {
"slug": "string",
"companyId": 0,
"logoUrl": "string",
"website": "string",
"industries": [
"string"
]
},
"crunchbase": {
"slug": "string",
"companyId": 0,
"logoUrl": "string",
"website": "string",
"industries": [
"string"
]
},
"twitter": {
"slug": "string",
"companyId": 0,
"logoUrl": "string",
"website": "string",
"industries": [
"string"
]
}
},
"title": "string",
"description": "string",
"location": "string",
"seniority": [
"string"
],
"isDecisionMaker": true,
"employmentType": [
"string"
],
"jobFunction": [
"string"
]
}
],
"volunteer": [
{
"startDate": "string",
"endDate": "string",
"title": "string",
"cause": "string",
"organization": "string",
"organizationId": {
"linkedinId": "string",
"crunchbaseId": "string",
"facebookId": "string",
"twitterId": "string"
},
"description": "string",
"logoUrl": "string"
}
]
},
"education": [
{
"startDate": "string",
"endDate": "string",
"fieldOfStudy": "string",
"degreeName": "string",
"school": "string",
"schoolId": {
"linkedinId": "string",
"crunchbaseId": "string",
"facebookId": "string",
"twitterId": "string"
},
"description": "string",
"logoUrl": "string",
"grade": "string",
"activities": "string"
}
],
"certifications": [
{
"startDate": "string",
"endDate": "string",
"name": "string",
"licenseNumber": "string",
"displaySource": "string",
"authority": "string",
"url": "string",
"organizationId": {
"linkedinId": "string",
"crunchbaseId": "string",
"facebookId": "string",
"twitterId": "string"
},
"organizationUrl": "string"
}
],
"accomplishments": {
"organizations": [
{
"startDate": "string",
"endDate": "string",
"name": "string",
"position": "string",
"description": "string"
}
],
"honorsAwards": [
{
"title": "string",
"issuer": "string",
"issuedDate": "string",
"description": "string"
}
],
"courses": [
{
"name": "string",
"number": "string"
}
],
"projects": [
{
"startDate": "string",
"endDate": "string",
"title": "string",
"description": "string",
"url": "string"
}
],
"testScores": [
{
"name": "string",
"score": "string",
"date": "string",
"description": "string"
}
]
},
"publications": [
{
"title": "string",
"publisher": "string",
"publishedDate": "string",
"description": "string",
"url": "string"
}
],
"patents": [
{
"title": "string",
"issuer": "string",
"issuedDate": "string",
"description": "string",
"applicationNumber": "string",
"patentNumber": "string",
"url": "string"
}
],
"contactInformation": {
"emails": {
"personal": [
{
"email": "string",
"normalized": "string",
"validity": "string",
"validatedAt": "string",
"gateway": "string"
}
],
"work": [
{
"email": "string",
"normalized": "string",
"validity": "string",
"validatedAt": "string",
"gateway": "string"
}
]
},
"phoneNumbers": [
"string"
],
"socialLinks": {
"linkedinUrl": "string",
"githubUrl": "string",
"facebookUrl": "string",
"twitterUrl": "string",
"websiteUrl": "string"
}
},
"languages": [
{
"name": "string",
"proficiency": "string"
}
],
"interests": [
"string"
],
"inferredGender": "string",
"industries": [
"string"
],
"socialPresence": {
"followers": {
"total": 0,
"linkedin": 0,
"twitter": 0,
"facebook": 0,
"github": 0
},
"followersCountTimeseries": [
{
"date": "string",
"value": 0
}
],
"connections": {
"total": 0,
"linkedin": 0,
"twitter": 0,
"facebook": 0,
"github": 0
}
},
"relatedProfiles": [
{
"url": "string",
"name": "string",
"headline": "string",
"location": "string"
}
],
"recommendations": [
"string"
],
"activities": [
{
"title": "string",
"url": "string"
}
],
"similarNames": [
{
"name": "string",
"url": "string",
"headline": "string",
"location": "string"
}
],
"articles": [
{
"title": "string",
"url": "string",
"publishedDate": "string",
"author": "string",
"imageUrl": "string"
}
],
"groups": [
{
"id": 0,
"name": "string",
"link": "string",
"type": "LinkedIn Group"
}
],
"developerProfile": {
"github": {
"username": "string",
"avatarUrl": "string",
"followersCount": 0,
"followingCount": 0,
"publicReposCount": 0,
"publicGistsCount": 0,
"languages": [
"string"
],
"contributionsCount": 0
}
},
"careerInsight": {
"estimatedSalary": {
"min": 0,
"max": 0
},
"seniority": {
"totalExperienceYears": 0,
"currentTenureYears": 0,
"averageTenureYears": 0,
"isInfluencer": true
},
"inferredSkills": [
"string"
]
},
"meta": {
"updatedAt": "string",
"activityAt": "string"
}
}{
"code": 400,
"name": "Bad Request",
"description": "Invalid parameters provided. Refer to the documentation and message body for more info"
}{
"code": 401,
"name": "Unauthorized",
"description": "Invalid API key"
}{
"code": 403,
"name": "Forbidden",
"description": "You have run out of credits"
}{
"code": 404,
"name": "Not Found",
"description": "The requested resource (e.g: user profile, company) could not be found"
}{
"code": 409,
"name": "Conflict",
"description": "A fresh profile could not be fetched; a cached profile exists but is older than the requested maxAgeSeconds. Retry the request, or raise maxAgeSeconds to accept the cached profile.",
"cachedProfileAgeSeconds": 5184000
}{
"code": 429,
"name": "Too Many Requests",
"description": "Rate limited. Please retry"
}{
"code": 500,
"name": "Internal Server Error",
"description": "Internal Server Error"
}{
"code": 503,
"name": "Service Unavailable",
"description": "Retrieval failed, please retry."
}