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
}

Changes

Changed in 1 of the 8 revisions of this API.8

Aug 25, 20261f289eff3a268See the full diff
- ▲
  the allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 400
  response-property-type-changed
- ▲
  the allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 402
  response-property-type-changed
- ▲
  the allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 429
  response-property-type-changed
- ▲
  the allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 500
  response-property-type-changed
- ▲
  the oneOf[InvalidApiKeyError]/allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 401
  response-property-type-changed
- ▲
  the oneOf[MissingAuthenticationError]/allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 401
  response-property-type-changed
- ▲
  the oneOf[ProfileNotFoundError]/allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 404
  response-property-type-changed
- ▲
  the oneOf[ResourceNotFoundError]/allOf[ErrorResponse]/errors/items/instance response's property type/format changed from string/uri to string/uri-reference for status 404
  response-property-type-changed

Full history