# LinkedIn Company Employees (`linkedin.company_employees`)

List people who work at a LinkedIn company, optionally filtered by job title: name, handle, title, location and profile URL.

Docs: https://primaryapi.com/docs/api-reference/linkedin/company_employees

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.company_employees`
- Category: Social · Platform: `linkedin` · Kind: list · Status: live
- Price: 3.75 credits per result, at least 29 credits a call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per result returned, rounded up to whole credits per call (a call that returns nothing costs nothing)
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.company_employees`
- Execution: synchronous (answers 202 only if it outlives the wait window)
- Restricted: yes. Requires an approved account that accepted the permissible-purpose terms (`403 restricted_api` otherwise)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `company` | string | yes |  | max 2048 chars | LinkedIn company page URL (https://www.linkedin.com/company/<slug>) or its universal name, e.g. "shopify". |
| `jobTitle` | string | no |  | max 200 chars | Current job-title filter, e.g. "Engineering Manager". |
| `limit` | integer | no | 10 | 1–25 | Maximum number of results to return (1-25, default 10). |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `items` | object[] |  |
| `items[].id` | string \| null |  |
| `items[].name` | string \| null |  |
| `items[].firstName` | string \| null |  |
| `items[].lastName` | string \| null |  |
| `items[].handle` | string \| null |  |
| `items[].url` | string \| null |  |
| `items[].jobTitle` | string \| null | Headline or current position as listed |
| `items[].location` | string \| null |  |
| `items[].city` | string \| null |  |
| `items[].country` | string \| null |  |
| `items[].countryCode` | string \| null |  |
| `items[].openToWork` | boolean \| null |  |
| `items[].premium` | boolean \| null |  |
| `items[].influencer` | boolean \| null |  |
| `items[].image` | string \| null |  |
| `nextCursor` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/linkedin.company_employees" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"https://www.linkedin.com/company/google","jobTitle":"Engineering Manager","limit":10}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "items": [
        {
          "id": "string",
          "name": "string",
          "firstName": "string",
          "lastName": "string",
          "handle": "string",
          "url": "https://example.com",
          "jobTitle": "Engineering Manager",
          "location": "string",
          "city": "string",
          "country": "string",
          "countryCode": "string",
          "openToWork": true,
          "premium": true,
          "influencer": true,
          "image": "string"
        }
      ],
      "nextCursor": null
    }
  },
  "provider": "PrimaryAPI",
  "credits": 29,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 3.75 credits per result, at least 29 credits a call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.company_employees`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`, `restricted_api`. See https://primaryapi.com/docs/errors.

## Notes

Serves the first page only (up to 25 people). The per-call fee is charged even when nobody matches. Only people who list the company as their current employer appear.

## Legal

Restricted: needs an approved account and an accepted permissible purpose. Public LinkedIn data only. LinkedIn’s User Agreement restricts automated collection and LinkedIn enforces it; use the data for lawful purposes, keep copies only as long as you need them, and treat post and article text as the author’s content (analysis, not republication). Results contain personal data about identifiable people (GDPR, UK GDPR, CCPA): have a lawful basis, honour deletion requests, and never use it for spam or unsolicited bulk outreach. Employee rosters are bulk personal data: no unsolicited bulk outreach.

