Retrieving person data
This page describes how to create workflows for retrieving various types of LinkedIn person data, including basic information, experience, education, and more.
Each example below has its Node SDK call in the Node tab, and the label over each completion says what that call returns.
Each example below has its Python SDK call in the Python tab, and the label over each completion says what that call returns.
Each example below has its CLI command in the CLI tab, and the label over each completion says what the command prints.
Retrieving basic info
To retrieve basic information about a person, you need to include st.openPersonPage action in your workflow, with basicInfo parameter set to true. Here's an example:
Workflow:
{
"actionType": "st.openPersonPage",
"personUrl": "https://www.linkedin.com/in/person1",
"basicInfo": true
}Completion:
Completion – result() returns its data in data, and a failed action in errors:
Completion – with --json the CLI prints its data as data, or the action's error:
{
"actionType": "st.openPersonPage",
"success": true,
"data": {
"name": "John Doe",
"urn": "urn:li:member:123456789",
"publicUrl": "https://www.linkedin.com/in/person1",
"hashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8",
"headline": "Software Engineer at TechCorp",
"location": "San Francisco, USA",
"countryCode": "US",
"position": "Software Engineer",
"companyName": "TechCorp",
"companyHashedUrl": "https://www.linkedin.com/company/12345678",
"followersCount": 2322,
"viewerState": { "connectionDegree": "2nd" }
}
}💡 If you want to retrieve basic information about a person from Sales Navigator, use
nv.openPersonPageaction.
Retrieving experience
To retrieve information about a person's experience, you need to include st.retrievePersonExperience action as a child of st.openPersonPage. Here's an example:
Workflow:
{
"actionType": "st.openPersonPage",
"personUrl": "https://www.linkedin.com/in/person1",
"basicInfo": false,
"then": [
{
"actionType": "st.retrievePersonExperience"
}
]
}Completion:
Completion – result() returns its data, with the result of st.retrievePersonExperience in data.experiences instead of then and with basic information included:
Completion – with --json the CLI prints its data, with the result of st.retrievePersonExperience in data.experiences instead of then and with basic information included:
{
"actionType": "st.openPersonPage",
"success": true,
"data": {
"then": [
{
"actionType": "st.retrievePersonExperience",
"success": true,
"data": [
{
"position": "Software Engineer",
"companyName": "TechCorp",
"companyHashedUrl": "https://www.linkedin.com/company/12345678",
"employmentType": "fullTime",
"locationType": "onSite",
"description": "Developing innovative software solutions.",
"duration": 24,
"startTime": "2021-01-01T00:00:00Z",
"endTime": null,
"location": "San Francisco, USA"
},
{
"position": "Junior Developer",
"companyName": "CodeBase Inc.",
"companyHashedUrl": "https://www.linkedin.com/company/87654321",
"employmentType": "internship",
"locationType": "remote",
"description": "Worked on front-end development tasks.",
"duration": 12,
"startTime": "2020-01-01T00:00:00Z",
"endTime": "2020-12-31T00:00:00Z",
"location": null
}
]
}
]
}
}Retrieving education
To retrieve information about a person's education, you need to include st.retrievePersonEducation action as a child of st.openPersonPage. Here's an example:
Workflow:
{
"actionType": "st.openPersonPage",
"personUrl": "https://www.linkedin.com/in/person1",
"basicInfo": false,
"then": [
{
"actionType": "st.retrievePersonExperience"
},
{
"actionType": "st.retrievePersonEducation"
}
]
}Completion:
Completion – result() returns its data, with the result of st.retrievePersonExperience in data.experiences and of st.retrievePersonEducation in data.education instead of then and with basic information included:
Completion – with --json the CLI prints its data, with the result of st.retrievePersonExperience in data.experiences and of st.retrievePersonEducation in data.education instead of then and with basic information included:
{
"actionType": "st.openPersonPage",
"success": true,
"data": {
"then": [
{
"actionType": "st.retrievePersonExperience",
"success": true,
"data": [ ... ]
},
{
"actionType": "st.retrievePersonEducation",
"success": true,
"data": [
{
"schoolName": "Harvard University",
"schoolHashedUrl": "https://www.linkedin.com/company/12345678",
"details": "Master of Science in Computer Science, Artificial Intelligence"
},
{
"schoolName": "MIT",
"schoolHashedUrl": "https://www.linkedin.com/company/87654321",
"details": "Bachelor of Science in Electrical Engineering and Computer Science"
}
]
}
]
}
}Retrieving other data
To retrieve other types of person data, you can use the following actions as children of st.openPersonPage (just as in the examples above):
st.retrievePersonSkills– allows you to retrieve a person's skills.st.retrievePersonLanguages– allows you to retrieve a person's languages.st.retrievePersonPosts– allows you to retrieve posts published by a person and perform additional post-related actions if needed.st.retrievePersonComments– allows you to retrieve comments left by a person.st.retrievePersonReactions– allows you to retrieve reactions made by a person.
This page provides examples of workflows and their completions. For detailed documentation on constraints, parameters, and possible results of specific actions, always refer to the corresponding action documentation pages.