.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=e0cafcb914826d8adc60e5092187e1ca)
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=f214ebe0a940d8aa0f19a709a6bfd7fa)
Headcount Trends
curl --request GET \
--url https://api.akta.pro/api/v1/company/headcount-trends \
--header 'x-api-key: <api-key>'import requests
url = "https://api.akta.pro/api/v1/company/headcount-trends"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.akta.pro/api/v1/company/headcount-trends', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.akta.pro/api/v1/company/headcount-trends",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/company/headcount-trends"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.akta.pro/api/v1/company/headcount-trends")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/company/headcount-trends")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
Alternative Signals
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.
GET
/
v1
/
company
/
headcount-trends
Headcount Trends
curl --request GET \
--url https://api.akta.pro/api/v1/company/headcount-trends \
--header 'x-api-key: <api-key>'import requests
url = "https://api.akta.pro/api/v1/company/headcount-trends"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.akta.pro/api/v1/company/headcount-trends', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.akta.pro/api/v1/company/headcount-trends",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/company/headcount-trends"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.akta.pro/api/v1/company/headcount-trends")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/company/headcount-trends")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
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-keyrequest header.
Request
Request Parameters
Header Parameters
string
required
Your API key.
URL Parameters
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:object
Container object holding the company’s headcount data. See Headcount Object Fields below.
float
Credits consumed by the request.
Headcount Object Fields
string
Akta UUID of the company.
string
LinkedIn numeric username/identifier for the company page.
string
Company name as listed on LinkedIn.
string
LinkedIn company ID.
integer
Current total employee count as of
date.string
Date the headcount snapshot was taken, formatted as
YYYY-MM-DD.array of objects
Headcount growth rate over several trailing lookback windows. See Growth Period Object below.
array of objects
Month-by-month historical headcount series. See Headcount Monthly Object below.
array of objects
Current headcount broken down by job function. See Headcount By Function Object below.
Growth Period Object
integer
Length of the trailing lookback window, in months (e.g.
6, 12, 24).integer
Percentage change in total headcount over the lookback window.
Headcount Monthly Object
integer
Total employee count as of
date.string
Snapshot date for this data point, formatted as
YYYY-MM-DD.Headcount By Function Object
string
Job function name (e.g.
Engineering, Sales, Arts and Design).integer
Current employee count in this function.
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.{
"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
}
Authorizations
API key obtained from your Akta account.
Query Parameters
Company website (e.g. 'canva.com') or a company UUID. The UUID can be obtained from the Company Search API.