Headcount Trends API
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 API
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.The Headcount Trends API is available on Subscription and Enterprise plans only. Requests on the Pay-as-you-go plan will return a
403 error. See Pricing for plan details.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
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
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:Headcount Object Fields
Headcount growth rate over several trailing lookback windows. See Growth Period Object below.
Current headcount broken down by job function. See Headcount By Function Object below.
Growth Period Object
Headcount Monthly Object
Headcount By Function Object
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
}
Was this page helpful?
.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)