Skip to main content
POST
/
v1
/
prospect
/
employees
Prospect Employee Search
curl --request POST \
  --url https://api.gtmapis.com/v1/prospect/employees \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_linkedin_url": "<string>",
  "job_level": "<string>",
  "job_function": "<string>",
  "sales_region": "<string>",
  "max_results": 123,
  "page": 123
}
'
{
  "employees": [
    {}
  ],
  "total_count": 123,
  "page": 123,
  "total_results": 123,
  "credits_charged": 123
}

Documentation Index

Fetch the complete documentation index at: https://gtmapis.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Prospect Employee Search

Search for employees at a company using LinkedIn data. Filter by job level, function, and sales region. Supports pagination for large result sets.

​
Endpoint

POST /v1/prospect/employees

​
Request

​
company_linkedin_url
string
required
LinkedIn company page URL (e.g., “https://linkedin.com/company/acme”)
​
job_level
string
Filter by job level (e.g., “VP”, “Director”, “Manager”, “Senior”)
​
job_function
string
Filter by job function (e.g., “Sales”, “Engineering”, “Marketing”)
​
sales_region
string
Filter by sales region (e.g., “North America”, “EMEA”, “APAC”)
​
max_results
integer
Maximum number of results to return per page
​
page
integer
Page number for pagination (starts at 1)

​
Example Request

curl -X POST https://api.gtmapis.com/v1/prospect/employees \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "company_linkedin_url": "https://linkedin.com/company/acme",
    "job_level": "Director",
    "job_function": "Sales",
    "max_results": 10
  }'

​
Response

​
employees
array
Array of matching employee records. See ICP Search for person field details.
​
total_count
integer
Total number of matching employees (may be more than returned)
​
page
integer
Current page number
​
total_results
integer
Number of results returned in this page
​
credits_charged
integer
Total credits charged

​
Success Response

{
  "employees": [
    {
      "linkedin_url": "https://linkedin.com/in/janesmith",
      "first_name": "Jane",
      "last_name": "Smith",
      "full_name": "Jane Smith",
      "title": "Sales Director",
      "headline": "Building enterprise sales teams",
      "location": "New York, NY",
      "company_name": "Acme Inc",
      "email": "jane.smith@acme.com"
    }
  ],
  "total_count": 24,
  "page": 1,
  "total_results": 1,
  "credits_charged": 1
}

​
Credit Pricing

ResultCredits Charged
Per employee returned1 credit
No results0 credits
Error / failure0 credits

​
Error Responses

​
400 Bad Request

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

​
401 Unauthorized

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

​
Use Cases

Build org charts for target accounts by searching across job levels and functions.
Find all stakeholders in a buying committee by searching Sales, IT, and Finance functions.
Filter by sales region to build territory-specific contact lists.

ICP Search

Search with cascade title filters

Company Search

Find companies matching criteria

Email from LinkedIn

Get email from LinkedIn profile

Phone from LinkedIn

Get phone from LinkedIn profile

Prospect Account

Check account status and credits