v3

latestOpenAPI 3.1.02026-07-318648277.6 KB

Jobs Data

Job Change Detector

Monitor employee transitions and detect when someone has changed jobs.

post/v1/people/job-change-detector

Request body

profile_urlstring required

Professional profile URL or identifier

company_namestring

Expected company name (either company_name or company_domain is required)

company_domainstring

Expected company domain (either company_name or company_domain is required)

Example request

{
  "profile_url": "alex-rivera",
  "company_name": "Example Robotics",
  "company_domain": "smartlead.ai"
}

Response

Successful job change detection

job_change_detectedboolean

status'NO_CHANGE' | 'JOB_CHANGE_DETECTED' | 'NEVER_WORKED_THERE'

summarystring

employee_namestring

expected_companystring

current_companystring

profile_foundboolean

profile_urlstring

credits_consumedinteger

Example response

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