> ## 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.
# B2B Person Profile
> Retrieve comprehensive B2B person profile information including work history, education, certifications, and more.
# B2B Person Profile
Retrieve comprehensive B2B person profile data including work experience, education, certifications, and professional metrics.
## Endpoint Details
| Metric | Value |
| -------------- | ----------------------------- |
| **Cost** | **1 credit** per profile |
| **No Results** | **FREE** if profile not found |
B2B person profile data includes work history, education, certifications, and company enrichment - all for 1 credit.
### Per-Endpoint Limit
| Metric | Value |
| ------------------- | ------------------- |
| **Requests/Minute** | 100 |
| **Burst Capacity** | \~2 requests/second |
Rate limits are subject to change. Custom rate limits are available on enterprise plans — [contact us](mailto:support@leadmagic.io).
***
## Quick Example
```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
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"}'
```
```javascript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await fetch('https://api.leadmagic.io/v1/people/profile-search', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
profile_url: 'linkedin.com/in/alex-rivera'
})
});
const profile = await response.json();
console.log(`${profile.full_name} - ${profile.professional_title}`);
```
```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests
response = requests.post(
'https://api.leadmagic.io/v1/people/profile-search',
headers={'X-API-Key': 'YOUR_API_KEY'},
json={
'profile_url': 'linkedin.com/in/alex-rivera'
}
)
profile = response.json()
print(f"{profile['full_name']} - {profile['professional_title']}")
```
***
## Request Parameters
B2B person profile URL or slug. Accepts full profile URLs or just the profile slug.
***
## Response
B2B person profile URL or slug
First name
Last name
Full name
Current job title/headline
Profile summary
Geographic location
Country
Social follower range (e.g., "45K-50K")
Current company name
Current company industry
Current company website
Total career tenure in years
Total career tenure in months
Array of work history entries with position\_title, company\_name, employment\_period, company\_website, company\_logo\_url
Array of education entries with institution\_name, degree, attendance\_period
Array of certifications with certification\_name, issuing\_organization, issue\_date
### Example Response
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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
| Message | Meaning | Cost |
| -------------------------------------- | ------------------------------------- | -------- |
| `Profile found.` | Full B2B person profile data returned | 1 credit |
| `Profile not found or not accessible.` | Profile doesn't exist or is private | FREE |
***
## 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
Research prospects before outreach. Identify decision-makers and personalize your pitch.
Enrich candidate profiles. Verify work history and identify qualified candidates.
Build detailed buyer personas. Segment audiences by role and seniority.
## OpenAPI
````yaml post /v1/people/profile-search
openapi: 3.1.0
info:
title: LeadMagic API
version: 1.4.34
description: >
# LeadMagic API Documentation
The LeadMagic API provides comprehensive B2B data enrichment services
including email validation, email finding, profile search, company
intelligence, and more.
## Quick Start
1. Get your API key from the [LeadMagic Dashboard](https://app.leadmagic.io)
2. Add the `X-API-Key` header to all requests
3. Start enriching your data!
## Base URL
All API requests should be made to: `https://api.leadmagic.io`
## Rate Limits
Each endpoint has specific rate limits (requests per minute). Exceeding
limits returns a `429 Too Many Requests` response.
## Credits
API calls consume credits based on the endpoint used. Check your balance
with the `/v1/credits` endpoint.
## Support
Contact us at support@leadmagic.io for assistance.
contact:
name: LeadMagic Support
email: support@leadmagic.io
url: https://leadmagic.io
termsOfService: https://leadmagic.io/legal/terms
servers:
- url: https://api.leadmagic.io
description: Production API Server
security:
- ApiKeyAuth: []
tags:
- name: Credits
description: Manage and check your credit balance
- name: Analytics
description: >-
Monitor your API usage with comprehensive analytics endpoints (FREE - no
credits consumed)
- name: People Enrichment
description: Find and validate contact information for individuals
- name: Company Data
description: Discover company information and intelligence
- name: Jobs Data
description: Search job listings and detect career changes
- name: Ads Data
description: Search advertising data across platforms
paths:
/v1/people/profile-search:
post:
tags:
- People Enrichment
summary: B2B Person Profile
description: >-
Retrieve comprehensive B2B person profile information including work
history, education, certifications, and more.
operationId: profile-search
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
profile_url:
type: string
description: B2B person profile URL or slug
example: alex-rivera
required:
- profile_url
responses:
'200':
description: Successful response with profile information
content:
application/json:
schema:
type: object
properties:
profile_url:
type: string
example: alex-rivera
credits_consumed:
type: integer
example: 1
first_name:
type: string
nullable: true
example: Alex
last_name:
type: string
nullable: true
example: Rivera
full_name:
type: string
nullable: true
example: Alex Rivera
professional_title:
type: string
nullable: true
example: Growth & AI Expert | Founder LeadMagic
bio:
type: string
nullable: true
example: SaaS Founder
company_name:
type: string
nullable: true
example: LeadMagic
company_industry:
type: string
nullable: true
example: Internet
company_website:
type: string
nullable: true
example: leadmagic.io
total_tenure_months:
type: string
nullable: true
example: '205'
total_tenure_days:
type: string
nullable: true
example: '6240'
total_tenure_years:
type: string
nullable: true
example: '17'
followers_range:
type: string
nullable: true
example: 45K-50K
description: Follower count range for privacy (e.g. "45K-50K", "1M+")
personal_website:
type: object
nullable: true
properties:
name:
type: string
example: https://leadmagic.io
link:
type: string
example: https://leadmagic.io
country:
type: string
nullable: true
example: United States
location:
type: string
nullable: true
example: Greater Boston
work_experience:
type: array
nullable: true
items:
type: object
properties:
position_title:
type: string
example: Founder
company_name:
type: string
example: LeadMagic
employment_period:
type: string
example: Sep 2022 - Present · 3 yrs 2 mos
company_website:
type: string
nullable: true
example: leadmagic.io
description: Only included when domain is available
company_logo_url:
type: string
nullable: true
example: https://logo.leadmagic.io/leadmagic.io
description: Only included when domain is available
education:
type: array
nullable: true
items:
type: object
properties:
institution_name:
type: string
example: University of Maine
degree:
type: string
example: University of Maine
attendance_period:
type: string
example: ''
certifications:
type: array
nullable: true
items:
type: object
properties:
certification_name:
type: string
example: Revenue Architect
issuing_organization:
type: string
example: Winning by Design
issue_date:
type: string
example: Issued Nov 2020
honors:
type: array
nullable: true
items:
type: object
properties:
title:
type: string
example: Hortonworks - MVP NorthEast - Region - 2016
description:
type: string
example: Issued by Hortonworks · Jan 2016
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimitExceeded'
'500':
$ref: '#/components/responses/InternalServerError'
components:
responses:
BadRequest:
description: |
Bad Request - The request was malformed or contains invalid parameters.
**Common causes:**
- Missing required fields
- Invalid field format (e.g., malformed email)
- Invalid JSON syntax
- Invalid parameter values
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ValidationError'
Unauthorized:
description: |
Unauthorized - Authentication failed.
**Common causes:**
- Missing X-API-Key header
- Invalid or expired API key
- Malformed API key
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/MissingAuthenticationError'
- $ref: '#/components/schemas/InvalidApiKeyError'
PaymentRequired:
description: >
Payment Required - Insufficient credits for this request.
**Action required:** Add credits to your account at
https://app.leadmagic.io/billing
content:
application/problem+json:
schema:
$ref: '#/components/schemas/InsufficientCreditsError'
NotFound:
description: |
Not Found - The requested resource could not be found.
**Common causes:**
- Profile doesn't exist or is not accessible
- Company not found in our database
- Invalid URL or identifier
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/ResourceNotFoundError'
- $ref: '#/components/schemas/ProfileNotFoundError'
RateLimitExceeded:
description: |
Too Many Requests - Rate limit exceeded.
**Action required:** Check the `Retry-After` header for when to retry.
**Headers returned:**
- `Retry-After`: Seconds until you can retry
- `RateLimit-Limit`: Your limit per minute
- `RateLimit-Remaining`: Remaining requests this minute
- `RateLimit-Reset`: Seconds until limit resets
headers:
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying
RateLimit-Limit:
schema:
type: integer
description: Maximum requests per minute
RateLimit-Remaining:
schema:
type: integer
description: Remaining requests this minute
RateLimit-Reset:
schema:
type: integer
description: Seconds until limit resets
content:
application/problem+json:
schema:
$ref: '#/components/schemas/RateLimitExceededError'
InternalServerError:
description: >
Internal Server Error - Something went wrong on our end.
**Action required:** Wait 30 seconds and retry. If the problem persists,
contact support@leadmagic.io
content:
application/problem+json:
schema:
$ref: '#/components/schemas/InternalServerError'
schemas:
ValidationError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/validation_error
title: Request validation failed. Check your input parameters.
status: 400
code: validation_error
param:
- email
detail: 'Email format is invalid. Expected format: user@domain.com'
action: Provide a valid email address in the 'email' field.
docs: https://leadmagic.io/docs/api-reference/errors
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
MissingAuthenticationError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/missing_authentication
title: >-
Authentication required. Provide a valid API key in the X-API-Key
header (case-insensitive).
status: 401
code: missing_authentication
docs: https://leadmagic.io/docs/api-reference/authentication
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
InvalidApiKeyError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/invalid_api_key
title: Invalid API key. The key does not exist or is incorrect.
status: 401
code: invalid_api_key
docs: https://leadmagic.io/docs/api-reference/authentication
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
InsufficientCreditsError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/insufficient_credits
title: 'Insufficient credits: need 5, have 2.50. Add credits to continue.'
status: 402
code: insufficient_credits
detail: >-
This request requires 5 credit(s) but your account only has 2.50
credits remaining.
action: >-
Add credits to your account at https://app.leadmagic.io/billing or
contact support@leadmagic.io for enterprise plans.
docs: https://leadmagic.io/docs/api-reference/credits
context:
credits_required: 5
credits_available: 2.5
credits_needed: 2.5
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
ResourceNotFoundError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/resource_not_found
title: Resource not found.
status: 404
code: resource_not_found
docs: https://leadmagic.io/docs/api-reference/errors
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
ProfileNotFoundError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/profile_not_found
title: Profile not found or not accessible
status: 404
code: profile_not_found
docs: https://leadmagic.io/docs/api-reference/errors
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
RateLimitExceededError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/rate_limit_exceeded
title: >-
Rate limit exceeded: 300 requests per 1 minute. Wait and try
again.
status: 429
code: rate_limit_exceeded
detail: >-
You have exceeded the maximum allowed request rate. Please wait
before making additional requests.
action: >-
Wait 42 seconds before retrying. Consider implementing exponential
backoff.
docs: https://leadmagic.io/docs/api-reference/rate-limits
context:
limit: 300
window: 1 minute
remaining: 0
reset_at: 1706745642
retry_after_seconds: 42
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
InternalServerError:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
example:
success: false
errors:
- type: https://api.leadmagic.io/errors/INTERNAL_ERROR
title: >-
Something went wrong on our end. Our team has been notified and is
investigating.
status: 500
code: INTERNAL_ERROR
detail: >-
This is a temporary server error. The issue has been automatically
reported to our team.
action: >-
Wait 30 seconds and retry your request. If the problem persists,
contact support@leadmagic.io
docs: https://leadmagic.io/docs/api-reference/errors
meta:
request_id: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp: '2024-02-01T12:00:00.000Z'
ErrorResponse:
type: object
description: RFC 9457 Problem Details error response
required:
- success
- errors
properties:
success:
type: boolean
example: false
description: Always false for error responses
errors:
type: array
description: Array of error details (typically one, but can be multiple)
items:
$ref: '#/components/schemas/ErrorDetail'
meta:
$ref: '#/components/schemas/ResponseMeta'
ErrorDetail:
type: object
description: RFC 9457 compliant error detail
required:
- type
- title
- status
properties:
type:
type: string
format: uri
description: RFC 9457 - URI reference identifying the error type
example: https://api.leadmagic.io/errors/validation_error
title:
type: string
description: RFC 9457 - Short human-readable summary
example: Request validation failed. Check your input parameters.
status:
type: integer
description: RFC 9457 - HTTP status code
example: 400
detail:
type: string
description: RFC 9457 - Human-readable explanation specific to this occurrence
example: The email field is required but was not provided.
instance:
type: string
format: uri
description: RFC 9457 - URI reference for this specific occurrence
example: /v1/people/email-validation#req_abc123
code:
type: string
description: Machine-readable error code for programmatic handling
example: validation_error
param:
type: array
description: Parameters that caused the error
items:
type: string
example:
- email
action:
type: string
description: Suggested action to resolve the error
example: Provide a valid email address in the 'email' field.
docs:
type: string
format: uri
description: Link to relevant documentation
example: https://leadmagic.io/docs/api-reference/errors
context:
type: object
description: Additional context specific to this error type
additionalProperties: true
ResponseMeta:
type: object
description: Metadata included in all responses
properties:
request_id:
type: string
format: uuid
description: Unique identifier for this request (use for debugging/support)
example: ea6e3248-f4d2-437d-bca3-20881b529129
timestamp:
type: string
format: date-time
description: ISO 8601 timestamp when the response was generated
example: '2024-02-01T12:00:00.000Z'
environment:
type: string
description: API environment (production, staging)
example: production
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: >-
Your LeadMagic API key. Header name is case-insensitive (X-API-Key,
X-API-KEY, x-api-key all work).
````