Job Changes API

Track your best customers

Know when your best customers (aka your champions) switch jobs

Input type

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/job/change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "company_domain": "digitalriver.com",
  "professional_email": "jane.doe@digitalriver.com"
}'

Your Receive

{
  "status": "SUCCEEDED",
  "output": {
    "job_change_status": "moved",
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "title": "Head of Sales",
      "seniority": "Director",
      "company_name": "Acme Corp",
      "company_domain": "acme.com",
      "linkedin_url": "https://www.linkedin.com/in/jane-doe-abc123/"
    }
  }
}

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/job/change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "company_domain": "scale.com",
  "contact_linkedin": "connor-heggie"
}'

Your Receive

{
  "status": "SUCCEEDED",
  "output": {
    "job_change_status": "no_change",
    "person": {
      "first_name": "Connor",
      "last_name": "Heggie",
      "linkedin_id": "connor-heggie",
      "title": "Senior Account Executive",
      "company_name": "Scale AI",
      "company_domain": "scale.com"
    }
  }
}

You Input

curl --request POST \
  --url https://api.waterfall.io/v1/job/change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "company_domain": "digitalriver.com",
  "contact_full_name": "Jane Doe"
}'

Your Receive

{
  "status": "SUCCEEDED",
  "output": {
    "job_change_status": "moved",
    "person": {
      "first_name": "Jane",
      "last_name": "Doe",
      "title": "Head of Sales",
      "company_name": "Acme Corp",
      "company_domain": "acme.com",
      "experiences": [
        { "company_name": "Acme Corp", "start_date": "2023-11-01", "is_current": true },
        { "company_name": "Digital River", "end_date": "2023-10-01", "is_current": false }
      ]
    }
  }
}

Methodology

What makes Waterfall different

Flexible Inputs with Maximum Coverage

Coverage

Search across our database of 750M+ profiles using whatever identifier you have - social profiles, name + domain, business or personal email. Unlike platforms with limited search options, we'll find job changes from any starting point you provide.

Every Change Verified Before We Report It

Accuracy

We reprocess hundreds of millions of profiles every month, so your job-change checks run against records refreshed within weeks rather than against an annual snapshot. Every detected change is then verified in real time before it is returned, so what reaches your CRM is a confirmed move rather than a signal to go and check.

Unlimited Requests, Pay Only for Job Changes

Pricing

We offer outcome-based pricing — Waterfall deducts credits only when we detect an actual job change, even though we incur costs querying our vendors on every check. Contacts who have not moved cost nothing, so you can re-check your whole CRM as often as you like. Monitoring frequency becomes a product decision rather than a budget one.

Customers

Hear what our customers say about us

Stop comparing vendors on their numbers. Run the benchmark on yours.

Three commercial reasons to start

Flexible Commercials
Best International Coverage
High Data Accuracy

Three technical reasons to start

One single API
Unified Response & Request structure
Sync & Async solution

Visit our API Documentation

What teams build with the Job Changes API

Job Change Alerts

Track when your best users & customers switch jobs to be first to know and reach out to them in new roles

CRM Auto-Update

Keep your CRM automatically updated by periodically checking contact profiles and moving people to their new positions

FAQ

How is job-change tracking priced?

Outcome-based, and it is the reason this endpoint behaves differently from the rest of the market. Credits are deducted only when we detect an actual change — checks that come back unchanged are free. That removes the usual trade-off between monitoring frequency and cost: you can run your whole CRM weekly instead of quarterly, because the contacts who did not move cost nothing to check.

How quickly do you detect a change?

We reprocess hundreds of millions of profiles every month, so a check runs against records refreshed within weeks rather than against an annual snapshot, and every detected change is verified in real time before it is returned. The limitation worth stating plainly: detection depends on the move becoming visible in public sources, so we do not claim to see a change before it is announced anywhere.

Why track job changes at all?

A champion who moves is a warm account at a new company and a quiet risk at the old one, and both are worth knowing about on the day rather than at renewal. Teams typically wire the endpoint to two automations: alert the account owner when a product user turns up somewhere new, and flag the old account for re-qualification before the renewal conversation starts.

Does it keep our CRM current automatically?

That is the usual integration. Re-check contacts on a schedule; when a change is detected, write the new company, title and verified email back to the record while keeping the old one as history. The point is not tidy data for its own sake — outbound sent to a two-year-old title either bounces or annoys, and both are expensive.

Book a call to hear more

Every company has different needs. Talk to our team (most likely one of the founders) to share your use case and see how Waterfall can help.