Skip to main content
POST
/
v1
/
people
/
profile-search
B2B Person Profile
curl --request POST \
  --url https://api.leadmagic.io/v1/people/profile-search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "alex-rivera"
}
'
{
  "profile_url": "alex-rivera",
  "credits_consumed": 1,
  "first_name": "Alex",
  "last_name": "Rivera",
  "full_name": "Alex Rivera",
  "professional_title": "Growth & AI Expert | Founder LeadMagic",
  "bio": "SaaS Founder",
  "company_name": "LeadMagic",
  "company_industry": "Internet",
  "company_website": "leadmagic.io",
  "total_tenure_months": "205",
  "total_tenure_days": "6240",
  "total_tenure_years": "17",
  "followers_range": "45K-50K",
  "personal_website": {
    "name": "https://leadmagic.io",
    "link": "https://leadmagic.io"
  },
  "country": "United States",
  "location": "Greater Boston",
  "work_experience": [
    {
      "position_title": "Founder",
      "company_name": "LeadMagic",
      "employment_period": "Sep 2022 - Present · 3 yrs 2 mos",
      "company_website": "leadmagic.io",
      "company_logo_url": "https://logo.leadmagic.io/leadmagic.io"
    }
  ],
  "education": [
    {
      "institution_name": "University of Maine",
      "degree": "University of Maine",
      "attendance_period": ""
    }
  ],
  "certifications": [
    {
      "certification_name": "Revenue Architect",
      "issuing_organization": "Winning by Design",
      "issue_date": "Issued Nov 2020"
    }
  ],
  "honors": [
    {
      "title": "Hortonworks - MVP NorthEast - Region - 2016",
      "description": "Issued by Hortonworks · Jan 2016"
    }
  ]
}

​
B2B Person Profile

Retrieve comprehensive B2B person profile data including work experience, education, certifications, and professional metrics.

​
Endpoint Details

MetricValue
Cost1 credit per profile
No ResultsFREE if profile not found
B2B person profile data includes work history, education, certifications, and company enrichment - all for 1 credit.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/profile-search' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"profile_url": "linkedin.com/in/alex-rivera"}'

​
Request Parameters

​
profile_url
string
required
B2B person profile URL or slug. Accepts full profile URLs or just the profile slug.

​
Response

​
profile_url
string
required
B2B person profile URL or slug
​
first_name
string
First name
​
last_name
string
Last name
​
full_name
string
Full name
​
professional_title
string
Current job title/headline
​
bio
string
Profile summary
​
location
string
Geographic location
​
country
string
Country
​
followers_range
string
Social follower range (e.g., “45K-50K”)

​
Example Response

{
  "profile_url": "linkedin.com/in/alex-rivera",
  "first_name": "Alex",
  "last_name": "Rivera",
  "full_name": "Alex Rivera",
  "professional_title": "VP of Sales at LeadMagic",
  "company_name": "LeadMagic",
  "company_industry": "Technology",
  "location": "San Francisco, CA",
  "country": "United States",
  "followers_range": "10K-15K",
  "total_tenure_years": "12",
  "bio": "Sales leader with 12+ years experience...",
  "work_experience": [
    {
      "position_title": "VP of Sales",
      "company_name": "LeadMagic",
      "employment_period": "Jan 2022 - Present"
    }
  ],
  "education": [
    {
      "institution_name": "Stanford University",
      "degree": "MBA",
      "attendance_period": "2010 - 2012"
    }
  ],
  "credits_consumed": 1,
  "message": "Profile found."
}

​
Success Messages

MessageMeaningCost
Profile found.Full B2B person profile data returned1 credit
Profile not found or not accessible.Profile doesn’t exist or is privateFREE

​
Best Practices

Some profiles are private and will return limited data. Check for null fields and handle gracefully.
Use B2B Person Profile to verify a person, then Email Finder or Mobile Finder for contact info.

​
Use Cases

Sales Research

Research prospects before outreach. Identify decision-makers and personalize your pitch.

Recruiting

Enrich candidate profiles. Verify work history and identify qualified candidates.

Marketing Personas

Build detailed buyer personas. Segment audiences by role and seniority.

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
​
profile_url
string
required

B2B person profile URL or slug

Example:

"alex-rivera"

Response

Successful response with profile information

​
profile_url
string
Example:

"alex-rivera"

​
credits_consumed
integer
Example:

1

​
first_name
string | null
Example:

"Alex"

​
last_name
string | null
Example:

"Rivera"

​
full_name
string | null
Example:

"Alex Rivera"

​
professional_title
string | null
Example:

"Growth & AI Expert | Founder LeadMagic"

​
bio
string | null
Example:

"SaaS Founder"

​
company_name
string | null
Example:

"LeadMagic"

​
company_industry
string | null
Example:

"Internet"

​
company_website
string | null
Example:

"leadmagic.io"

​
total_tenure_months
string | null
Example:

"205"

​
total_tenure_days
string | null
Example:

"6240"

​
total_tenure_years
string | null
Example:

"17"

​
followers_range
string | null

Follower count range for privacy (e.g. "45K-50K", "1M+")

Example:

"45K-50K"

​
personal_website
object
​
country
string | null
Example:

"United States"

​
location
string | null
Example:

"Greater Boston"

​
work_experience
object[] | null
​
education
object[] | null
​
certifications
object[] | null
​
honors
object[] | null