Get headcount
Current headcount by department, and total headcount per month for the last 12 months. Costs 1 lookup, free if the company is already paid for this billing month.
bearerAuthAuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.
company*stringThe company's domain (for example stripe.com) or its CompanySpec id (for example cmp_8f2k1).
Headcount.
application/json- response
headcount*usage*What this request cost and what is left this billing month.
curl -X GET 'https://api.companyspec.com/v1/companies/acmedental.io/headcount'{ "headcount": { "employee_count": 142, "departments": [ { "department": "engineering", "employee_count": 48 }, { "department": "sales", "employee_count": 31 } ], "history": [ { "month": "2026-08", "employee_count": 131 }, { "month": "2026-09", "employee_count": 137 }, { "month": "2026-10", "employee_count": 142 } ] }, "usage": { "charged": { "lookups": 0, "discoveries": 0 }, "already_paid": 1, "remaining": { "lookups": 9750, "discoveries": 1977 } }}Get technologies GET
Every technology we have detected for the company: where we found it (`website` or `jobs`), when it was first seen and, if they stopped using it, when. `explanation` says in plain words what we found. Costs 1 lookup, free if the company is already paid for this billing month.
Get recent hires GET
People who recently joined the company, counted by department and seniority, plus the most recent hires (up to 100). Departments come from `/values/hire_departments` and seniorities from `/values/hire_seniorities`. No names or personal details are returned. Costs 1 lookup, free if the company is already paid for this billing month. New hires usually appear 1–3 weeks after their start date.