POST
/
v1
/
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": "https://www.linkedin.com/in/jesseoue/",
  "company_name": "leadmagic",
  "company_domain": "leadmagic.io"
}'
{
  "job_change_detected": false,
  "status": "NO_CHANGE",
  "summary": "Jesse Ouellette is currently employed at leadmagic",
  "employee_name": "Jesse Ouellette",
  "expected_company": "leadmagic",
  "current_company": "LeadMagic",
  "current_position": {
    "title": "Founder",
    "company": "LeadMagic",
    "start_date": "Sep 2022",
    "days_at_job": 1107,
    "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": "Pavilion",
      "duration": "Aug 2019 - Present",
      "is_present": true
    },
    {
      "title": "Advisor",
      "company": "StarTree",
      "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": "https://www.linkedin.com/in/jesseoue/",
  "credits_consumed": 1
}

​
Job Change Detection

Monitor employee transitions and detect when someone has changed jobs.
You must provide either the company_name or company_domain parameter along with the profile URL.
Charges 1 credit per request regardless of the result.

​
Use Cases

  • Sales Intelligence: Track when prospects change companies
  • HR & Recruiting: Monitor candidate job transitions
  • Lead Management: Update CRM records when contacts switch roles
  • Account Management: Stay informed about key stakeholders’ career moves

​
Input Requirements

Required: Profile URL (LinkedIn profile URL or public identifier) Required: Either company name OR company domain for comparison - Company Domain: leadmagic.io (more accurate and preferred) - Company Name: LeadMagic (less precise matching)

​
Detection Results

​
No Change Detected

Status: NO_CHANGE The person is still employed at the expected company. Profile analysis confirms current employment matches your expectations.

​
Job Change Detected

Status: JOB_CHANGE The person has moved to a different company. You’ll receive:
  • New company details
  • Previous position information
  • Career transition timeline

​
Never Worked There

Status: NEVER_WORKED_THERE The person has never been employed at the expected company based on their profile history. This indicates:
  • No employment record found matching the expected company
  • Complete work history analysis shows no association with the company
  • Profile verification confirms they have worked elsewhere exclusively

​
Response Data

Each successful request returns:
  • Job change status and summary
  • Current position details with tenure information
  • Complete work history with dates and roles
  • Tenure statistics including average, longest, and shortest positions
  • Profile verification status and URL

​
Rate Limits & Credits

Rate Limit: 300 requests per minute. Contact support if you need higher limits for enterprise usage.
Pro Tip: Use company domains instead of company names for more accurate matching. Domain matching is case-insensitive and handles variations better.

​
Error Handling

  • 400: Missing required parameters (profile_url and company info)
  • 404: Profile not found or not accessible
  • 500: Service temporarily unavailable - retry after a brief delay

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Response

Successful job change detection

The response is of type object.