Historical Headcount API

this section covers general details about historical headcount api find out more contact our sales team to get access to more information about this api historical headcount api endpoints historical headcount data enables you to see how companies’ social media following and headcount numbers have changed over time retrieve the historical headcount data using two collection endpoints collect the data using either company id or company shorthand name request type endpoint get / ​v2/historical headcount/collect/{company id} get / ​v2/historical headcount/collect/ {shorthand name} 📌 full profile url example www professional network com/example company shorthand name example example company request types a ll historical headcount api requests must be made over https requests made over http will fail historical headcount api supports get http r equests only request type endpoint get / ​v2/historical headcount/collect/{company id} get / ​v2/historical headcount/collect/ {shorthand name} rate limits historical headcount api endpoints restrict the number of requests allowed per second for each client's api token historical headcount api endpoints allow 54 requests per second credits and tokens the token issued for you has a set amount of search and collect credits one collect credit is deducted for one successful (200) request in the collection endpoints ​ / ​v2/historical headcount/collect/{company id} / ​v2/historical headcount/collect/{shorthand name} historical headcount data the data you receive from the historical headcount api differs from company data how often is the data updated? historical headcount data is updated once a month (at the beginning of the month) available data points data point description data type created record creation timestamp s tring company id company record id assigned in the database integer source id professional network in house company id (static) integer professional network url professional network p rofile url note seen as canonical url in our company data s tring shorthand name dynamic part of the url used to identify companies note seen as company shorthand name in our company data s tring canonical shorthand name most recent version of the shorthand name s tring name name s tring website website s tring size employee count s tring industry associated industry s tring type type s tring location location s tring country location (country) s tring headcount headcount integer follower count profile follower count integer first example \[ { "created" "2023 12 19 08 42 33", "company id" 8579547, "source id" 1586, "professional network url" "https //www professional network com/company/example company", "shorthand name" "example company", "canonical shorthand name" "example company", "name" "amazon", "website" "https //www example company com/", "size" "10,001+ employees", "industry" "software development", "type" "private company", "location" "san francisco, ca", "country" "united states", "headcount" 119730, "follower count" 229985793 }, { "created" "2023 11 21 09 54 07", "company id" 8579547, "source id" 1586, "professional network url" "https //www professional network com/company/example company", "shorthand name" "example company", "canonical shorthand name" "example company", "name" "amazon", "website" "https //www about example company com/", "size" "10,001+ employees", "industry" "software development", "type" "private company", "location" "san francisco, ca", "country" "united states", "headcount" 86538, "follower count" 1711354 }, { "created" "2023 10 08 18 22 51", "company id" 8579547, "source id" 1586, "professional network url" "https //www professional network com/company/example company", "shorthand name" "example company", "canonical shorthand name" "example company", "name" "amazon", "website" "https //www example company com/", "size" "10,001+ employees", "industry" "software development", "type" "private company", "location" "san francisco, ca", "country" "united states", "headcount" 10350, "follower count" 12866 } ] relevant topics authorization docid\ tktw cgpqdgjronl09vnj response codes docid\ sp7phdapzbmyiyggsihfw