GET
/
linkedin
/
profile
Get the LinkedIn profile of the user
curl --request GET \
  --url https://api.harvest-api.com/linkedin/profile \
  --header 'X-API-Key: <api-key>'
{
  "element": {
    "id": "<string>",
    "publicIdentifier": "<string>",
    "lastName": "<string>",
    "firstName": "<string>",
    "headline": "<string>",
    "about": "<string>",
    "linkedinUrl": "<string>",
    "photo": "<string>",
    "registeredAt": "2023-11-07T05:31:56Z",
    "topSkills": "<string>",
    "connectionsCount": 123,
    "followerCount": 123,
    "openToWork": true,
    "hiring": true,
    "location": {
      "linkedinText": "<string>",
      "countryCode": "<string>",
      "parsed": {
        "text": "<string>",
        "countryCode": "<string>",
        "regionCode": "<string>",
        "country": "<string>",
        "countryFull": "<string>",
        "state": "<string>",
        "city": "<string>"
      }
    },
    "currentPosition": [
      {
        "companyName": "<string>"
      }
    ],
    "experience": [
      {
        "companyName": "<string>",
        "duration": "<string>",
        "position": "<string>",
        "location": "<string>",
        "companyLink": "<string>",
        "description": "<string>",
        "startDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        },
        "endDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        },
        "employmentType": "<string>"
      }
    ],
    "education": [
      {
        "title": "<string>",
        "link": "<string>",
        "degree": "<string>",
        "startDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        },
        "endDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        }
      }
    ],
    "certifications": [
      {
        "title": "<string>",
        "issuedAt": "<string>",
        "issuedBy": "<string>",
        "issuedByLink": "<string>"
      }
    ],
    "receivedRecommendations": [
      {
        "givenBy": "<string>",
        "givenAt": "<string>",
        "givenByLink": "<string>",
        "description": "<string>"
      }
    ],
    "skills": [
      {
        "name": "<string>"
      }
    ],
    "languages": [
      {
        "language": "<string>",
        "proficiency": "<string>"
      }
    ],
    "projects": [
      {
        "title": "<string>",
        "description": "<string>",
        "startDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        },
        "endDate": {
          "month": "<string>",
          "year": 123,
          "text": "<string>"
        }
      }
    ],
    "publications": [
      {
        "title": "<string>",
        "publishedAt": "<string>",
        "description": "<string>",
        "link": "<string>"
      }
    ],
    "featured": {
      "images": [
        "<string>"
      ],
      "link": "<string>",
      "title": "<string>",
      "subtitle": "<string>"
    },
    "verified": true
  },
  "status": "<string>",
  "error": "<string>",
  "query": {
    "url": "<string>",
    "publicIdentifier": "<string>",
    "profileId": "<string>"
  }
}
const params = new URLSearchParams({
  url: 'https://www.linkedin.com/in/williamhgates', // by URL
  // publicIdentifier: 'williamhgates', // by publicIdentifier alternatively
});

fetch(`https://api.harvest-api.com/linkedin/profile?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
url
string<url>

URL of the LinkedIn profile (optional)

​
publicIdentifier
string

Public identifier of the LinkedIn profile (optional)

​
profileId
string

ID of the LinkedIn profile (optional)

​
short
string

Include this parameter to return a short version of the profile (includes name, title, followers and some other info). This version charges less credits

​
findEmail
string

Include this parameter to find the email of the profile. It will perform SMTP verifications to ensure deliverability. It will also output emails for catch-all domains and mark them as risky (deliverability is unknown). This version charges more credits.

​
skipSmtp
string

Include this parameter tother with findEmail to skip SMTP email verification when finding emails. It will output all possible generated emails without checking deliverability via SMTP. It will do only minimal validations, as checking domains for MX records. This version charges less credits when using with findEmail.

Response

200
application/json

Profile response

The response is of type object.