Documentation

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; if several are given, only the first in this order is used: github, email, profile, facebook, twitter.

GET
/v3/person

Authorization

BearerAuth
AuthorizationBearer <token>

Enrich Layer API key, sent as Authorization: Bearer <key>

In: header

Query Parameters

email?string

Email address. If several identifiers are given, only the first in the order github, email, profile, facebook, twitter is used

profile?string

LinkedIn username or profile URL. If several identifiers are given, only the first in the order github, email, profile, facebook, twitter is used

facebook?string

Facebook username or profile URL. If several identifiers are given, only the first in the order github, email, profile, facebook, twitter is used

twitter?string

Twitter/X username or profile URL. If several identifiers are given, only the first in the order github, email, profile, facebook, twitter is used

github?string

GitHub username or profile URL. If several identifiers are given, only the first in the order github, email, profile, facebook, twitter is used

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"
activities?string

Include up to 100 of the most recent posts from the person page, newest first with undated posts last, returned in the activities section

Default"exclude"
Value in"exclude" | "include"
maxAgeSeconds?integer

Maximum acceptable age of cached data, in seconds.

Default2592000
Range0 <= value

Response 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" \  -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": {
    "posts": [
      {
        "title": "string",
        "url": "string",
        "publishedDate": "string",
        "likes": 0,
        "comments": 0
      }
    ]
  },
  "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",
    "experienceRestrictedOn": "string"
  }
}

{
  "code": 400,
  "name": "Bad Request",
  "description": "Provide valid parameters"
}

{
  "code": 401,
  "name": "Unauthorized",
  "description": "Invalid API key"
}

{
  "code": 403,
  "name": "Forbidden",
  "description": "Account has been suspended. Please email [email protected] for more information."
}

{
  "code": 404,
  "name": "Not Found",
  "description": "Person not 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 limit exceeded. See https://enrichlayer.com/docs/guides/rate-limits"
}
{
  "code": 500,
  "name": "Internal Server Error",
  "description": "Failed to fetch data"
}
{
  "code": 503,
  "name": "Service Unavailable",
  "description": "Billing service unavailable"
}