# Find company employees

Find a sample of public profiles for people who work at a company. The response is a discovered sample rather than a complete staff list.

- Platform: LinkedIn
- Request: `GET https://api.toolzerhub.com/v1/linkedin/company/employees`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/linkedin/linked-in-company-employees

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `company` | query | yes | string | Company name to search for. |
| `roles` | query | no | string | Comma-separated role keywords to fan queries out over. Defaults to a broad built-in list. |
| `max_queries` | query | no | integer | Cap on role/query variants to run. Defaults to 6. Each variant beyond the first costs about 5 seconds, so raising this toward 20 risks the request timing out; split a deeper sweep across several calls instead. |
| `pages` | query | no | integer | Result pages per query, per engine. Defaults to 1; each extra page multiplies the whole sweep. |
| `engines` | query | no | string | Comma-separated search engines to fan out over: brave, ddg. Defaults to both -- their indexes are near-disjoint, so running just one leaves most of the roster undiscovered. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/linkedin/company/employees?company=<company>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.