Company Employee Search

Overview

Search for employees within a specific company using filters like department, title, seniority, and location. Perfect for sales prospecting, recruitment, and competitive intelligence when you need to find specific people at target companies.

Authentication

X-API-KEY

string

required

Your Tuesday API key

Query Parameters

company_domain

string

Company domain to search withinExample: salesforce.comNote: Either company_domain or company_linkedin_url is required

company_linkedin_url

string

LinkedIn company page URLExample: https://www.linkedin.com/company/salesforceNote: Either company_domain or company_linkedin_url is required

title

string

Job title or role filter (supports partial matches)Examples: "Sales Director", "Software Engineer", "Marketing"

department

string

Department filterOptions: "Engineering", "Sales", "Marketing", "Operations", "Human Resources", "Finance", "Customer Success", "Product"

seniority

string

Seniority level filterOptions: "C-Suite", "VP", "Director", "Manager", "Senior", "Staff", "Intern"

location

string

Office location or geographic filterExamples: "San Francisco", "New York", "Remote", "California"

keywords

string

Keywords to search in employee profilesExamples: "machine learning", "enterprise sales", "product marketing"

limit

number

default:"10"

Maximum number of results to return (1-100)

offset

number

default:"0"

Number of results to skip for pagination

include_email

string

default:"exclude"

Include email addresses in resultsOptions: include | excludeAdditional Cost: +2 credits per result when set to include

include_phone

string

default:"exclude"

Include phone numbers in resultsOptions: include | excludeAdditional Cost: +3 credits per result when set to include

Response

data

array

Show Array of Employee Objects

string

Unique identifier for the person

name

string

Full name of the employee

first_name

string

First name

last_name

string

Last name

title

string

Current job title

department

string

Department classification

seniority

string

Seniority level

linkedin_url

string

LinkedIn profile URL

job_start_date

string

Start date at current company (YYYY-MM-DD format)

tenure_months

number

Number of months at the company

location

string

Work location (city, state or “Remote”)

string

Email address (when included)

mobile_number

string

Phone number (when included)

previous_companies

array

Previous work experience (limited)

company_info

object

Show Company Context

name

string

Company name

domain

string

Primary domain

total_employees_found

number

Total matching employees (respecting pagination)

pagination

object

Show Pagination Details

statusCode

number

HTTP status code (200 for success)

message

string

Response message

Example Requests

curl --location 'https://api.tuesday.so/api/v1/company/employee-search?company_domain=salesforce.com&title=Sales%20Director&department=Sales' \
--header 'X-API-KEY: your-api-key-here'

Example Response

{
    "data": [
        {
            "id": "tu_emp_sf_001",
            "name": "Sarah Chen",
            "first_name": "Sarah",
            "last_name": "Chen",
            "title": "Senior Sales Director",
            "department": "Sales", 
            "seniority": "Director",
            "linkedin_url": "https://www.linkedin.com/in/sarah-chen-sales",
            "job_start_date": "2021-08-15",
            "tenure_months": 28,
            "location": "San Francisco, CA",
            "email": "[email protected]",
            "mobile_number": "+1 415-555-0198",
            "previous_companies": [
                {
                    "name": "Oracle",
                    "title": "Sales Manager",
                    "duration_months": 36
                }
            ]
        },
        {
            "id": "tu_emp_sf_002", 
            "name": "Michael Rodriguez",
            "first_name": "Michael",
            "last_name": "Rodriguez",
            "title": "VP of Sales, Enterprise",
            "department": "Sales",
            "seniority": "VP",
            "linkedin_url": "https://www.linkedin.com/in/michael-rodriguez-sales-vp",
            "job_start_date": "2019-03-01",
            "tenure_months": 58,
            "location": "New York, NY",
            "email": "[email protected]",
            "mobile_number": "+1 212-555-0156",
            "previous_companies": [
                {
                    "name": "SAP",
                    "title": "Regional Sales Director",
                    "duration_months": 48
                }
            ]
        }
    ],
    "company_info": {
        "name": "Salesforce",
        "domain": "salesforce.com",
        "total_employees_found": 1247
    },
    "pagination": {
        "total": 1247,
        "limit": 10,
        "offset": 0,
        "has_more": true
    },
    "statusCode": 200,
    "message": "Success"
}

Search Strategies

Department-Based Searches

Sales Prospecting:

department=Sales&seniority=Director - Decision makers
department=Sales&location=Remote - Remote sales team
title=VP Sales - C-level sales contacts

Recruitment:

department=Engineering&keywords=React - Frontend developers
department=Product&seniority=Manager - Product managers
department=Marketing&keywords=growth - Growth marketers

Seniority-Based Targeting

Executive Outreach:

seniority=C-Suite - C-level executives
seniority=VP&department=Sales - VP-level decision makers

Mid-Level Contacts:

seniority=Director&department=Engineering - Technical directors
seniority=Manager - Team managers across departments

Individual Contributors:

seniority=Senior&department=Engineering - Senior engineers
seniority=Staff&keywords=data science - Data scientists

Location-Based Searches

Geographic Targeting:

location=San Francisco - Bay Area employees
location=Remote - Distributed workforce
location=New York - East Coast presence

Multi-Location:

Combine with other filters for regional analysis
Identify location-specific team structures
Find local office leadership

Credit Usage

Base per result

Email per result

Phone per result

Large Company Searches: Companies with 10,000+ employees may return hundreds of results. Use specific filters to narrow results and manage costs effectively.

Pagination Best Practices

async function exportAllEmployees(companyDomain, filters = {}) {
  let allEmployees = [];
  let offset = 0;
  const limit = 50;
  
  while (true) {
    const params = new URLSearchParams({
      company_domain: companyDomain,
      limit: limit,
      offset: offset,
      ...filters
    });
    
    const response = await fetch(
      `https://api.tuesday.so/api/v1/company/employee-search?${params}`,
      { headers: { 'X-API-KEY': 'your-api-key-here' } }
    );
    
    const data = await response.json();
    
    if (!data.data || data.data.length === 0) break;
    
    allEmployees.push(...data.data);
    
    if (!data.pagination.has_more) break;
    
    offset += limit;
    
    // Rate limiting pause
    await new Promise(resolve => setTimeout(resolve, 3000));
  }
  
  return allEmployees;
}

// Export all engineering managers
const engineeringManagers = await exportAllEmployees('stripe.com', {
  department: 'Engineering',
  seniority: 'Manager'
});

Use Cases

Sales Prospecting

Find decision makers and contacts at target companies for outreach

Competitive Hiring

Identify talent at competitor companies for recruitment

Account Research

Research company structure and key contacts before meetings

Market Intelligence

Analyze competitor team structures and hiring patterns

Partnership Mapping

Find relevant contacts for business development and partnerships

Org Chart Building

Build organizational charts for target accounts

Error Responses

400 Bad Request - Missing Company Parameter

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Either company_domain or company_linkedin_url is required"
}

404 Not Found - Company Not Found

{
    "statusCode": 404,
    "message": "Not Found",
    "error": "Company not found or has insufficient employee data"
}

400 Bad Request - Invalid Filters

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Invalid limit value. Must be between 1 and 100"
}

Advanced Filtering

Multi-Filter Combinations

Effective Combinations:

# Senior engineering leadership
?department=Engineering&seniority=Director&keywords=architecture

# Remote sales managers
?department=Sales&seniority=Manager&location=Remote

# Product marketing specialists
?department=Marketing&keywords=product marketing&seniority=Staff

Keyword Strategies

Technical Keywords:

Programming languages: "Python", "React", "Go"
Technologies: "AWS", "Kubernetes", "GraphQL"
Methodologies: "Agile", "DevOps", "Machine Learning"

Business Keywords:

Functions: "enterprise sales", "product marketing", "customer success"
Skills: "analytics", "strategy", "operations"

Company Profile API - Get comprehensive company information
Company Employee Count - Get employee metrics and department breakdown
People Search API - Search across all companies with filters
People Lookup API - Find specific people by name and company

Authentication

People APIs

Company APIs

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Search Strategies

Credit Usage

Use Cases

Sales Prospecting

Competitive Hiring

Account Research

Market Intelligence

Partnership Mapping

Org Chart Building

Error Responses

Advanced Filtering

Authentication

People APIs

Company APIs

​Overview

​Authentication

​Query Parameters

​Response

​Example Requests

​Example Response

​Search Strategies

​Credit Usage

​Pagination Best Practices

​Use Cases

Sales Prospecting

Competitive Hiring

Account Research

Market Intelligence

Partnership Mapping

Org Chart Building

​Error Responses

​Advanced Filtering

​Related Endpoints

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Search Strategies

Credit Usage

Pagination Best Practices

Use Cases

Error Responses

Advanced Filtering

Related Endpoints