Skip to main content
POST
/
v1
/
people
/
mobile-finder
Mobile Finder
curl --request POST \
  --url https://api.leadmagic.io/v1/people/mobile-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "alex-rivera",
  "work_email": "alex.rivera@example.com",
  "personal_email": "alex-riveral@gmail.com"
}
'
{
  "profile_url": "alex-rivera",
  "email": "alex.rivera@example.com",
  "mobile_number": "12077523358",
  "credits_consumed": 5,
  "message": "Mobile number found."
}

​
Find Mobile

Find mobile phone numbers for direct outreach campaigns. Perfect for sales teams who need direct contact with decision-makers.

​
Endpoint Details

MetricValue
Cost5 credits per mobile found
No ResultsFREE if no mobile found
You only pay when we successfully find a mobile number. No-result lookups are always free.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/mobile-finder' \
  -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
Professional profile URL or username. Most accurate identifier.
​
work_email
string
Professional email address. Improves match rate when combined with profile_url.
​
personal_email
string
Personal email address. Alternative identifier.
You must provide at least one identifier: profile_url, work_email, or personal_email.
Profile URL provides the highest match rate. Combine with email for best results.

​
Response

​
profile_url
string
The profile URL used for lookup
​
email
string
The email used for lookup (if provided)
​
mobile_number
string
Mobile phone number found (null if not found)
​
credits_consumed
number
required
Credits used (5 if found, 0 if not)
​
message
string
required
Human-readable status message

​
Example Response

{
  "profile_url": "linkedin.com/in/alex-rivera",
  "mobile_number": "+1-555-123-4567",
  "credits_consumed": 5,
  "message": "Mobile number found."
}

​
Success Messages

MessageMeaningCost
Mobile number found.Phone number successfully retrieved5 credits
No mobile number found for this contact.No phone data availableFREE

​
Best Practices

Provide both profile URL and email when available for the highest match rate.
Mobile numbers are personal data. Use responsibly and respect opt-out requests.
Test a sample before running large batches to ensure quality for your use case.
Mobile outreach has higher response rates but use sparingly for important contacts.

​
Use Cases

Sales Outreach

Reach decision-makers directly with SMS or calls.

Account-Based Marketing

Build complete contact profiles for target accounts.

Recruiter Outreach

Contact candidates directly for high-priority roles.

Customer Success

Reach customers quickly for urgent support issues.

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
default:alex-rivera

Provide their Social Media URL

​
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

Response

Successful response with mobile details

​
profile_url
string | null
Example:

"alex-rivera"

​
email
string | null

Email address used in lookup (if provided)

Example:

"alex.rivera@example.com"

​
mobile_number
string | null

Mobile phone number if found

Example:

"12077523358"

​
credits_consumed
number
Example:

5

​
message
string

Status message about the result

Example:

"Mobile number found."