GET
/
api
/
v1
/
company
/
employee-count
Company Employee Count
curl --request GET \
  --url https://api.tuesday.so/api/v1/company/employee-count \
  --header 'X-API-KEY: <x-api-key>'
{
    "data": {
        "company_id": "tu_cmp_sf2023",
        "company_name": "Salesforce",
        "total_employees": 79390,
        "employee_range": "10001+",
        "last_updated": "2024-01-15T10:30:00Z",
        "departments": {
            "engineering": 18500,
            "sales": 15800,
            "marketing": 4200,
            "operations": 8900,
            "human_resources": 2100,
            "finance": 1800,
            "customer_success": 12400,
            "product": 3200,
            "other": 12490
        },
        "seniority": {
            "c_suite": 25,
            "vp": 180,
            "director": 1250,
            "manager": 6800,
            "senior": 22100,
            "staff": 47200,
            "intern": 1835
        },
        "growth_metrics": {
            "monthly_growth_rate": 2.3,
            "quarterly_growth_rate": 7.1,
            "yearly_growth_rate": 15.4,
            "recent_hires_30d": 1820,
            "recent_hires_90d": 5640
        },
        "locations": [
            {
                "city": "San Francisco",
                "state": "California",
                "country": "United States",
                "employee_count": 12500,
                "percentage": 15.7
            },
            {
                "city": "New York",
                "state": "New York",
                "country": "United States",
                "employee_count": 8200,
                "percentage": 10.3
            },
            {
                "city": "Atlanta",
                "state": "Georgia",
                "country": "United States",
                "employee_count": 6800,
                "percentage": 8.6
            },
            {
                "city": "London",
                "state": null,
                "country": "United Kingdom",
                "employee_count": 4500,
                "percentage": 5.7
            },
            {
                "city": "Remote",
                "state": null,
                "country": "Global",
                "employee_count": 25400,
                "percentage": 32.0
            }
        ],
        "trends": {
            "6_months_ago": 76200,
            "12_months_ago": 73500,
            "24_months_ago": 68800
        }
    },
    "statusCode": 200,
    "message": "Success"
}

​
Overview

Get comprehensive employee analytics for a company including total headcount, department distribution, seniority breakdown, recent hiring trends, and growth metrics. Perfect for market sizing, competitive analysis, and recruitment planning.

​
Authentication

​
X-API-KEY
string
required
Your Tuesday API key

​
Query Parameters

​
linkedin_url
string
LinkedIn company page URLExample: https://www.linkedin.com/company/salesforceNote: Either linkedin_url or domain is required
​
domain
string
Company domain nameExample: salesforce.comNote: Either linkedin_url or domain is required

​
Response

​
data
object
​
statusCode
number
HTTP status code (200 for success)
​
message
string
Response message

​
Example Requests

curl --location 'https://api.tuesday.so/api/v1/company/employee-count?domain=salesforce.com' \
--header 'X-API-KEY: your-api-key-here'

​
Example Response

{
    "data": {
        "company_id": "tu_cmp_sf2023",
        "company_name": "Salesforce",
        "total_employees": 79390,
        "employee_range": "10001+",
        "last_updated": "2024-01-15T10:30:00Z",
        "departments": {
            "engineering": 18500,
            "sales": 15800,
            "marketing": 4200,
            "operations": 8900,
            "human_resources": 2100,
            "finance": 1800,
            "customer_success": 12400,
            "product": 3200,
            "other": 12490
        },
        "seniority": {
            "c_suite": 25,
            "vp": 180,
            "director": 1250,
            "manager": 6800,
            "senior": 22100,
            "staff": 47200,
            "intern": 1835
        },
        "growth_metrics": {
            "monthly_growth_rate": 2.3,
            "quarterly_growth_rate": 7.1,
            "yearly_growth_rate": 15.4,
            "recent_hires_30d": 1820,
            "recent_hires_90d": 5640
        },
        "locations": [
            {
                "city": "San Francisco",
                "state": "California",
                "country": "United States",
                "employee_count": 12500,
                "percentage": 15.7
            },
            {
                "city": "New York",
                "state": "New York",
                "country": "United States",
                "employee_count": 8200,
                "percentage": 10.3
            },
            {
                "city": "Atlanta",
                "state": "Georgia",
                "country": "United States",
                "employee_count": 6800,
                "percentage": 8.6
            },
            {
                "city": "London",
                "state": null,
                "country": "United Kingdom",
                "employee_count": 4500,
                "percentage": 5.7
            },
            {
                "city": "Remote",
                "state": null,
                "country": "Global",
                "employee_count": 25400,
                "percentage": 32.0
            }
        ],
        "trends": {
            "6_months_ago": 76200,
            "12_months_ago": 73500,
            "24_months_ago": 68800
        }
    },
    "statusCode": 200,
    "message": "Success"
}

​
Data Insights & Analysis

​
Credit Usage

Credits per request
Employee count and metrics require specialized data processing and analytics, resulting in a 2-credit cost per request.

​
Use Cases

Competitive Analysis

Compare team sizes and growth rates against competitors

Market Sizing

Estimate total addressable market based on employee counts

Recruitment Strategy

Identify rapidly growing companies and departments for talent sourcing

Sales Intelligence

Qualify leads based on company size and growth trajectory

Investment Research

Analyze growth patterns for investment due diligence

Partnership Evaluation

Assess potential partners’ scale and capabilities

​
Best Practices

​
Error Responses

​
Analytics Examples

// Analyze department distribution
const analyzeCompanyStructure = (employeeData) => {
  const departments = employeeData.departments;
  const total = employeeData.total_employees;
  
  const analysis = {
    engineeringRatio: (departments.engineering / total * 100).toFixed(1),
    salesRatio: (departments.sales / total * 100).toFixed(1),
    isEngineeringHeavy: departments.engineering > departments.sales,
    isSalesHeavy: departments.sales > departments.engineering,
    topDepartment: Object.keys(departments).reduce((a, b) => 
      departments[a] > departments[b] ? a : b
    )
  };
  
  return analysis;
};