POST

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"
}
'

import requests

url = "https://api.leadmagic.io/v1/people/mobile-finder"

payload = {
    "profile_url": "alex-rivera",
    "work_email": "alex.rivera@example.com",
    "personal_email": "alex-riveral@gmail.com"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    profile_url: 'alex-rivera',
    work_email: 'alex.rivera@example.com',
    personal_email: 'alex-riveral@gmail.com'
  })
};

fetch('https://api.leadmagic.io/v1/people/mobile-finder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v1/people/mobile-finder"

	payload := strings.NewReader("{\n  \"profile_url\": \"alex-rivera\",\n  \"work_email\": \"alex.rivera@example.com\",\n  \"personal_email\": \"alex-riveral@gmail.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v1/people/mobile-finder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'profile_url' => 'alex-rivera',
    'work_email' => 'alex.rivera@example.com',
    'personal_email' => 'alex-riveral@gmail.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "profile_url": "alex-rivera",
  "email": "alex.rivera@example.com",
  "mobile_number": "12077523358",
  "credits_consumed": 5,
  "message": "Mobile number found."
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

Find Mobile

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

Endpoint Details

Pricing
Rate Limits

Metric	Value
Cost	5 credits per mobile found
No Results	FREE if no mobile found

You only pay when we successfully find a mobile number. No-result lookups are always free.

Metric	Value
Requests/Minute	300
Burst Capacity	~5 requests/second

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"}'

const response = await fetch('https://api.leadmagic.io/v1/people/mobile-finder', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    profile_url: 'linkedin.com/in/alex-rivera',
    work_email: 'alex.rivera@example.com'  // Optional: improves match rate
  })
});
const data = await response.json();
if (data.mobile_number) {
  console.log(`Found: ${data.mobile_number}`);
}

import requests

response = requests.post(
    'https://api.leadmagic.io/v1/people/mobile-finder',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={
        'profile_url': 'linkedin.com/in/alex-rivera',
        'work_email': 'alex.rivera@example.com'
    }
)
data = response.json()
print(f"Mobile: {data.get('mobile_number', 'Not found')}")

Request Parameters

string

Professional profile URL or username. Most accurate identifier.

string

Professional email address. Improves match rate when combined with profile_url.

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

string

The profile URL used for lookup

string

The email used for lookup (if provided)

string

Mobile phone number found (null if not found)

number

required

Credits used (5 if found, 0 if not)

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

Message	Meaning	Cost
`Mobile number found.`	Phone number successfully retrieved	5 credits
`No mobile number found for this contact.`	No phone data available	FREE

Best Practices

Combine multiple identifiers

Provide both profile URL and email when available for the highest match rate.

Respect contact preferences

Mobile numbers are personal data. Use responsibly and respect opt-out requests.

Verify before large campaigns

Test a sample before running large batches to ensure quality for your use case.

Use for high-value outreach

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"

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."

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"
}
'

import requests

url = "https://api.leadmagic.io/v1/people/mobile-finder"

payload = {
    "profile_url": "alex-rivera",
    "work_email": "alex.rivera@example.com",
    "personal_email": "alex-riveral@gmail.com"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    profile_url: 'alex-rivera',
    work_email: 'alex.rivera@example.com',
    personal_email: 'alex-riveral@gmail.com'
  })
};

fetch('https://api.leadmagic.io/v1/people/mobile-finder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v1/people/mobile-finder"

	payload := strings.NewReader("{\n  \"profile_url\": \"alex-rivera\",\n  \"work_email\": \"alex.rivera@example.com\",\n  \"personal_email\": \"alex-riveral@gmail.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v1/people/mobile-finder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'profile_url' => 'alex-rivera',
    'work_email' => 'alex.rivera@example.com',
    'personal_email' => 'alex-riveral@gmail.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "profile_url": "alex-rivera",
  "email": "alex.rivera@example.com",
  "mobile_number": "12077523358",
  "credits_consumed": 5,
  "message": "Mobile number found."
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

Get Started

API Endpoints

MCP Server

CLI

Mobile Finder

Find Mobile

Endpoint Details

Per-Endpoint Limit

Quick Example

Request Parameters

Response

Example Response

Success Messages

Best Practices

Use Cases

Sales Outreach

Account-Based Marketing

Recruiter Outreach

Customer Success

Authorizations

Body

Response

​Find Mobile

​Endpoint Details

​Per-Endpoint Limit

​Quick Example

​Request Parameters

​Response

​Example Response

​Success Messages

​Best Practices

​Use Cases

Sales Outreach

Account-Based Marketing

Recruiter Outreach

Customer Success

Authorizations

Body

Response

Find Mobile

Endpoint Details

Per-Endpoint Limit

Quick Example

Request Parameters

Response

Example Response

Success Messages

Best Practices

Use Cases