Employee Search

Search for employees at a company with filters

POST /v1/people/search

Employee Search

cURL

curl --request POST \
  --url https://api.gtmapis.com/v1/people/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "domain": "<string>",
  "title_keywords": [
    {}
  ],
  "department": "<string>",
  "seniority": [
    {}
  ],
  "limit": 123,
  "offset": 123
}
'

200

{
  "people": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "source_provider": "<string>",
  "credits_charged": 123,
  "latency_ms": 123
}

Employee Search

Search for employees at a company with filters for title, department, seniority, and more. Returns multiple matching profiles.

Endpoint

POST /v1/people/search

Request

domain · string · required

Company domain to search (e.g., “acme.com”)

title_keywords · array

Keywords to match in job titles (e.g., [“sales”, “account executive”])

department · string

Department filter: Sales, Engineering, Marketing, Finance, HR, Operations, etc.

seniority · array

Seniority levels: C-Level, VP, Director, Manager, Senior, Individual

limit · integer · default: "10"

Maximum results to return (max 50)

offset · integer · default: "0"

Pagination offset

Example Request

cURL

curl -X POST https://api.gtmapis.com/v1/people/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "domain": "acme.com",
    "department": "Sales",
    "seniority": ["VP", "Director"],
    "limit": 10
  }'

Response

people · array

Array of matching profiles. See Profile Enrichment for field details.

total · integer

Total number of matching employees (may be more than returned)

limit · integer

Limit used for this request

offset · integer

Offset used for this request

source_provider · string

Data provider that returned results

credits_charged · integer

Total credits charged for all returned profiles

latency_ms · integer

Request time in milliseconds

Success Response

{
  "people": [
    {
      "first_name": "Jane",
      "last_name": "Smith",
      "full_name": "Jane Smith",
      "title": "VP of Sales",
      "department": "Sales",
      "seniority": "VP",
      "company": "Acme Inc",
      "company_domain": "acme.com",
      "linkedin_url": "https://linkedin.com/in/janesmith",
      "location": "San Francisco, CA",
      "email": "[e-mail]"
    },
    {
      "first_name": "Bob",
      "last_name": "Johnson",
      "full_name": "Bob Johnson",
      "title": "Sales Director",
      "department": "Sales",
      "seniority": "Director",
      "company": "Acme Inc",
      "company_domain": "acme.com",
      "linkedin_url": "https://linkedin.com/in/bobjohnson",
      "location": "New York, NY",
      "email": "[e-mail]"
    }
  ],
  "total": 15,
  "limit": 10,
  "offset": 0,
  "source_provider": "peopledatalabs",
  "credits_charged": 4,
  "latency_ms": 892
}

No Results Response

{
  "people": [],
  "total": 0,
  "limit": 10,
  "offset": 0,
  "credits_charged": 0,
  "latency_ms": 234
}

Credit Pricing

Result	Credits Charged
Per profile returned	2 credits
No results	0 credits
Error / failure	0 credits

Credits are charged per profile returned. Searching a company with 10 results costs 20 credits.

Departments

Standard department values:

Department	Description
Sales	Sales, Business Development
Engineering	Software, Hardware, QA
Marketing	Marketing, Growth, Brand
Finance	Finance, Accounting
HR	Human Resources, People Ops
Operations	Operations, Support
Product	Product Management
Legal	Legal, Compliance
Executive	C-Suite, Leadership

Seniority Levels

Level	Typical Titles
C-Level	CEO, CTO, CFO, COO, CMO
VP	VP of Sales, Vice President
Director	Sales Director, Engineering Director
Manager	Sales Manager, Product Manager
Senior	Senior Engineer, Senior AE
Individual	Software Engineer, SDR

Error Responses

400 Bad Request

{
  "error": "Bad Request",
  "message": "domain is required"
}

401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

503 Service Unavailable

{
  "error": "Service Unavailable",
  "message": "employee search not configured"
}

Use Cases

Account-based marketing

Build comprehensive contact lists for target accounts.

Multi-threading

Find all stakeholders (Sales, Finance, IT) for enterprise deals.

Competitive intelligence

Monitor hiring patterns and team composition at competitors.

Event targeting

Find attendees from specific companies for conference outreach.

Persona targeting

Build lists of specific personas (VP Sales at SaaS companies).

Best Practices

Start with seniority filters

Filter by seniority first to find decision-makers, then narrow by department.

Use pagination for large results

For companies with many employees, paginate through results with offset.

Combine with email finder

Use results with Find Email to get contact emails.

Related Endpoints

Role Finder

Find specific roles at companies

Company Enrichment

Get company firmographic data

Find Email

Find emails for contacts

LinkedIn Employees

Get employee count from LinkedIn