Find Profile by VanityName API
Note
The use of this API is restricted to those developers approved by LinkedIn and subject to applicable data restrictions in their agreements.
The vanityName
is used to represent the public profile URL in the follow format: www.linkedin.com/in/{vanityName}
. Each LinkedIn profile has an unique vanityName
. This API returns basic profile fields for the LinkedIn member that matches the vanityName
.
Permissions
Permissions | Description |
---|---|
r_compliance_2l | Compliance permission to allow access of APIs without a member involvement. This is a private permission and access is granted to select developers. |
Usage
Note
You cannot "browse members" by VanityNames. It should only be used to identify profiles from known vanityNames for your partnership's approved use case. Access to profile data is subject to the relevant members' privacy settings.
To use this API, you must request an access token to make an application authenticated call. This API has an application limit of 500 per day.
Sample Request
GET https://api.linkedin.com/v2/people?q=vanityName&vanityName={vanityName}
Sample Response
{
"elements": [
{
"localizedLastName": "Last",
"lastName": {
"localized": {
"en_US": "Last"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"vanityName": "a-sample-vanity-name",
"firstName": {
"localized": {
"en_US": "First"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"localizedHeadline": "Software Engineer at LinkedIn",
"positions": {
"47301314": {
"localizedCompanyName": "Linkedin",
"created": 1551295846540,
"companyName": {
"localized": {
"en_US": "Linkedin"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"company": "urn:li:organization:12345",
"lastModified": 1551295846540,
"id": 47301314,
"title": {
"localized": {
"en_US": "Software Engineer"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"localizedTitle": "Software Engineer"
}
},
"id": "xo11w_WomY",
"headline": {
"localized": {
"en_US": "Software Engineer at LinkedIn"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"localizedFirstName": "First"
}
],
"paging": {
"count": 10,
"start": 0,
"links": []
}
}
Profile Fields Selection
This API will only return the following profile fields:
Field | Description |
---|---|
id | A unique identifying value for the member. Referenced as personId in other API documentation pages. Can also be referenced as an URN such as urn:li:person:{personId}. This value is linked to your specific application. Any attempts to use it with a different application will result in a 404 error. |
firstName | Localizable first name of the member. Represented as a MultiLocaleString object type. |
localizedFirstName | Localized version of the firstName field. |
lastName | Localizable last name of the member. Represented as a MultiLocaleString object type. |
localizedLastName | Localized version of the lastName field. |
maidenName | Localizable maiden name of the member. Represented as a MultiLocaleString object type. |
localizedMaidenName | Localized version of the maidenName field. |
headline | headline of member's choosing. Represented as a MultiLocaleString object type. |
localizedHeadline | Localized version of the headline field. |
profilePicture | Metadata about the member's picture in the profile. This will replace pictureInfo. See Profile Picture Fields for more information. |
vanityName | The vanity name of the member. Vanity name is represented as a string is used for the public profile URL: www.linkedin.com/in/{vanityName}. |
positions | An object representing the employment history of the member. See Position Fields for a description of the fields available within this object. |
positionsOrder | Positions intra-section order. Represented as an optional long[] |
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for