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