# Company headcount API - Veezee

Employee count is the standard sizing signal: sales segmentation, market sizing, vendor due diligence. This call returns a company's employee count as listed on its LinkedIn page, alongside industry, headquarters, description, and founding year, so one call sizes and classifies the company at once.

Identify the company by URL, slug, or website domain; 4 credits base, with domains quoting 8 credits and the surcharge refunded for already-known domains.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/companies?identifier=microsoft" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_company`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_company",
    "arguments": {
      "identifier": "microsoft"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Company URL, slug (after /company/), or website domain (e.g. 'microsoft.com'). Numeric ids/URNs are not fetchable; use them only in linkedin_search_people company filters. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `company` envelope. Full field list: https://veezee.io/docs/fields#company

## Pricing

`linkedin_get_company` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_company). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Is there historical headcount?**

No time series: poll on your own schedule and store the counts to build growth curves.

**A per-department breakdown?**

No: the total employee count as LinkedIn lists it.

**How fresh is the count?**

Recent by default; paid keys can force a live read with `freshness=realtime` (2 credits extra).

## Read next

- [linkedin_get_company: the full reference](https://veezee.io/docs/tools/linkedin_get_company)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)