Company Employee Search

GET

api

company

employee-search

curl --request GET \
  --url https://api.tuesday.so/api/v1/company/employee-search \
  --header 'X-API-KEY: <x-api-key>'

{
    "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": "sarah.chen@salesforce.com",
            "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": "mrodriguez@salesforce.com",
            "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"
}

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 within

Example: salesforce.com

Note: Either company_domain or company_linkedin_url is required

company_linkedin_url

string

LinkedIn company page URL

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

Note: 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 filter

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

seniority

string

Seniority level filter

Options: "C-Suite", "VP", "Director", "Manager", "Senior", "Staff", "Intern"

location

string

Office location or geographic filter

Examples: "San Francisco", "New York", "Remote", "California"

keywords

string

Keywords to search in employee profiles

Examples: "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 results

Options: include | exclude

Additional Cost: +2 credits per result when set to include

include_phone

string

default:"exclude"

Include phone numbers in results

Options: include | exclude

Additional 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": "sarah.chen@salesforce.com",
            "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": "mrodriguez@salesforce.com",
            "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

Seniority-Based Targeting

Location-Based Searches

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

404 Not Found - Company Not Found

400 Bad Request - Invalid Filters

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

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

Company Employee Count Company Search

Company Employee Search

curl --request GET \
  --url https://api.tuesday.so/api/v1/company/employee-search \
  --header 'X-API-KEY: <x-api-key>'

{
    "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": "sarah.chen@salesforce.com",
            "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": "mrodriguez@salesforce.com",
            "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"
}

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