Skip to main content
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tuesday.so/llms.txt

Use this file to discover all available pages before exploring further.

​
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

Common Patterns:
  • Technology Companies: Engineering typically 25-40% of workforce
  • SaaS Companies: Sales often 15-25%, Customer Success 10-20%
  • Enterprise Software: Product teams usually 5-15% of total
  • Startups: Higher percentage of senior roles vs. established companies
Growth Rate Benchmarks:
  • High Growth: >5% monthly, >20% annually
  • Moderate Growth: 1-5% monthly, 5-20% annually
  • Stable: <1% monthly, <5% annually
  • Contracting: Negative growth rates
Industry Considerations:
  • Startups: Often 10-30% monthly growth
  • Scale-ups: 3-10% monthly growth
  • Enterprise: 1-5% monthly growth
Remote Work Trends:
  • “Remote” location indicates distributed workforce
  • High remote percentage suggests flexible work policies
  • Multiple major cities indicate geographic expansion strategy
Hiring Hubs:
  • Tech hubs: SF, NYC, Seattle, Austin
  • International: London, Toronto, Dublin
  • Cost-effective: Atlanta, Denver, Austin

​
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

Consider Context:
  • Recent layoffs may show in historical trends
  • Acquisitions can cause sudden employee count spikes
  • Seasonal hiring (interns) affects certain periods
  • Remote work adoption changed location distributions
Data Quality by Company Type:
  • Large public companies: 90-95% accuracy
  • Mid-size private companies: 85-90% accuracy
  • Startups (<100 employees): 75-85% accuracy
  • Very small companies (<20 employees): 60-75% accuracy
Data Refresh Schedule:
  • Total employee count: Updated weekly
  • Department breakdown: Updated monthly
  • Growth metrics: Updated monthly
  • Location data: Updated quarterly
  • Historical trends: Updated monthly

​
Error Responses

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Either domain or linkedin_url parameter is required"
}

{
    "statusCode": 404,
    "message": "Not Found",
    "error": "No employee data found for the specified company"
}

{
    "statusCode": 400,
    "message": "Bad Request", 
    "error": "Company has insufficient public employee data for analysis"
}

​
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;
};