Skip to main content
POST
/
v1
/
people
/
employee-finder
Employee Finder
curl --request POST \
  --url https://api.leadmagic.io/v1/people/employee-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_domain": "leadmagic.io",
  "company_name": "leadmagic",
  "limit": 20
}
'
{
  "message": "Data found for the given company.",
  "total_count": 402,
  "returned_count": 20,
  "credits_consumed": 1,
  "data": [
    {
      "first_name": "Suzanne",
      "last_name": "Quentin",
      "title": "Director, Talent Development",
      "website": "https://leadmagic.io",
      "company_name": "LeadMagic"
    },
    {
      "first_name": "Brea",
      "last_name": "Porter",
      "title": "Senior Product Manager",
      "website": "https://leadmagic.io",
      "company_name": "LeadMagic"
    },
    {
      "first_name": "Damian",
      "last_name": "Cowell",
      "title": "Sr Director of Product Management",
      "website": "https://leadmagic.io",
      "company_name": "LeadMagic"
    }
  ]
}

​
Find Employees

Find employees at a company. Returns a list of employees with their profiles, titles, and more.

​
Endpoint Details

MetricValue
Cost0.05 credits per employee returned
Calculation20 employees = 1 credit
No ResultsFREE if no employees found
One of our most cost-effective endpoints. Get 20 employees for just 1 credit.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/employee-finder' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_domain": "company.com",
    "limit": 10
  }'

​
Request Parameters

​
company_domain
string
Company website domain (preferred). More accurate than company_name.
​
company_name
string
Company name. Use if domain is not available.
​
limit
integer
default:"10"
Maximum number of employees to return.
You must provide either company_domain or company_name (or both).

​
Response

​
employees
array
Array of employee objects
​
total_count
integer
Total employees found (may be more than returned if limit is set)
​
credits_consumed
number
required
Credits used (0.05 per employee returned)
​
message
string
required
Human-readable status message

​
Employee Object

FieldTypeDescription
first_namestringFirst name
last_namestringLast name
full_namestringFull name
profile_urlstringProfessional profile URL
job_titlestringCurrent job title
locationstringGeographic location

​
Example Response

{
  "employees": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "profile_url": "linkedin.com/in/johndoe",
      "job_title": "VP of Sales",
      "location": "San Francisco, CA"
    },
    {
      "first_name": "Jane",
      "last_name": "Smith",
      "full_name": "Jane Smith",
      "profile_url": "linkedin.com/in/janesmith",
      "job_title": "Marketing Director",
      "location": "New York, NY"
    }
  ],
  "total_count": 150,
  "credits_consumed": 0.1,
  "message": "Employees found."
}

​
Success Messages

MessageMeaningCost
Employees found.Employee list returned0.05/employee
No employees found for this company.No employee data availableFREE

​
Best Practices

Start with limit: 10 to test the results before requesting larger batches.
Use the returned names with Email Finder to get contact information.
Get a larger batch and filter by job_title in your application for specific roles.

​
Use Cases

Account Mapping

Build org charts for target accounts.

ABM Campaigns

Find multiple stakeholders for multi-threaded outreach.

Competitive Intelligence

Analyze competitor team structures.

Recruiting Pipeline

Build candidate pipelines from target companies.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
company_domain
string
default:leadmagic.io

Provide the Company Domain Name (Optional)

​
company_name
string
default:leadmagic

Provide the Company Name (Optional)

​
limit
integer
default:20

Number of results needed. (Default is 20)

Response

Successful response with employee details

​
message
string
Example:

"Data found for the given company."

​
total_count
integer
Example:

402

​
returned_count
integer
Example:

20

​
credits_consumed
integer
Example:

1

​
data
object[]
Example:
[
  {
    "first_name": "Suzanne",
    "last_name": "Quentin",
    "title": "Director, Talent Development",
    "website": "https://leadmagic.io",
    "company_name": "LeadMagic"
  },
  {
    "first_name": "Brea",
    "last_name": "Porter",
    "title": "Senior Product Manager",
    "website": "https://leadmagic.io",
    "company_name": "LeadMagic"
  },
  {
    "first_name": "Damian",
    "last_name": "Cowell",
    "title": "Sr Director of Product Management",
    "website": "https://leadmagic.io",
    "company_name": "LeadMagic"
  }
]