Skip to main content
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": {
    "publicIdentifier": "<string>",
    "id": "<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)

​
main
string

Set this parameter to 'true' to return only main version of the profile that you can see on LinkedIn without expanding profile sections - up to 5 experiences, 2 educations, 2 skills, etc. 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 together 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.

​
includeAboutProfile
string

Include this parameter to scrape the "About this profile" popup from LinkedIn profiles.

Response

Profile response

​
element
object
​
status
string
​
error
string
​
query
object