Employee Summary Metrics

Cumulative summary headcount metrics by employee type.

Omitting job_tags returns available tag rows. Multiple IDs select the union of individual or direct-parent tags. Categories can overlap; summing rows need not count unique employees. Current, alltime and expired counts describe observed job records; observation dates are not confirmed employment start or end dates.

Required permissions for your API key's user: corp.companies.

get/companies/{company_id}/employee-metrics

Request

Base URL
https://api.mixrank.com/v2/json/YOUR_API_KEY
Auth
none declared

Path parameters

company_idinteger required

MixRank company ID from /companies, /companies/match, or a company segment; distinct from linkedin.id.

Query parameters

job_tagsstring

Filters by specific employee type(s). Use comma-separated values for multiple IDs (e.g., job_tags=813,22). Refer to the Job Tags /jobtags endpoint for all valid values. Parent IDs can be used to filter by groups: 10029 -> Academic Qualification (e.g., 'High School', 'Bachelor Degree', ...) 10030 -> Country (e.g., 'United Kingdom', 'United States', ...) 10031 -> Employment Type (e.g., 'Full-time', 'Internship', ...) 10032 -> Function (e.g., 'Engineering', 'Human Resources', ...) 10033 -> Industry (e.g., 'Construction', 'Investment Banking', 'Armed Forces', ...) 10035 -> Seniority (e.g., 'Entry level', 'Vice President (VP)' ...)

Response

Successful response.

totalinteger nullable

Example response

{
  "total": 1,
  "results": [
    {
      "job_tag_label": "High School",
      "job_tag_id": 813,
      "job_count_current": 561,
      "job_count_alltime": 733,
      "job_count_expired": 172,
      "job_first_seen": "1964-04-01",
      "job_last_seen": "2026-08-01"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.