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.

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[]