Company Employee Count

GET

api

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 URL

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

Note: Either linkedin_url or domain is required

domain

string

Company domain name

Example: salesforce.com

Note: Either linkedin_url or domain is required

Response

data

object

Show Employee Count Data

company_id

string

Unique identifier for the company

company_name

string

Company name

total_employees

number

Total estimated employee count

employee_range

string

Employee count range (e.g., “1001-5000”)

last_updated

string

Date when the data was last updated (ISO 8601 format)

departments

object

Employee count by department

Show Department Breakdown

engineering

number

Engineering and technical staff

sales

number

Sales and business development

marketing

number

Marketing and communications

operations

number

Operations and administrative

human_resources

number

HR and people operations

finance

number

Finance and accounting

customer_success

number

Customer success and support

product

number

Product management and design

other

number

Other departments

seniority

object

Employee count by seniority level

Show Seniority Breakdown

c_suite

number

C-level executives

number

Vice presidents

director

number

Directors

manager

number

Managers

senior

number

Senior-level staff

staff

number

Staff-level employees

intern

number

Interns and entry-level

growth_metrics

object

Hiring and growth trends

Show Growth Data

monthly_growth_rate

number

Monthly employee growth rate (percentage)

quarterly_growth_rate

number

Quarterly employee growth rate (percentage)

yearly_growth_rate

number

Annual employee growth rate (percentage)

recent_hires_30d

number

New hires in the last 30 days

recent_hires_90d

number

New hires in the last 90 days

locations

array

Employee distribution by office location

Show Location Distribution

city

string

City name

state

string

State/region

country

string

Country

employee_count

number

Employee count at this location

percentage

number

Percentage of total workforce

trends

object

Historical employee count trends

Show Historical Trends

6_months_ago

number

Employee count 6 months ago

12_months_ago

number

Employee count 12 months ago

24_months_ago

number

Employee count 24 months ago

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

Department Breakdown Analysis

Growth Rate Interpretation

Location Distribution

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

Data Interpretation

Accuracy Expectations

Update Frequency

Error Responses

400 Bad Request - Missing Parameters

404 Not Found - Company Not Found

400 Bad Request - Insufficient Data

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

Company Profile API - Get comprehensive company information
Company Employee Search - Find specific employees within companies
Company Search API - Search for companies by size and other criteria
People Search API - Find people at companies with employee count filters

Get Company Profile Company Employee Search

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"
}

Authentication

People APIs

Company APIs

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Data Insights & Analysis

Credit Usage

Use Cases

Competitive Analysis

Market Sizing

Recruitment Strategy

Sales Intelligence

Investment Research

Partnership Evaluation

Best Practices

Error Responses

Analytics Examples

Authentication

People APIs

Company APIs

​Overview

​Authentication

​Query Parameters

​Response

​Example Requests

​Example Response

​Data Insights & Analysis

​Credit Usage

​Use Cases

Competitive Analysis

Market Sizing

Recruitment Strategy

Sales Intelligence

Investment Research

Partnership Evaluation

​Best Practices

​Error Responses

​Analytics Examples

​Related Endpoints

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Data Insights & Analysis

Credit Usage

Use Cases

Best Practices

Error Responses

Analytics Examples

Related Endpoints