> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Company Employees API

> List LinkedIn company employees (name, role, location, seniority) from a list of company URLs

`POST /v1/data/linkedin/company-employees/run`

**Pricing:** $0.004 per profile ($4.00 per 1,000). Plus a flat \$0.05 search fee per run, charged even when nothing is found.

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**companies** `string[]` *required*

LinkedIn company URLs. One per line.

**maxResults** `integer`

Number of employee profiles to return. Use 0 for all.

**locations** `string[]`

Filter by location (e.g. San Francisco, London). One per line.

**jobTitles** `string[]`

Filter by current job title (e.g. Software Engineer, Product Manager). One per line.

**yearsAtCompany** `string[]`

Filter to employees in this tenure band.

Allowed values: `1` (Less than 1 year), `2` (1-2 years), `3` (3-5 years), `4` (6-10 years), `5` (More than 10 years).

**yearsOfExperience** `string[]`

Filter to employees in this experience band.

Allowed values: `1` (Less than 1 year), `2` (1-2 years), `3` (3-5 years), `4` (6-10 years), `5` (More than 10 years).

**companyHeadcount** `string[]`

Filter to companies in this employee-count band.

Allowed values: `1` (Self-employed (1)), `2-10` (2-10 employees), `11-50` (11-50 employees), `51-200` (51-200 employees), `201-500` (201-500 employees), `501-1000` (501-1000 employees), `1001-5000` (1001-5000 employees), `5001-10000` (5001-10000 employees), `10001+` (10001+ employees).

**recentlyChangedJobs** `boolean`

Set to true to only get people who have recently changed jobs.

**pastJobTitles** `string[]`

Filter by past job title text (e.g. 'engineer'). One per line.

**seniorityLevels** `string[]`

Filter to employees at this seniority level.

Allowed values: `100` (In Training), `110` (Entry Level), `120` (Senior), `130` (Strategic), `200` (Entry Level Manager), `210` (Experienced Manager), `220` (Director), `300` (Vice President), `310` (CXO), `320` (Owner / Partner).

**functions** `string[]`

Filter to employees in this job function.

26 allowed values, for example `1` (Accounting), `2` (Administrative), `3` (Arts and Design), `4` (Business Development), `5` (Community and Social Services), `6` (Consulting), `7` (Education), `8` (Engineering), `9` (Entrepreneurship), `10` (Finance). Fetch the full list with `GET /v1/data/linkedin/company-employees?expand=options`.

**industries** `string[]`

Filter to employees in this industry.

434 allowed values, for example `2190` (Accommodation Services), `34` (Accommodation Services > Food and Beverage Services), `2217` (Accommodation Services > Food and Beverage Services > Bars, Taverns, and Nightclubs), `2212` (Accommodation Services > Food and Beverage Services > Caterers), `2214` (Accommodation Services > Food and Beverage Services > Mobile Food Services), `32` (Accommodation Services > Food and Beverage Services > Restaurants), `31` (Accommodation Services > Hospitality), `2197` (Accommodation Services > Hospitality > Bed-and-Breakfasts, Hostels, Homestays), `2194` (Accommodation Services > Hospitality > Hotels and Motels), `1912` (Administrative and Support Services). Fetch the full list with `GET /v1/data/linkedin/company-employees?expand=options`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/linkedin/company-employees/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "maxResults": 10,
    "companies": [
      "https://www.linkedin.com/company/google"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/linkedin/company-employees/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "maxResults": 10,
    "companies": [
        "https://www.linkedin.com/company/google"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/linkedin/company-employees/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "maxResults": 10,
  "companies": [
    "https://www.linkedin.com/company/google"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one profile, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `profileUrl` | Profile URL | url |
| `profileId` | Profile ID | text |
| `handle` | Handle | text |
| `firstName` | First Name | text |
| `lastName` | Last Name | text |
| `headline` | Headline | text |
| `about` | About | text |
| `photo` | Photo | url |
| `coverPhoto` | Cover Photo | url |
| `city` | City | text |
| `state` | State | text |
| `country` | Country | text |
| `followers` | Followers | number |
| `connections` | Connections | number |
| `verified` | Verified | text |
| `premium` | Premium | text |
| `influencer` | Influencer | text |
| `openToWork` | Open To Work | text |
| `hiring` | Hiring | text |
| `experience` | Experience | object\_array |
| `education` | Education | object\_array |
| `certifications` | Certifications | object\_array |
| `projects` | Projects | object\_array |
| `courses` | Courses | object\_array |
| `publications` | Publications | object\_array |
| `volunteering` | Volunteering | object\_array |
| `receivedRecommendations` | Received Recommendations | object\_array |
| `skills` | Skills | object\_array |
| `patents` | Patents | object\_array |
| `honorsAndAwards` | Honors And Awards | object\_array |
| `languages` | Languages | object\_array |
| `causes` | Causes | array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "linkedin/company-employees",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "headline": "Senior UX Engineer at Google",
      "city": "San Francisco",
      "hiring": false,
      "volunteering": [
        {
          "role": "Volunteer Code Reviewer",
          "organizationName": "freeCodeCamp",
          "organizationLinkedinUrl": null,
          "cause": "Education",
          "description": "Provided constructive feedback for students learning HTML, CSS, and JavaScript.",
          "durationMonths": 25,
          "startDate": "Feb 2016",
          "endDate": "Feb 2018"
        }
      ],
      "openToWork": false,
      "followers": 915,
      "connections": 904,
      "about": "Full stack web engineer who specializes in the front end",
      "premium": false,
      "handle": "davpk",
      "profileUrl": "https://www.linkedin.com/in/davpk",
      "languages": [
        {
          "name": "English",
          "proficiency": "Native or bilingual proficiency"
        },
        {
          "name": "Korean",
          "proficiency": "Native or bilingual proficiency"
        }
      ],
      "lastName": "P.",
      "publications": [],
      "country": "United States",
      "experience": [
        {
          "position": "Senior UX Engineer",
          "description": null,
          "companyName": "Google",
          "companyLinkedinUrl": "https://www.linkedin.com/company/google/",
          "companyLogo": "https://media.licdn.com/dms/image/v2/D4E0BAQGv3cqOuUMY7g/company-logo_400_400/B4EZmhegXHGcAc-/0/1759350753990/google_logo?e=1788393600&v=beta&t=tUOjq2HFuDr7o...",
          "location": "San Francisco Bay Area",
          "employmentType": "Full-time",
          "workplaceType": "Hybrid",
          "durationMonths": 3,
          "startDate": "Jun 2026",
          "endDate": "Present",
          "companyId": "1441"
        },
        {
          "position": "Senior Software Engineer - Frontend",
          "description": "• Served as lead engineer for block.xyz (Block's public website) and tbd.website, which were built with React, Svelte, and Sanity CMS. \n• Led the development...",
          "companyName": "Block",
          "companyLinkedinUrl": "https://www.linkedin.com/company/joinblock/",
          "companyLogo": "https://media.licdn.com/dms/image/v2/D560BAQEDq04RNiX3Ag/company-logo_400_400/B56Zbp3paWGsAY-/0/1747680401683/joinblock_logo?e=1788393600&v=beta&t=SrXz4igg2T...",
          "location": "San Francisco Bay Area",
          "employmentType": "Full-time",
          "workplaceType": "Remote",
          "durationMonths": 45,
          "startDate": "Sep 2022",
          "endDate": "May 2026",
          "companyId": "80086817"
        }
      ],
      "coverPhoto": null,
      "photo": "https://media.licdn.com/dms/image/v2/C5603AQH44UnfwYj-Ig/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1546478421603?e=1788393600...",
      "skills": [
        {
          "name": "Test Driven Development",
          "endorsements": "4 endorsements"
        },
        {
          "name": "Web Development",
          "endorsements": "6 endorsements"
        }
      ],
      "patents": [],
      "influencer": false,
      "state": "California",
      "courses": [],
      "causes": [
        "Animal Welfare",
        "Environment"
      ],
      "verified": true
    }
  ]
}
```

## Related APIs

For full profiles from URLs you already have use [`linkedin/profiles`](https://docs.mindcase.co/apis/linkedin/profiles); for people search across companies use [`linkedin/profiles/search`](https://docs.mindcase.co/apis/linkedin/profiles).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.