Skip to main content
POST
/
v1
/
people
/
role-finder
Role Finder
curl --request POST \
  --url https://api.leadmagic.io/v1/people/role-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_name": "leadmagic",
  "company_domain": "leadmagic.io",
  "job_title": "ceo"
}
'
{
  "name": "Alex Rivera",
  "profile_url": "alex-rivera",
  "first_name": "Alex",
  "last_name": "Rivera",
  "message": "Role found.",
  "credits_consumed": 2,
  "company_name": "Leadmagic",
  "company_website": "leadmagic.io"
}

​
Find by Role

Find a person at a company by their job title. Perfect for ABM campaigns targeting specific roles like “VP of Sales” or “Head of Marketing”.

​
Endpoint Details

MetricValue
Cost2 credits per person found
No ResultsFREE if no match found
Returns the first matching person. For multiple results, use People Search with title and company filters.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/role-finder' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_title": "VP of Sales",
    "company_domain": "leadmagic.io"
  }'

​
Request Parameters

​
job_title
string
required
The job title to search for. Matches partial titles (e.g., “Sales” matches “VP of Sales”).
​
company_domain
string
Company website domain (preferred). More accurate than company_name.
​
company_name
string
Company name. Use if domain is not available.
You must provide either company_domain or company_name (or both).

​
Response

​
first_name
string
First name of the person found
​
last_name
string
Last name of the person found
​
full_name
string
Full name of the person found
​
profile_url
string
Professional profile URL
​
company_name
string
Company name
​
company_website
string
Company website domain
​
credits_consumed
number
required
Credits used (2 if found, 0 if not)
​
message
string
required
Human-readable status message

​
Example Response

{
  "first_name": "Alex",
  "last_name": "Rivera",
  "full_name": "Alex Rivera",
  "profile_url": "linkedin.com/in/alex-rivera",
  "job_title": "VP of Sales",
  "company_name": "Example Robotics",
  "company_website": "leadmagic.io",
  "credits_consumed": 2,
  "message": "Role found."
}

​
Success Messages

MessageMeaningCost
Role FoundPerson with matching role found2 credits
No matching role found at this company.No matching role existsFREE

​
Best Practices

Domain lookups are more accurate. leadmagic.io resolves directly to LeadMagic, while a company name can match multiple entities.
Try variations: “VP Sales”, “VP of Sales”, “Head of Sales” may all work depending on how the person lists their title.
After finding a person, use Email Finder with their name and company to get their email.

​
Use Cases

ABM Campaigns

Target specific roles at key accounts for personalized outreach.

Competitive Intelligence

Find your counterpart at competitor companies.

Partner Outreach

Find the right person to discuss partnerships.

Recruiting

Identify potential candidates by role at 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_name
string
default:leadmagic

Business Profile URL (with url or public_identifier)

​
company_domain
string
default:leadmagic.io

Company domain

​
job_title
string
default:ceo

Enter the job title you want to find in the company.

Response

Successful response with role details

​
name
string
Example:

"Alex Rivera"

​
profile_url
string
Example:

"alex-rivera"

​
first_name
string
Example:

"Alex"

​
last_name
string
Example:

"Rivera"

​
message
string
Example:

"Role found."

​
credits_consumed
integer
Example:

2

​
company_name
string
Example:

"Leadmagic"

​
company_website
string
Example:

"leadmagic.io"