Job Change Detector API

POST /v1/job-change-detector — get alerts when prospects switch companies with updated contact data.

POST /v1/people/job-change-detector

Job Change Detector

cURL

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

200

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

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

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.

Rate Limits

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

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

---

Request Parameters

profile_url · string · required

Professional profile URL or username to monitor

company_domain · string

Expected company domain to check against (preferred)

company_name · string

Expected company name to check against

You must provide either company_domain or company_name to compare against.

---

Response

job_changed · boolean · required

Whether the person has changed jobs

still_employed · boolean

Whether still employed at the expected company

current_company · string

Current company name (if changed)

current_title · string

Current job title

expected_company · string

The company you were checking against

credits_consumed · number · required

Credits used (always 3)

message · 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

200

application/json

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