> ## 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.

# Company Employee Count

> Get detailed employee metrics and department breakdown for a company

## 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

<ParamField header="X-API-KEY" type="string" required>
  Your Tuesday API key
</ParamField>

## Query Parameters

<ParamField query="linkedin_url" type="string">
  LinkedIn company page URL

  **Example:** `https://www.linkedin.com/company/salesforce`

  **Note:** Either `linkedin_url` or `domain` is required
</ParamField>

<ParamField query="domain" type="string">
  Company domain name

  **Example:** `salesforce.com`

  **Note:** Either `linkedin_url` or `domain` is required
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="Employee Count Data">
    <ResponseField name="company_id" type="string">
      Unique identifier for the company
    </ResponseField>

    <ResponseField name="company_name" type="string">
      Company name
    </ResponseField>

    <ResponseField name="total_employees" type="number">
      Total estimated employee count
    </ResponseField>

    <ResponseField name="employee_range" type="string">
      Employee count range (e.g., "1001-5000")
    </ResponseField>

    <ResponseField name="last_updated" type="string">
      Date when the data was last updated (ISO 8601 format)
    </ResponseField>

    <ResponseField name="departments" type="object">
      Employee count by department

      <Expandable title="Department Breakdown">
        <ResponseField name="engineering" type="number">
          Engineering and technical staff
        </ResponseField>

        <ResponseField name="sales" type="number">
          Sales and business development
        </ResponseField>

        <ResponseField name="marketing" type="number">
          Marketing and communications
        </ResponseField>

        <ResponseField name="operations" type="number">
          Operations and administrative
        </ResponseField>

        <ResponseField name="human_resources" type="number">
          HR and people operations
        </ResponseField>

        <ResponseField name="finance" type="number">
          Finance and accounting
        </ResponseField>

        <ResponseField name="customer_success" type="number">
          Customer success and support
        </ResponseField>

        <ResponseField name="product" type="number">
          Product management and design
        </ResponseField>

        <ResponseField name="other" type="number">
          Other departments
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="seniority" type="object">
      Employee count by seniority level

      <Expandable title="Seniority Breakdown">
        <ResponseField name="c_suite" type="number">
          C-level executives
        </ResponseField>

        <ResponseField name="vp" type="number">
          Vice presidents
        </ResponseField>

        <ResponseField name="director" type="number">
          Directors
        </ResponseField>

        <ResponseField name="manager" type="number">
          Managers
        </ResponseField>

        <ResponseField name="senior" type="number">
          Senior-level staff
        </ResponseField>

        <ResponseField name="staff" type="number">
          Staff-level employees
        </ResponseField>

        <ResponseField name="intern" type="number">
          Interns and entry-level
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="growth_metrics" type="object">
      Hiring and growth trends

      <Expandable title="Growth Data">
        <ResponseField name="monthly_growth_rate" type="number">
          Monthly employee growth rate (percentage)
        </ResponseField>

        <ResponseField name="quarterly_growth_rate" type="number">
          Quarterly employee growth rate (percentage)
        </ResponseField>

        <ResponseField name="yearly_growth_rate" type="number">
          Annual employee growth rate (percentage)
        </ResponseField>

        <ResponseField name="recent_hires_30d" type="number">
          New hires in the last 30 days
        </ResponseField>

        <ResponseField name="recent_hires_90d" type="number">
          New hires in the last 90 days
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="locations" type="array">
      Employee distribution by office location

      <Expandable title="Location Distribution">
        <ResponseField name="city" type="string">
          City name
        </ResponseField>

        <ResponseField name="state" type="string">
          State/region
        </ResponseField>

        <ResponseField name="country" type="string">
          Country
        </ResponseField>

        <ResponseField name="employee_count" type="number">
          Employee count at this location
        </ResponseField>

        <ResponseField name="percentage" type="number">
          Percentage of total workforce
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="trends" type="object">
      Historical employee count trends

      <Expandable title="Historical Trends">
        <ResponseField name="6_months_ago" type="number">
          Employee count 6 months ago
        </ResponseField>

        <ResponseField name="12_months_ago" type="number">
          Employee count 12 months ago
        </ResponseField>

        <ResponseField name="24_months_ago" type="number">
          Employee count 24 months ago
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="statusCode" type="number">
  HTTP status code (200 for success)
</ResponseField>

<ResponseField name="message" type="string">
  Response message
</ResponseField>

## Example Requests

<CodeGroup>
  ```bash Company Domain theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/employee-count?domain=salesforce.com' \
  --header 'X-API-KEY: your-api-key-here'
  ```

  ```bash LinkedIn URL theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/employee-count?linkedin_url=https://www.linkedin.com/company/salesforce' \
  --header 'X-API-KEY: your-api-key-here'
  ```

  ```javascript JavaScript theme={null}
  const getEmployeeMetrics = async (domain) => {
    const params = new URLSearchParams({ domain });

    const response = await fetch(
      `https://api.tuesday.so/api/v1/company/employee-count?${params}`,
      {
        headers: {
          'X-API-KEY': 'your-api-key-here'
        }
      }
    );

    const metrics = await response.json();
    return metrics;
  };

  // Usage
  const salesforceMetrics = await getEmployeeMetrics('salesforce.com');
  console.log(`Total Employees: ${salesforceMetrics.data.total_employees}`);
  console.log(`Engineering: ${salesforceMetrics.data.departments.engineering}`);
  console.log(`Monthly Growth: ${salesforceMetrics.data.growth_metrics.monthly_growth_rate}%`);
  ```

  ```python Python theme={null}
  import requests

  def get_employee_count(domain=None, linkedin_url=None):
      url = "https://api.tuesday.so/api/v1/company/employee-count"
      
      params = {}
      if domain:
          params['domain'] = domain
      elif linkedin_url:
          params['linkedin_url'] = linkedin_url
      else:
          raise ValueError("Either domain or linkedin_url is required")
      
      headers = {'X-API-KEY': 'your-api-key-here'}
      
      response = requests.get(url, params=params, headers=headers)
      return response.json()

  # Usage
  metrics = get_employee_count(domain='salesforce.com')

  print(f"Company: {metrics['data']['company_name']}")
  print(f"Total Employees: {metrics['data']['total_employees']}")
  print(f"Engineering: {metrics['data']['departments']['engineering']}")
  print(f"Sales: {metrics['data']['departments']['sales']}")
  print(f"Recent Hires (30d): {metrics['data']['growth_metrics']['recent_hires_30d']}")
  ```

  ```php PHP theme={null}
  <?php
  function getEmployeeCount($domain = null, $linkedinUrl = null) {
      $params = [];
      
      if ($domain) {
          $params['domain'] = $domain;
      } elseif ($linkedinUrl) {
          $params['linkedin_url'] = $linkedinUrl;
      } else {
          throw new Exception("Either domain or linkedin_url is required");
      }
      
      $queryString = http_build_query($params);
      
      $ch = curl_init();
      curl_setopt($ch, CURLOPT_URL, "https://api.tuesday.so/api/v1/company/employee-count?$queryString");
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($ch, CURLOPT_HTTPHEADER, [
          'X-API-KEY: your-api-key-here'
      ]);
      
      $response = curl_exec($ch);
      curl_close($ch);
      
      return json_decode($response, true);
  }

  // Usage
  $metrics = getEmployeeCount('salesforce.com');
  echo "Total Employees: " . $metrics['data']['total_employees'] . "\n";
  echo "Engineering: " . $metrics['data']['departments']['engineering'] . "\n";
  echo "Monthly Growth: " . $metrics['data']['growth_metrics']['monthly_growth_rate'] . "%\n";
  ?>
  ```
</CodeGroup>

## Example Response

<ResponseExample>
  ```json Response theme={null}
  {
      "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"
  }
  ```
</ResponseExample>

## Data Insights & Analysis

<AccordionGroup>
  <Accordion title="Department Breakdown 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
  </Accordion>

  <Accordion title="Growth Rate Interpretation">
    **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
  </Accordion>

  <Accordion title="Location Distribution">
    **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
  </Accordion>
</AccordionGroup>

## Credit Usage

<div className="border rounded-lg p-4 text-center my-6">
  <div className="text-3xl font-bold text-blue-600">
    {2}
  </div>

  <div className="text-sm text-gray-600">Credits per request</div>
</div>

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

## Use Cases

<CardGroup cols={2}>
  <Card title="Competitive Analysis" icon="chart-bar">
    Compare team sizes and growth rates against competitors
  </Card>

  <Card title="Market Sizing" icon="calculator">
    Estimate total addressable market based on employee counts
  </Card>

  <Card title="Recruitment Strategy" icon="users">
    Identify rapidly growing companies and departments for talent sourcing
  </Card>

  <Card title="Sales Intelligence" icon="chart-line">
    Qualify leads based on company size and growth trajectory
  </Card>

  <Card title="Investment Research" icon="chart-bar">
    Analyze growth patterns for investment due diligence
  </Card>

  <Card title="Partnership Evaluation" icon="handshake">
    Assess potential partners' scale and capabilities
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Data Interpretation">
    **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
  </Accordion>

  <Accordion title="Accuracy Expectations">
    **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
  </Accordion>

  <Accordion title="Update Frequency">
    **Data Refresh Schedule:**

    * Total employee count: Updated weekly
    * Department breakdown: Updated monthly
    * Growth metrics: Updated monthly
    * Location data: Updated quarterly
    * Historical trends: Updated monthly
  </Accordion>
</AccordionGroup>

## Error Responses

<AccordionGroup>
  <Accordion title="400 Bad Request - Missing Parameters">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request",
        "error": "Either domain or linkedin_url parameter is required"
    }
    ```
  </Accordion>

  <Accordion title="404 Not Found - Company Not Found">
    ```json theme={null}
    {
        "statusCode": 404,
        "message": "Not Found",
        "error": "No employee data found for the specified company"
    }
    ```
  </Accordion>

  <Accordion title="400 Bad Request - Insufficient Data">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request", 
        "error": "Company has insufficient public employee data for analysis"
    }
    ```
  </Accordion>
</AccordionGroup>

## Analytics Examples

<CodeGroup>
  ```javascript Department Analysis theme={null}
  // 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;
  };
  ```

  ```python Growth Analysis theme={null}
  def analyze_growth_trends(employee_data):
      """Analyze company growth patterns"""
      current = employee_data['total_employees']
      trends = employee_data['trends']
      growth = employee_data['growth_metrics']
      
      analysis = {
          'growth_stage': 'stable',
          'hiring_velocity': 'normal',
          'trajectory': 'positive'
      }
      
      # Determine growth stage
      monthly_rate = growth['monthly_growth_rate']
      if monthly_rate > 10:
          analysis['growth_stage'] = 'hypergrowth'
      elif monthly_rate > 5:
          analysis['growth_stage'] = 'high_growth'
      elif monthly_rate > 2:
          analysis['growth_stage'] = 'growth'
      elif monthly_rate < 0:
          analysis['growth_stage'] = 'contracting'
      
      # Hiring velocity
      recent_hires = growth['recent_hires_30d']
      hire_rate = (recent_hires / current) * 100
      if hire_rate > 5:
          analysis['hiring_velocity'] = 'aggressive'
      elif hire_rate > 2:
          analysis['hiring_velocity'] = 'active'
      elif hire_rate < 0.5:
          analysis['hiring_velocity'] = 'conservative'
      
      return analysis
  ```
</CodeGroup>

## Related Endpoints

* [Company Profile API](/api-reference/company/profile) - Get comprehensive company information
* [Company Employee Search](/api-reference/company/employee-search) - Find specific employees within companies
* [Company Search API](/api-reference/company/search) - Search for companies by size and other criteria
* [People Search API](/api-reference/people/search) - Find people at companies with employee count filters