Skip to main content
POST
/
v1
/
people
/
profile-search
Profile Search
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": "jesseoue"
}
'
{
  "profile_url": "jesseoue/",
  "credits_consumed": 1,
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "full_name": "Jesse Ouellette",
  "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"
    }
  ]
}

​
Enrich Profile

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

​
Endpoint Details

MetricValue
Cost1 credit per profile
No ResultsFREE if profile not found
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/johndoe"}'

​
Request Parameters

​
profile_url
string
required
Professional profile URL or username. Accepts full URLs or just the username.
​
extended_response
boolean
default:"false"
Include profile image URL in the response.

​
Response

​
profile_url
string
required
Professional profile URL
​
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/johndoe",
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "professional_title": "VP of Sales at TechCorp",
  "company_name": "TechCorp Inc",
  "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": "TechCorp Inc",
      "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 profile data returned1 credit
Profile not found or not accessible.Profile doesn’t exist or is privateFREE

​
Best Practices

Set extended_response: true to include profile photo URLs for your CRM or outreach tools.
Some profiles are private and will return limited data. Check for null fields and handle gracefully.
Use Profile Search 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

Professional profile URL or username

Example:

"jesseoue"

​
extended_response
boolean
default:false

When true, includes profile image in the response

​
skip_cache
boolean
default:false

When true, bypasses cache to fetch fresh data

Response

Successful response with profile information

​
profile_url
string
Example:

"jesseoue/"

​
credits_consumed
integer
Example:

1

​
first_name
string | null
Example:

"Jesse"

​
last_name
string | null
Example:

"Ouellette"

​
full_name
string | null
Example:

"Jesse Ouellette"

​
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