# 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`](/docs/action-st-open-company-page) action in your workflow, with `basicInfo` parameter set to `true`. Here's an example:

**Workflow:**

```json
{
  "actionType": "st.openCompanyPage",
  "companyUrl": "https://www.linkedin.com/company/company1",
  "basicInfo": true
}
```

**Completion:**

```json
{
  "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",
    "employeesCount": 500,
    "yearFounded": 2019,
    "ventureFinancing": true,
    "jobsCount": 12
  }
}
```

> 💡 If you want to retrieve basic information about a company from **Sales Navigator**, use [`nv.openCompanyPage`](/docs/action-nv-open-company-page) action.

## Retrieving employees

To retrieve company employees, you need to include [`st.retrieveCompanyEmployees`](/docs/action-st-retrieve-company-employees) action as a child of [`st.openCompanyPage`](/docs/action-st-open-company-page). Here's an example:

**Workflow:**

```json
{
  "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:**

```json
{
  "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`](/docs/action-st-do-for-people) action.

> 💡 If you want to retrieve company employees from **Sales Navigator**, use the following actions: [`nv.openCompanyPage`](/docs/action-nv-open-company-page), [`nv.retrieveCompanyEmployees`](/docs/action-nv-retrieve-company-employees).

## Retrieving decision makers

To retrieve company employees, you need to include [`st.retrieveCompanyDMs`](/docs/action-st-retrieve-company-dms) action as a child of [`st.openCompanyPage`](/docs/action-st-open-company-page). Here's an example:

**Workflow:**

```json
{
  "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:**

```json
{
  "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`](/docs/action-st-do-for-people) action.

> 💡 If you want to retrieve decision makers from **Sales Navigator**, use the following actions: [`nv.openCompanyPage`](/docs/action-nv-open-company-page), [`nv.retrieveCompanyDMs`](/docs/action-nv-retrieve-company-dms).

## Retrieving posts

To retrieve posts published by a company, you need to include [`st.retrieveCompanyPosts`](/docs/action-st-retrieve-company-posts) action as a child of [`st.openCompanyPage`](/docs/action-st-open-company-page). Here's an example:

**Workflow:**

```json
{
  "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:**

```json
{
  "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",
              "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
          },
          {
            "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",
              "profileUrl": "https://www.linkedin.com/in/example-author",
              "headline": null
            },
            "reposter": {
              "type": "company",
              "name": "Example Company",
              "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
          }
        ]
      }
    ]
  }
}
```

> 💡 If you want to perform actions on the retrieved posts, use [`st.doForPosts`](/docs/action-st-do-for-posts) action.

> This page provides examples of [workflows](/docs/building-workflows) and their [completions](/docs/executing-workflows). For detailed documentation on constraints, parameters, and possible results of specific actions, always refer to the corresponding [action documentation pages](/docs/actions-overview).