Skip to main content

Data Retrieval

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.

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:


{
  "actionType": "st.openCompanyPage",
  "success": true,
  "data": {
    "name": "TechCorp",
    "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",
    "employeeCount": 500,
    "yearFounded": 2019,
    "ventureFinancing": true,
    "jobsCount": 12
  }
}
💡
If you want to retrieve basic information about a company from Sales Navigator, use nv.openCompanyPage action.

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:


{
  "actionType": "st.openCompanyPage",
  "success": true,
  "data": {
    "then": [
      {
        "actionType": "st.retrieveCompanyEmployees"
        "success": true,
        "data": [
          {
            "name": "John Doe",
            "publicUrl": "https://www.linkedin.com/in/johndoe",
            "headline": "Manager at TechCorp",
            "location": "New York, USA"
          },
          {
            "name": "Jane Smith",
            "publicUrl": "https://www.linkedin.com/in/janesmith",
            "headline": "Software Engineer at TechCorp",
            "location": "San Francisco, USA"
          }
        ]
      }
    ]
  }
}
💡
If you want to perform actions on the retrieved employees, use st.doForPeople action.
💡
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:


{
  "actionType": "st.openCompanyPage",
  "success": true,
  "data": {
    "then": [
      {
        "actionType": "st.retrieveCompanyEmployees"
        "success": true,
        "data": [ ... ]
      },
      {
        "actionType": "st.retrieveCompanyDMs"
        "success": true,
        "data": [
          {
            "name": "John Doe",
            "publicUrl": "https://www.linkedin.com/in/johndoe",
            "headline": "Founder of TechCorp",
            "location": "New York, USA",
            "countryCode": "US"
          },
          {
            "name": "Jane Smith",
            "publicUrl": "https://www.linkedin.com/in/janesmith",
            "headline": "CEO at TechCorp",
            "location": "San Francisco, USA",
            "countryCode": "US"
          }
        ]
      }
    ]
  }
}
💡
If you want to perform actions on the retrieved decision makers, use st.doForPeople action.
💡
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:


{
  "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/posts/post1",
            "time": "2023-01-02T12:30:00Z",
            "type": "original",
            "repostText": null,
            "text": "Check out our latest product launch!",
            "images": [
              "https://static.linkedin.com/image1.jpg",
              "https://static.linkedin.com/image2.jpg"
            ],
            "hasVideo": false,
            "hasPoll": false,
            "reactionCount": 27,
            "commentCount": 8
          },
          {
            "url": "https://www.linkedin.com/posts/post2",
            "time": "2023-01-01T09:15:00Z",
            "type": "repost",
            "repostText": "Thank you to everyone who joined our webinar!",
            "text": "Original post content about the webinar",
            "images": [],
            "hasVideo": true,
            "hasPoll": false,
            "reactionCount": 6,
            "commentCount": 0
          }
        ]
      }
    ]
  }
}
💡
If you want to perform actions on the retrieved posts, use st.doForPosts action.
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.