> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.akta.pro/llms.txt
> Use this file to discover all available pages before exploring further.
# 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:** `/api/v1/company/headcount-trends`
## Authentication requirements
* Include a valid API key in the `x-api-key` request header.
## Request
### Request Parameters
#### Header Parameters
Your API key.
## URL Parameters
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
```bash theme={null}
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:
Container object holding the company's headcount data. See **Headcount Object Fields** below.
Credits consumed by the request.
#### Headcount Object Fields
Akta UUID of the company.
LinkedIn numeric username/identifier for the company page.
Company name as listed on LinkedIn.
LinkedIn company ID.
Current total employee count as of `date`.
Date the headcount snapshot was taken, formatted as `YYYY-MM-DD`.
Headcount growth rate over several trailing lookback windows. See **Growth Period Object** below.
Month-by-month historical headcount series. See **Headcount Monthly Object** below.
Current headcount broken down by job function. See **Headcount By Function Object** below.
#### Growth Period Object
Length of the trailing lookback window, in months (e.g. `6`, `12`, `24`).
Percentage change in total headcount over the lookback window.
#### Headcount Monthly Object
Total employee count as of `date`.
Snapshot date for this data point, formatted as `YYYY-MM-DD`.
#### Headcount By Function Object
Job function name (e.g. `Engineering`, `Sales`, `Arts and Design`).
Current employee count in this function.
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.
```json 200 expandable wrap theme={null}
{
"data": {
"uuid": "00000l1",
"linkedin_username": "canva",
"linkedin_official_name": "Canva",
"linkedin_id": "2850862",
"total_employees": 18966,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 29
},
{
"month_difference": 12,
"change_percentage": 75
},
{
"month_difference": 24,
"change_percentage": 117
}
],
"headcount_monthly": [
{
"employee_count": 8746,
"date": "2024-08-01"
},
{
"employee_count": 8853,
"date": "2024-09-01"
},
{
"employee_count": 8933,
"date": "2024-10-01"
},
{
"employee_count": 8983,
"date": "2024-11-01"
},
{
"employee_count": 9040,
"date": "2024-12-01"
},
{
"employee_count": 9334,
"date": "2025-01-01"
},
{
"employee_count": 9463,
"date": "2025-02-01"
},
{
"employee_count": 9619,
"date": "2025-03-01"
},
{
"employee_count": 9788,
"date": "2025-04-01"
},
{
"employee_count": 10010,
"date": "2025-05-01"
},
{
"employee_count": 10245,
"date": "2025-06-01"
},
{
"employee_count": 10474,
"date": "2025-07-01"
},
{
"employee_count": 10837,
"date": "2025-08-01"
},
{
"employee_count": 11116,
"date": "2025-09-01"
},
{
"employee_count": 11708,
"date": "2025-10-01"
},
{
"employee_count": 12447,
"date": "2025-11-01"
},
{
"employee_count": 13066,
"date": "2025-12-01"
},
{
"employee_count": 13968,
"date": "2026-01-01"
},
{
"employee_count": 14653,
"date": "2026-02-01"
},
{
"employee_count": 15337,
"date": "2026-03-01"
},
{
"employee_count": 16032,
"date": "2026-04-01"
},
{
"employee_count": 16847,
"date": "2026-05-01"
},
{
"employee_count": 17798,
"date": "2026-06-01"
},
{
"employee_count": 18495,
"date": "2026-07-01"
},
{
"employee_count": 18966,
"date": "2026-08-01"
}
],
"date": "2026-08-01",
"headcount_by_function": [
{
"name": "Arts and Design",
"employee_count": 5656,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 38
},
{
"month_difference": 12,
"change_percentage": 80
}
]
},
{
"name": "Engineering",
"employee_count": 2541,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 13
},
{
"month_difference": 12,
"change_percentage": 34
}
]
},
{
"name": "Media and Communication",
"employee_count": 1414,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 33
},
{
"month_difference": 12,
"change_percentage": 81
}
]
},
{
"name": "Marketing",
"employee_count": 1107,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 34
},
{
"month_difference": 12,
"change_percentage": 66
}
]
},
{
"name": "Education",
"employee_count": 1022,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 47
},
{
"month_difference": 12,
"change_percentage": 173
}
]
},
{
"name": "Sales",
"employee_count": 821,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 41
},
{
"month_difference": 12,
"change_percentage": 115
}
]
},
{
"name": "Administrative",
"employee_count": 644,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 42
},
{
"month_difference": 12,
"change_percentage": 132
}
]
},
{
"name": "Operations",
"employee_count": 594,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 31
},
{
"month_difference": 12,
"change_percentage": 105
}
]
},
{
"name": "Information Technology",
"employee_count": 588,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 7
},
{
"month_difference": 12,
"change_percentage": 27
}
]
},
{
"name": "Support",
"employee_count": 403,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 21
},
{
"month_difference": 12,
"change_percentage": 54
}
]
},
{
"name": "Business Development",
"employee_count": 416,
"growth_periods": [
{
"month_difference": 6,
"change_percentage": 25
},
{
"month_difference": 12,
"change_percentage": 108
}
]
}
]
},
"credits_consumed": 2.5
}
```
## OpenAPI
````yaml GET /v1/company/headcount-trends
openapi: 3.0.3
info:
title: Akta.pro API
description: >
Akta provides APIs for company intelligence and news monitoring:
1. **News** – Enriched news articles with AI summaries, sentiment, event
tags, industry classifications, and company mention resolution.
2. **Company Enrichment** – Structured company data including firmographics,
funding, headcount, and financials.
3. **Company Search** – Free endpoint to resolve company names, domains, or
UUIDs.
4. **Product Reviews** – G2 product reviews with ratings and review content.
5. **Employee Reviews** – Employee sentiment data with workplace ratings.
**Authentication:** All endpoints require an API key in the `x-api-key` HTTP
header.
version: 1.0.0
contact:
url: https://akta.pro
servers:
- url: https://api.akta.pro/api
description: Production server
security: []
tags:
- name: News
description: Enriched news articles with AI summaries, sentiment, and company mentions
- name: Company
description: Company data enrichment, search, and addition
- name: Reviews
description: Product and employee reviews from external sources
- name: Supporting APIs
description: Utility endpoints for request tracking
- name: List Generation
description: >-
Build targeted company lists using structured filters or natural language
queries
externalDocs:
description: Official Akta.pro API Documentation
url: https://docs.akta.pro
paths:
/v1/company/headcount-trends:
get:
tags:
- Company
summary: Headcount Trends
description: >
Fetches a company's LinkedIn-sourced headcount data, including total
employee count, historical growth trends, and a functional breakdown of
the workforce.
operationId: getHeadcountTrends
parameters:
- name: company
in: query
required: true
schema:
type: string
description: >-
Company website (e.g. 'canva.com') or a company UUID. The UUID can
be obtained from the Company Search API.
responses:
'200':
description: Headcount trends data returned
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
uuid:
type: string
linkedin_username:
type: string
linkedin_official_name:
type: string
total_employees:
type: integer
date:
type: string
growth_periods:
type: array
items:
type: string
headcount_growth:
type: array
items:
type: object
headcount_by_function:
type: array
items:
type: object
credits_consumed:
type: number
format: float
'401':
description: Unauthorized — missing or invalid API key.
security:
- xApiKeyAuth: []
components:
securitySchemes:
xApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key obtained from your Akta account.
````