Retrieving company data
This page describes how to create workflows for retrieving various types of LinkedIn company data, including basic information, posts, employees, and decision-makers.
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 company, you need to include st.openСompanyPage action in your workflow, with basicInfo parameter set to true. Here's an example:
Workflow:
{
"actionType": "st.openCompanyPage",
"companyUrl": "https://www.linkedin.com/company/company1",
"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.openCompanyPage",
"success": true,
"data": {
"name": "TechCorp",
"urn": "urn:li:organization:1234567",
"publicUrl": "https://www.linkedin.com/company/company1",
"description": "TechCorp is a leading provider of innovative technology solutions for businesses worldwide.",
"location": "Cupertino, California",
"headquarters": "US",
"industry": "Information Technology",
"specialties": "Cloud Computing, AI, Software Development",
"website": "https://techcorp.com",
"employeesCount": 500,
"yearFounded": 2019,
"jobsCount": 12
}
}💡 If you want to retrieve basic information about a company from Sales Navigator, use
nv.openCompanyPageaction.
Retrieving employees
To retrieve company employees, you need to include st.retrieveCompanyEmployees action as a child of st.openCompanyPage. Here's an example:
Workflow:
{
"actionType": "st.openCompanyPage",
"companyUrl": "https://www.linkedin.com/company/company1",
"basicInfo": false,
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"limit": 100,
"filter": {
"position": "Manager",
"locations": ["New York", "San Francisco", "London"],
"schools": ["Harvard University", "MIT"]
}
}
]
}Completion:
Completion – result() returns its data, with the result of st.retrieveCompanyEmployees in data.employees instead of then and with basic information included:
Completion – with --json the CLI prints its data, with the result of st.retrieveCompanyEmployees in data.employees instead of then and with basic information included:
{
"actionType": "st.openCompanyPage",
"success": true,
"data": {
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"success": true,
"data": [
{
"name": "John Doe",
"urn": "urn:li:member:123456789",
"publicUrl": "https://www.linkedin.com/in/johndoe",
"headline": "Manager at TechCorp",
"location": "New York, USA",
"avatarUrl": "https://media.licdn.com/dms/image/v2/D5603AQE/profile-displayphoto-shrink_100_100/0/1700000000000",
"viewerState": { "connectionDegree": "2nd" }
},
{
"name": "Jane Smith",
"urn": null,
"publicUrl": "https://www.linkedin.com/in/janesmith",
"headline": "Software Engineer at TechCorp",
"location": "San Francisco, USA",
"avatarUrl": null,
"viewerState": { "connectionDegree": "3rd+" }
}
]
}
]
}
}💡 If you want to perform actions on the retrieved employees, use
st.doForPeopleaction.
💡 If you want to retrieve company employees from Sales Navigator, use the following actions:
nv.openCompanyPage,nv.retrieveCompanyEmployees.
Retrieving decision makers
To retrieve company employees, you need to include st.retrieveCompanyDMs action as a child of st.openCompanyPage. Here's an example:
Workflow:
{
"actionType": "st.openCompanyPage",
"companyUrl": "https://www.linkedin.com/company/company1",
"basicInfo": false,
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"limit": 100,
"filter": {
"position": "Manager",
"locations": ["New York", "San Francisco", "London"],
"schools": ["Harvard University", "MIT"]
}
},
{
"actionType": "st.retrieveCompanyDMs",
"limit": 3
}
]
}Completion:
Completion – result() returns its data, with the result of st.retrieveCompanyEmployees in data.employees and of st.retrieveCompanyDMs in data.dms instead of then and with basic information included:
Completion – with --json the CLI prints its data, with the result of st.retrieveCompanyEmployees in data.employees and of st.retrieveCompanyDMs in data.dms instead of then and with basic information included:
{
"actionType": "st.openCompanyPage",
"success": true,
"data": {
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"success": true,
"data": [ ... ]
},
{
"actionType": "st.retrieveCompanyDMs",
"success": true,
"data": [
{
"name": "John Doe",
"urn": "urn:li:member:123456789",
"publicUrl": "https://www.linkedin.com/in/johndoe",
"headline": "Founder of TechCorp",
"location": "New York, USA",
"avatarUrl": "https://media.licdn.com/dms/image/v2/D5603AQE/profile-displayphoto-shrink_100_100/0/1700000000000",
"countryCode": "US",
"viewerState": { "connectionDegree": "2nd" }
},
{
"name": "Jane Smith",
"urn": null,
"publicUrl": "https://www.linkedin.com/in/janesmith",
"headline": "CEO at TechCorp",
"location": "San Francisco, USA",
"avatarUrl": null,
"countryCode": "US",
"viewerState": { "connectionDegree": "3rd+" }
}
]
}
]
}
}💡 If you want to perform actions on the retrieved decision makers, use
st.doForPeopleaction.
💡 If you want to retrieve decision makers from Sales Navigator, use the following actions:
nv.openCompanyPage,nv.retrieveCompanyDMs.
Retrieving posts
To retrieve posts published by a company, you need to include st.retrieveCompanyPosts action as a child of st.openCompanyPage. Here's an example:
Workflow:
{
"actionType": "st.openCompanyPage",
"companyUrl": "https://www.linkedin.com/company/company1",
"basicInfo": false,
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"limit": 100,
"filter": {
"position": "Manager",
"locations": ["New York", "San Francisco", "London"],
"schools": ["Harvard University", "MIT"]
}
},
{
"actionType": "st.retrieveCompanyDMs",
"limit": 3
},
{
"actionType": "st.retrieveCompanyPosts",
"limit": 5,
"since": "2025-01-01T00:00:00Z"
}
]
}Completion:
Completion – result() returns its data, with the result of st.retrieveCompanyEmployees in data.employees, of st.retrieveCompanyDMs in data.dms and of st.retrieveCompanyPosts in data.posts instead of then and with basic information included:
Completion – with --json the CLI prints its data, with the result of st.retrieveCompanyEmployees in data.employees, of st.retrieveCompanyDMs in data.dms and of st.retrieveCompanyPosts in data.posts instead of then and with basic information included:
{
"actionType": "st.openCompanyPage",
"success": true,
"data": {
"then": [
{
"actionType": "st.retrieveCompanyEmployees",
"success": true,
"data": [ ... ]
},
{
"actionType": "st.retrieveCompanyDMs",
"success": true,
"data": [ ... ]
},
{
"actionType": "st.retrieveCompanyPosts",
"success": true,
"data": [
{
"url": "https://www.linkedin.com/feed/update/urn:li:activity:1234567890123456789",
"activityUrn": "urn:li:activity:1234567890123456789",
"time": "2023-01-02T12:30:00Z",
"type": "original",
"author": {
"type": "company",
"name": "Example Company",
"urn": "urn:li:organization:1234567",
"companyUrl": "https://www.linkedin.com/company/example-company"
},
"reposter": null,
"repostText": null,
"text": "Check out our latest product launch!",
"hashtags": ["product", "launch"],
"mentions": [],
"externalLinks": ["https://example.com/launch"],
"images": [
"https://static.linkedin.com/image1.jpg",
"https://static.linkedin.com/image2.jpg"
],
"documentSlides": [],
"hasVideo": false,
"videoThumbnail": null,
"hasPoll": false,
"reactionsCount": 27,
"commentsCount": 8,
"repostsCount": 2,
"viewerState": { "reaction": null, "isOwn": false }
},
{
"url": "https://www.linkedin.com/feed/update/urn:li:activity:2345678901234567890",
"activityUrn": "urn:li:activity:2345678901234567890",
"time": "2023-01-01T09:15:00Z",
"type": "repost",
"author": {
"type": "person",
"name": "Example Author",
"urn": "urn:li:member:123456789",
"profileUrl": "https://www.linkedin.com/in/example-author",
"headline": null,
"viewerState": { "connectionDegree": "2nd" }
},
"reposter": {
"type": "company",
"name": "Example Company",
"urn": "urn:li:organization:1234567",
"companyUrl": "https://www.linkedin.com/company/example-company"
},
"repostText": "Thank you to everyone who joined our webinar!",
"text": "Original post content about the webinar",
"hashtags": [],
"mentions": [],
"externalLinks": [],
"images": [],
"documentSlides": [],
"hasVideo": true,
"videoThumbnail": "https://media.licdn.com/dms/image/video-cover.jpg",
"hasPoll": false,
"reactionsCount": 6,
"commentsCount": 0,
"repostsCount": 1,
"viewerState": { "reaction": null, "isOwn": false }
}
]
}
]
}
}💡 If you want to perform actions on the retrieved posts, use
st.doForPostsaction.
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.