Skip to main content
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": "Smartlead",
  "company_domain": "smartlead.ai"
}
'
{
  "job_change_detected": false,
  "status": "NEVER_WORKED_THERE",
  "summary": "Jesse Ouellette has never worked at Smartlead 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, Pavilion, Startree, 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": "Jesse Ouellette",
  "expected_company": "Smartlead",
  "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": "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": 2
}

​
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 3 credits 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

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

B2B profile URL or public identifier

Example:

"https://www.linkedin.com/in/jesseoue/"

​
company_name
string

Expected company name (either company_name or company_domain is required)

Example:

"Smartlead"

​
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,
NEVER_WORKED_THERE
Example:

"NEVER_WORKED_THERE"

​
summary
string
Example:

"Jesse Ouellette has never worked at Smartlead 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, Pavilion, Startree, 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:

"Jesse Ouellette"

​
expected_company
string
Example:

"Smartlead"

​
current_company
string
Example:

"Leadmagic"

​
current_position
object
​
tenure_stats
object
​
work_history
object[]
Example:
[
  {
    "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
boolean
Example:

true

​
profile_url
string
Example:

"https://www.linkedin.com/in/jesseoue/"

​
credits_consumed
integer
Example:

2