Back to blog
6 min read

Company Enrichment API: Headcount by Seniority

By Kooperativa Engineering

A company enrichment API that returns "employee_count: 240" and stops there has told you almost nothing useful for account scoring, competitive research, or figuring out who to talk to. Two companies at 240 people can have entirely different shapes: one is 80 percent engineering building a product, the other is 80 percent sales scaling distribution on a product that already exists.

The fix is not a better single number, it is breaking that number down by seniority band, which turns a headcount figure into something closer to an org chart.

What a seniority breakdown actually returns

Here is a real response for a mid-size company, broken into five bands:

GET /api/v1/company/headcount-by-seniorityjson
{
  "company_id": "2135371",
  "total_indexed": 2847,
  "breakdown": {
    "c-level": 38,
    "vp": 6,
    "director": 28,
    "manager": 432,
    "individual": 2343
  }
}

The five bands sum to total_indexed exactly. individual is derived, not measured directly: it is everyone who does not fall into the four named leadership bands above it, which includes both senior ICs and entry-level staff. That is a real limitation worth knowing before you use this for anything precise about seniority mix within the individual-contributor population itself.

Combining this with hiring activity

Headcount by seniority describes the current shape of a company. Hiring signals describe the direction it is moving. Pairing the two answers a more specific question than either alone: not just "is this company growing" but "is this company building product or building sales capacity right now."

A company where recent hires are mostly individual contributors is in a build phase. A company where recent hires are mostly directors and VPs is scaling leadership, usually ahead of a broader hiring push. Neither of those stories is visible from a flat employee count.

One honest caveat

total_indexed reflects profiles indexed in a given dataset, not a company's official headcount as reported to investors or regulators. It is a strong directional signal, not an audited figure, and any enrichment provider that presents it as an exact employee count is overstating what the underlying data actually supports.

Get started

Try Kooperativa

One API key. Person and company enrichment, structured search, and monitors under one flat license.

Keep reading