POST

people

job-change-detector

Job Change Detector

curl --request POST \
  --url https://api.leadmagic.io/v1/people/job-change-detector \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "alex-rivera"
}
'

import requests

url = "https://api.leadmagic.io/v1/people/job-change-detector"

payload = { "profile_url": "alex-rivera" }
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'})
};

fetch('https://api.leadmagic.io/v1/people/job-change-detector', 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/job-change-detector"

	payload := strings.NewReader("{\n  \"profile_url\": \"alex-rivera\"\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/job-change-detector",
  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'
  ]),
  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;
}

{
  "job_change_detected": false,
  "status": "NEVER_WORKED_THERE",
  "summary": "Alex Rivera has never worked at Example Robotics according to their comprehensive employment history. They are currently working at Leadmagic as Founder for 3 years. Their complete employment history shows experience at Leadmagic, Atlas Guild, Northstar Labs, and 7 other companies. The expected company does not appear in any current or past positions, confirming they have never been employed there.",
  "employee_name": "Alex Rivera",
  "expected_company": "Example Robotics",
  "current_company": "Leadmagic",
  "current_position": {
    "title": "Founder",
    "company": "Leadmagic",
    "start_date": "Sep 2022",
    "days_at_job": 1111,
    "tenure_formatted": "3 years",
    "is_current_position": true
  },
  "tenure_stats": {
    "average_tenure_months": 26,
    "average_tenure_formatted": "2 years 2 months",
    "total_positions": 10,
    "longest_tenure_months": 73,
    "longest_tenure_formatted": "6 years 1 month",
    "shortest_tenure_months": 1,
    "shortest_tenure_formatted": "1 month"
  },
  "work_history": [
    {
      "title": "Founder",
      "company": "Leadmagic",
      "duration": "Sep 2022 - Present",
      "is_present": true
    },
    {
      "title": "Executive Member",
      "company": "Atlas Guild",
      "duration": "Aug 2019 - Present",
      "is_present": true
    },
    {
      "title": "Advisor",
      "company": "Northstar Labs",
      "duration": "Feb 2023 - Jan 2024",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Sales Community",
      "duration": "May 2020 - Dec 2023",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Astronomer",
      "duration": "Jul 2020 - Sep 2023",
      "is_present": false
    }
  ],
  "profile_found": true,
  "profile_url": "alex-rivera",
  "credits_consumed": 2
}

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

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

Detect Job Changes

Detect job changes for a professional by monitoring their profile against a specific company. Know instantly when your contacts move companies.

Endpoint Details

Pricing
Rate Limits

Metric	Value
Cost	3 credits per check

Job changes are a prime trigger event. People who just started a new role have budget and authority to make purchasing decisions.

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

Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/job-change-detector' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "profile_url": "linkedin.com/in/alex-rivera",
    "company_domain": "leadmagic.io"
  }'

const response = await fetch('https://api.leadmagic.io/v1/people/job-change-detector', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    profile_url: 'linkedin.com/in/alex-rivera',
    company_domain: 'leadmagic.io'
  })
});
const data = await response.json();
if (data.job_changed) {
  console.log(`Job change detected! Now at: ${data.current_company}`);
}

import requests

response = requests.post(
    'https://api.leadmagic.io/v1/people/job-change-detector',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={
        'profile_url': 'linkedin.com/in/alex-rivera',
        'company_domain': 'leadmagic.io'
    }
)
data = response.json()
if data.get('job_changed'):
    print(f"Job change detected! Now at: {data['current_company']}")

Request Parameters

string

required

Professional profile URL or username to monitor

string

Expected company domain to check against (preferred)

string

Expected company name to check against

You must provide either company_domain or company_name to compare against.

Response

boolean

required

Whether the person has changed jobs

boolean

Whether still employed at the expected company

string

Current company name (if changed)

string

Current job title

string

The company you were checking against

number

required

Credits used (always 3)

string

required

Human-readable status message

Example Response - No Change

{
  "job_changed": false,
  "still_employed": true,
  "current_company": "Old Example Robotics",
  "current_title": "VP of Sales",
  "expected_company": "Old Example Robotics",
  "credits_consumed": 3,
  "message": "No job change detected. Still employed at expected company."
}

Example Response - Job Changed

{
  "job_changed": true,
  "still_employed": false,
  "current_company": "New Example Robotics",
  "current_title": "Chief Revenue Officer",
  "expected_company": "Old Example Robotics",
  "credits_consumed": 3,
  "message": "Job change detected. Person has moved to a new company."
}

Success Messages

Message	Meaning
`No job change detected. Still employed at expected company.`	Person still at company
`Job change detected. Person has moved to a new company.`	Person changed jobs
`Never worked at the expected company.`	No employment record found

Best Practices

Monitor key contacts regularly

Run weekly checks on your top accounts to catch job changes early.

Act fast on changes

Job changers in their first 90 days are 3x more likely to buy. Reach out quickly.

Follow the champion

When your champion moves, reach out at their new company - they already know your value.

Batch your checks

Check multiple contacts in parallel to efficiently monitor your database.

Use Cases

Champion Tracking

Follow your product champions when they move to new companies.

Churn Prevention

Know when key contacts leave accounts before renewal conversations.

Trigger Campaigns

Automatically trigger outreach when contacts move to target accounts.

CRM Hygiene

Keep contact records accurate by detecting role changes.

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 identifier

Example:

"alex-rivera"

company_name

string

Expected company name (either company_name or company_domain is required)

Example:

"Example Robotics"

company_domain

string

Expected company domain (either company_name or company_domain is required)

Example:

"smartlead.ai"

Response

Successful job change detection

job_change_detected

boolean

Example:

false

status

enum<string>

Available options:

NO_CHANGE,

JOB_CHANGE_DETECTED,

NEVER_WORKED_THERE

Example:

"NEVER_WORKED_THERE"

summary

string

Example:

"Alex Rivera has never worked at Example Robotics according to their comprehensive employment history. They are currently working at Leadmagic as Founder for 3 years. Their complete employment history shows experience at Leadmagic, Atlas Guild, Northstar Labs, and 7 other companies. The expected company does not appear in any current or past positions, confirming they have never been employed there."

employee_name

string

Example:

"Alex Rivera"

expected_company

string

Example:

"Example Robotics"

current_company

string

Example:

"Leadmagic"

current_position

object

Show child attributes

tenure_stats

object

Show child attributes

work_history

object[]

Show child attributes

Example:

[
  {
    "title": "Founder",
    "company": "Leadmagic",
    "duration": "Sep 2022 - Present",
    "is_present": true
  },
  {
    "title": "Executive Member",
    "company": "Atlas Guild",
    "duration": "Aug 2019 - Present",
    "is_present": true
  },
  {
    "title": "Advisor",
    "company": "Northstar Labs",
    "duration": "Feb 2023 - Jan 2024",
    "is_present": false
  },
  {
    "title": "Advisor",
    "company": "Sales Community",
    "duration": "May 2020 - Dec 2023",
    "is_present": false
  },
  {
    "title": "Advisor",
    "company": "Astronomer",
    "duration": "Jul 2020 - Sep 2023",
    "is_present": false
  }
]

profile_found

boolean

Example:

true

profile_url

string

Example:

"alex-rivera"

credits_consumed

integer

Example:

2

Job Change Detector

curl --request POST \
  --url https://api.leadmagic.io/v1/people/job-change-detector \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "alex-rivera"
}
'

import requests

url = "https://api.leadmagic.io/v1/people/job-change-detector"

payload = { "profile_url": "alex-rivera" }
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'})
};

fetch('https://api.leadmagic.io/v1/people/job-change-detector', 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/job-change-detector"

	payload := strings.NewReader("{\n  \"profile_url\": \"alex-rivera\"\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/job-change-detector",
  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'
  ]),
  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;
}

{
  "job_change_detected": false,
  "status": "NEVER_WORKED_THERE",
  "summary": "Alex Rivera has never worked at Example Robotics according to their comprehensive employment history. They are currently working at Leadmagic as Founder for 3 years. Their complete employment history shows experience at Leadmagic, Atlas Guild, Northstar Labs, and 7 other companies. The expected company does not appear in any current or past positions, confirming they have never been employed there.",
  "employee_name": "Alex Rivera",
  "expected_company": "Example Robotics",
  "current_company": "Leadmagic",
  "current_position": {
    "title": "Founder",
    "company": "Leadmagic",
    "start_date": "Sep 2022",
    "days_at_job": 1111,
    "tenure_formatted": "3 years",
    "is_current_position": true
  },
  "tenure_stats": {
    "average_tenure_months": 26,
    "average_tenure_formatted": "2 years 2 months",
    "total_positions": 10,
    "longest_tenure_months": 73,
    "longest_tenure_formatted": "6 years 1 month",
    "shortest_tenure_months": 1,
    "shortest_tenure_formatted": "1 month"
  },
  "work_history": [
    {
      "title": "Founder",
      "company": "Leadmagic",
      "duration": "Sep 2022 - Present",
      "is_present": true
    },
    {
      "title": "Executive Member",
      "company": "Atlas Guild",
      "duration": "Aug 2019 - Present",
      "is_present": true
    },
    {
      "title": "Advisor",
      "company": "Northstar Labs",
      "duration": "Feb 2023 - Jan 2024",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Sales Community",
      "duration": "May 2020 - Dec 2023",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Astronomer",
      "duration": "Jul 2020 - Sep 2023",
      "is_present": false
    }
  ],
  "profile_found": true,
  "profile_url": "alex-rivera",
  "credits_consumed": 2
}

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

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

Job Change Detector API

Detect Job Changes

Endpoint Details

Per-Endpoint Limit

Quick Example

Request Parameters

Response

Example Response - No Change

Example Response - Job Changed

Success Messages

Best Practices

Use Cases

Champion Tracking

Churn Prevention

Trigger Campaigns

CRM Hygiene

Authorizations

Body

Response

​Detect Job Changes

​Endpoint Details

​Per-Endpoint Limit

​Quick Example

​Request Parameters

​Response

​Example Response - No Change

​Example Response - Job Changed

​Success Messages

​Best Practices

​Use Cases

Champion Tracking

Churn Prevention

Trigger Campaigns

CRM Hygiene

Authorizations

Body

Response

Detect Job Changes

Endpoint Details

Per-Endpoint Limit

Quick Example

Request Parameters

Response

Example Response - No Change

Example Response - Job Changed

Success Messages

Best Practices

Use Cases