> ## Documentation Index > Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Job Change Detector API > POST /v1/job-change-detector — get alerts when prospects switch companies with updated contact data. # 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 > [tab] Pricing > > | Metric | Value | > | - | - | > | **Cost** | **3 credits** per check | > > > [!TIP] > > > > Job changes are a prime trigger event. People who just started a new role have budget and authority to make purchasing decisions. > [tab] Rate Limits > > ### Per-Endpoint Limit > > | Metric | Value | > | - | - | > | **Requests/Minute** | 300 | > | **Burst Capacity** | \~5 requests/second | > > > [!NOTE] > > > > Rate limits are subject to change. Custom rate limits are available on enterprise plans — [contact us](mailto:support@leadmagic.io). *** ## Quick Example ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}} 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" }' ``` ```javascript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}} const response = await fetch('https://api.leadmagic.io/v1/people/job-change-detector', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ profile_url: 'linkedin.com/in/alex-rivera', company_domain: 'leadmagic.io' }) }); const data = await response.json(); if (data.job_changed) { console.log(`Job change detected! Now at: ${data.current_company}`); } ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import requests response = requests.post( 'https://api.leadmagic.io/v1/people/job-change-detector', headers={'X-API-Key': 'YOUR_API_KEY'}, json={ 'profile_url': 'linkedin.com/in/alex-rivera', 'company_domain': 'leadmagic.io' } ) data = response.json() if data.get('job_changed'): print(f"Job change detected! Now at: {data['current_company']}") ``` *** ## 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 > [!WARNING] > > 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 ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "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 ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "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 > [accordion] Monitor key contacts regularly > > Run weekly checks on your top accounts to catch job changes early. > [accordion] Act fast on changes > > Job changers in their first 90 days are 3x more likely to buy. Reach out quickly. > [accordion] Follow the champion > > When your champion moves, reach out at their new company - they already know your value. > [accordion] Batch your checks > > Check multiple contacts in parallel to efficiently monitor your database. *** ## Use Cases > [card] Champion Tracking > > Follow your product champions when they move to new companies. > [card] Churn Prevention > > Know when key contacts leave accounts before renewal conversations. > [card] Trigger Campaigns > > Automatically trigger outreach when contacts move to target accounts. > [card] CRM Hygiene > > Keep contact records accurate by detecting role changes. ## OpenAPI ````yaml post /v1/people/job-change-detector openapi: 3.1.0 info: title: LeadMagic API version: 1.4.34 description: > # LeadMagic API Documentation The LeadMagic API provides comprehensive B2B data enrichment services including email validation, email finding, profile search, company intelligence, and more. ## Quick Start 1. Get your API key from the [LeadMagic Dashboard](https://app.leadmagic.io) 2. Add the `X-API-Key` header to all requests 3. Start enriching your data! ## Base URL All API requests should be made to: `https://api.leadmagic.io` ## Rate Limits Each endpoint has specific rate limits (requests per minute). Exceeding limits returns a `429 Too Many Requests` response. ## Credits API calls consume credits based on the endpoint used. Check your balance with the `/v1/credits` endpoint. ## Support Contact us at support@leadmagic.io for assistance. contact: name: LeadMagic Support email: support@leadmagic.io url: https://leadmagic.io termsOfService: https://leadmagic.io/legal/terms servers: - url: https://api.leadmagic.io description: Production API Server security: - ApiKeyAuth: [] tags: - name: Credits description: Manage and check your credit balance - name: Analytics description: >- Monitor your API usage with comprehensive analytics endpoints (FREE - no credits consumed) - name: People Enrichment description: Find and validate contact information for individuals - name: Company Data description: Discover company information and intelligence - name: Jobs Data description: Search job listings and detect career changes - name: Ads Data description: Search advertising data across platforms paths: /v1/people/job-change-detector: post: tags: - Jobs Data summary: Job Change Detector description: Monitor employee transitions and detect when someone has changed jobs. operationId: job-change-detector requestBody: required: true content: application/json: schema: type: object properties: profile_url: type: string description: Professional profile URL or identifier example: alex-rivera company_name: type: string description: >- Expected company name (either company_name or company_domain is required) example: Example Robotics company_domain: type: string description: >- Expected company domain (either company_name or company_domain is required) example: smartlead.ai required: - profile_url responses: '200': description: Successful job change detection content: application/json: schema: type: object properties: job_change_detected: type: boolean example: false status: type: string enum: - NO_CHANGE - JOB_CHANGE_DETECTED - NEVER_WORKED_THERE example: NEVER_WORKED_THERE summary: type: 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: type: string example: Alex Rivera expected_company: type: string example: Example Robotics current_company: type: string example: Leadmagic current_position: type: object properties: title: type: string example: Founder company: type: string example: Leadmagic start_date: type: string example: Sep 2022 days_at_job: type: integer example: 1111 tenure_formatted: type: string example: 3 years is_current_position: type: boolean example: true tenure_stats: type: object properties: average_tenure_months: type: integer example: 26 average_tenure_formatted: type: string example: 2 years 2 months total_positions: type: integer example: 10 longest_tenure_months: type: integer example: 73 longest_tenure_formatted: type: string example: 6 years 1 month shortest_tenure_months: type: integer example: 1 shortest_tenure_formatted: type: string example: 1 month work_history: type: array items: type: object properties: title: type: string example: Founder company: type: string example: LeadMagic duration: type: string example: Sep 2022 - Present is_present: type: boolean example: true 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: type: boolean example: true profile_url: type: string example: alex-rivera credits_consumed: type: integer example: 2 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimitExceeded' '500': $ref: '#/components/responses/InternalServerError' components: responses: BadRequest: description: | Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values content: application/problem+json: schema: $ref: '#/components/schemas/ValidationError' Unauthorized: description: | Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/MissingAuthenticationError' - $ref: '#/components/schemas/InvalidApiKeyError' PaymentRequired: description: > Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/billing content: application/problem+json: schema: $ref: '#/components/schemas/InsufficientCreditsError' NotFound: description: | Not Found - The requested resource could not be found. **Common causes:** - Profile doesn't exist or is not accessible - Company not found in our database - Invalid URL or identifier content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ResourceNotFoundError' - $ref: '#/components/schemas/ProfileNotFoundError' RateLimitExceeded: description: | Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets headers: Retry-After: schema: type: integer description: Seconds to wait before retrying RateLimit-Limit: schema: type: integer description: Maximum requests per minute RateLimit-Remaining: schema: type: integer description: Remaining requests this minute RateLimit-Reset: schema: type: integer description: Seconds until limit resets content: application/problem+json: schema: $ref: '#/components/schemas/RateLimitExceededError' InternalServerError: description: > Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io content: application/problem+json: schema: $ref: '#/components/schemas/InternalServerError' schemas: ValidationError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/validation_error title: Request validation failed. Check your input parameters. status: 400 code: validation_error param: - email detail: 'Email format is invalid. Expected format: user@domain.com' action: Provide a valid email address in the 'email' field. docs: https://leadmagic.io/docs/api-reference/errors meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' MissingAuthenticationError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/missing_authentication title: >- Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive). status: 401 code: missing_authentication docs: https://leadmagic.io/docs/api-reference/authentication meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' InvalidApiKeyError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/invalid_api_key title: Invalid API key. The key does not exist or is incorrect. status: 401 code: invalid_api_key docs: https://leadmagic.io/docs/api-reference/authentication meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' InsufficientCreditsError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/insufficient_credits title: 'Insufficient credits: need 5, have 2.50. Add credits to continue.' status: 402 code: insufficient_credits detail: >- This request requires 5 credit(s) but your account only has 2.50 credits remaining. action: >- Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans. docs: https://leadmagic.io/docs/api-reference/credits context: credits_required: 5 credits_available: 2.5 credits_needed: 2.5 meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' ResourceNotFoundError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/resource_not_found title: Resource not found. status: 404 code: resource_not_found docs: https://leadmagic.io/docs/api-reference/errors meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' ProfileNotFoundError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/profile_not_found title: Profile not found or not accessible status: 404 code: profile_not_found docs: https://leadmagic.io/docs/api-reference/errors meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' RateLimitExceededError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/rate_limit_exceeded title: >- Rate limit exceeded: 300 requests per 1 minute. Wait and try again. status: 429 code: rate_limit_exceeded detail: >- You have exceeded the maximum allowed request rate. Please wait before making additional requests. action: >- Wait 42 seconds before retrying. Consider implementing exponential backoff. docs: https://leadmagic.io/docs/api-reference/rate-limits context: limit: 300 window: 1 minute remaining: 0 reset_at: 1706745642 retry_after_seconds: 42 meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' InternalServerError: allOf: - $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - type: https://api.leadmagic.io/errors/INTERNAL_ERROR title: >- Something went wrong on our end. Our team has been notified and is investigating. status: 500 code: INTERNAL_ERROR detail: >- This is a temporary server error. The issue has been automatically reported to our team. action: >- Wait 30 seconds and retry your request. If the problem persists, contact support@leadmagic.io docs: https://leadmagic.io/docs/api-reference/errors meta: request_id: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: '2024-02-01T12:00:00.000Z' ErrorResponse: type: object description: RFC 9457 Problem Details error response required: - success - errors properties: success: type: boolean example: false description: Always false for error responses errors: type: array description: Array of error details (typically one, but can be multiple) items: $ref: '#/components/schemas/ErrorDetail' meta: $ref: '#/components/schemas/ResponseMeta' ErrorDetail: type: object description: RFC 9457 compliant error detail required: - type - title - status properties: type: type: string format: uri description: RFC 9457 - URI reference identifying the error type example: https://api.leadmagic.io/errors/validation_error title: type: string description: RFC 9457 - Short human-readable summary example: Request validation failed. Check your input parameters. status: type: integer description: RFC 9457 - HTTP status code example: 400 detail: type: string description: RFC 9457 - Human-readable explanation specific to this occurrence example: The email field is required but was not provided. instance: type: string format: uri description: RFC 9457 - URI reference for this specific occurrence example: /v1/people/email-validation#req_abc123 code: type: string description: Machine-readable error code for programmatic handling example: validation_error param: type: array description: Parameters that caused the error items: type: string example: - email action: type: string description: Suggested action to resolve the error example: Provide a valid email address in the 'email' field. docs: type: string format: uri description: Link to relevant documentation example: https://leadmagic.io/docs/api-reference/errors context: type: object description: Additional context specific to this error type additionalProperties: true ResponseMeta: type: object description: Metadata included in all responses properties: request_id: type: string format: uuid description: Unique identifier for this request (use for debugging/support) example: ea6e3248-f4d2-437d-bca3-20881b529129 timestamp: type: string format: date-time description: ISO 8601 timestamp when the response was generated example: '2024-02-01T12:00:00.000Z' environment: type: string description: API environment (production, staging) example: production securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.