Documentation Index
Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Email to B2B Person Profile
Convert an email address into a B2B person profile. Find the professional identity behind any email.
Endpoint Details
| Metric | Value |
|---|
| Cost | 10 credits per profile found |
| No Results | FREE if no profile found |
Reverse lookup is more resource-intensive than forward lookup, hence the higher cost.
Per-Endpoint Limit
| Metric | Value |
|---|
| Requests/Minute | 300 |
| Burst Capacity | ~5 requests/second |
Rate limits are subject to change. Custom rate limits are available on enterprise plans — contact us.
Quick Example
curl -X POST 'https://api.leadmagic.io/v1/people/b2b-profile' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"work_email": "alex.rivera@example.com"}'
Request Parameters
Work email address to lookup. Preferred over personal_email.
Personal email address to lookup. Alternative identifier.
You must provide either work_email or personal_email (or both for better match rates).
Response
B2B person profile URL or slug (null if not found)
Credits used (10 if found, 0 if not)
Human-readable status message
Example Response
{
"profile_url": "linkedin.com/in/alex-rivera",
"credits_consumed": 10,
"message": "Profile URL found."
}
Success Messages
| Message | Meaning | Cost |
|---|
Profile URL found | B2B person profile successfully identified | 10 credits |
No profile found for this email. | No matching profile found | FREE |
Workflow
Submit Email
Send the work or personal email address.
B2B Person Profile Lookup
We search our database for matching B2B person profiles.
Get B2B Person Profile
Receive the B2B person profile.
Best Practices
Work emails have higher match rates than personal emails for professional profiles.
Chain with B2B Person Profile
After finding a profile URL, use B2B Person Profile to get complete profile data.
Handle no matches gracefully
Not all emails have associated professional profiles. Plan for partial enrichment.
Use Cases
CRM Enrichment
Add B2B person profile links to your CRM contacts.
Lead Research
Identify the professional identity behind inbound leads.
Visitor Identification
Match website visitors to professional profiles.
Data Completeness
Fill in missing profile URLs in your contact database.
Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).
work_email
string
default:alex.rivera@example.com
Provide the Work Email of the person
personal_email
string
default:alex-riveral@gmail.com
Provide the Personal Email of the person
Successful response with B2B profile details