Headcount Trends API

Fetches a company’s LinkedIn-sourced headcount data, including total employee count, historical growth trends, and a functional breakdown of the workforce.

Overview

The Headcount Trends API returns a company’s employee headcount signals sourced from LinkedIn, including the current total employee count, month-over-month headcount history, growth rates over multiple lookback periods, and a breakdown of headcount by function (e.g. Engineering, Sales, Marketing). Results are returned in the API response.

Endpoint Details

• Method: GET
• Endpoint: /v1/company/headcount-trends

Authentication requirements

• Include a valid API key in the x-api-key request header.

Request

Request Parameters

Header Parameters

x-api-key · string · required

Your API key.

URL Parameters

company · string · required

Company website (e.g. canva.com) or a company UUID (e.g. 00000l1). The UUID can be obtained from the Company Search API.

Example Request

curl -G "https://api.akta.pro/api/v1/company/headcount-trends/" \
  --data-urlencode "company=00000l1" \
  -H "x-api-key: YOUR_API_KEY"

Response

Successful Response Fields

Returns a JSON object with the following structure:

data · object

Container object holding the company’s headcount data. See Headcount Object Fields below.

credits_consumed · float

Credits consumed by the request.

Headcount Object Fields

uuid · string

Akta UUID of the company.

linkedin_username · string

LinkedIn numeric username/identifier for the company page.

linkedin_official_name · string

Company name as listed on LinkedIn.

linkedin_id · string

LinkedIn company ID.

total_employees · integer

Current total employee count as of date.

date · string

Date the headcount snapshot was taken, formatted as YYYY-MM-DD.

growth_periods · array of objects

Headcount growth rate over several trailing lookback windows. See Growth Period Object below.

headcount_growth · array of objects

Month-by-month historical headcount series. See Headcount Growth Object below.

headcount_by_function · array of objects

Current headcount broken down by job function. See Headcount By Function Object below.

Growth Period Object

month_difference · integer

Length of the trailing lookback window, in months (e.g. 6, 12, 24).

change_percentage · integer

Percentage change in total headcount over the lookback window.

Headcount Growth Object

employee_count · integer

Total employee count as of date.

date · string

Snapshot date for this data point, formatted as YYYY-MM-DD.

Headcount By Function Object

name · string

Job function name (e.g. Engineering, Sales, Arts and Design).

employee_count · integer

Current employee count in this function.

growth_periods · array of objects

Growth rate for this function over trailing lookback windows. Same shape as the top-level Growth Period Object, typically returned for 6 and 12 month windows.

200

{
  "data": {
    "uuid": "00000l1",
    "linkedin_username": "2850862",
    "linkedin_official_name": "Canva",
    "linkedin_id": "2850862",
    "total_employees": 17694,
    "growth_periods": [
      {
        "month_difference": 6,
        "change_percentage": 29
      },
      {
        "month_difference": 12,
        "change_percentage": 73
      },
      {
        "month_difference": 24,
        "change_percentage": 111
      }
    ],
    "headcount_growth": [
      {
        "employee_count": 8376,
        "date": "2024-07-01"
      },
      {
        "employee_count": 9076,
        "date": "2025-01-01"
      },
      {
        "employee_count": 10202,
        "date": "2025-07-01"
      },
      {
        "employee_count": 13716,
        "date": "2026-01-01"
      },
      {
        "employee_count": 17694,
        "date": "2026-07-01"
      }
    ],
    "date": "2026-07-01",
    "headcount_by_function": [
      {
        "name": "Arts and Design",
        "employee_count": 5113,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 42
          },
          {
            "month_difference": 12,
            "change_percentage": 78
          }
        ]
      },
      {
        "name": "Engineering",
        "employee_count": 2544,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 18
          },
          {
            "month_difference": 12,
            "change_percentage": 35
          }
        ]
      },
      {
        "name": "Sales",
        "employee_count": 769,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 51
          },
          {
            "month_difference": 12,
            "change_percentage": 124
          }
        ]
      }
    ]
  },
  "credits_consumed": 2.5
}