# LinkedIn Company Employees

List LinkedIn company employees — name, role, location, seniority — from a list of company URLs

**Pricing:** $4 / 1k profiles

**Endpoint:** `POST /api/v1/agents/linkedin/company-employees/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companies` | array | Yes | LinkedIn company URLs (e.g. https://www.linkedin.com/company/google). One per line. |
| `maxResults` | integer | No | Maximum number of employee profiles to scrape. Use 0 for all. |
| `locations` | array | No | Filter by location (e.g. San Francisco, London). One per line. |
| `jobTitles` | array | No | Filter by current job title (e.g. Software Engineer, Product Manager). One per line. |
| `yearsAtCompany` | array | No | Filter to employees in this tenure band. |
| `yearsOfExperience` | array | No | Filter to employees in this experience band. |
| `companyHeadcount` | array | No | Filter to companies in this employee-count band. |
| `recentlyChangedJobs` | boolean | No | Set to true to only get people who have recently changed jobs. |
| `pastJobTitles` | array | No | Filter by past job title text (e.g. 'engineer'). One per line. |
| `seniorityLevels` | array | No | Filter to employees at this seniority level. |
| `functions` | array | No | Filter to employees in this job function. |
| `industries` | array | No | Filter to employees in this industry. |

## Example

```bash
curl -X POST https://api.mindcase.co/api/v1/agents/linkedin/company-employees/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"companies":["..."]}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/linkedin/company-employees/run",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {
    "companies": [
        "..."
    ]
}},
)
data = resp.json()
```

## Get the results

`run` is async and returns a `job_id`. Poll until `status` is `completed`, then read the rows:

```bash
# 1) check status
curl https://api.mindcase.co/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/api/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, endpoints): https://mindcase.co/skills.md

## Response columns

| Field | Display name | Type |
|-------|--------------|------|
| `profileUrl` | Profile URL | url |
| `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 |