Greenhouse, Lever, Ashby, Workable, Teamtailor Jobs API
One API for six applicant tracking systems: Greenhouse, Lever, Ashby, Workable, Teamtailor and SmartRecruiters.
Give it a company website. It finds the job board itself, returns every open role, and on every run after that returns only what changed — roles opened, roles closed, titles moved, salaries changed — plus derived hiring signals.
{ "domains": ["stripe.com", "spotify.com", "pleo.io"] }
No board tokens. No ATS knowledge required. No browser.
Two ways to run it
| Hosted on Apify | Self-hosted MCP server | |
|---|---|---|
| Setup | none | npx ats-jobs-mcp |
| State between runs | managed | local file |
| Scheduling, retries, storage | included | your own |
| Price | $1 per 1,000 jobs | free |
| Link | apify.com/feedworks/ats-jobs-api | this repo, mcp/ |
The logic is the same code in both. Pick whichever fits.
What you get
| Event | Meaning |
|---|---|
job_indexed |
Baseline: an open role captured on the first run |
job_posted |
A new opening appeared |
job_closed |
An opening disappeared |
job_changed |
Title, location, department or employment type changed |
salary_changed |
Compensation changed |
hiring_accelerating |
This month's postings are 2× or more the recent average |
first_role_in_function |
First ever hire in sales, AI/ML, security, data — a new budget line opened |
hiring_freeze |
Postings dropped to zero after steady hiring |
Every record carries provenance: source URL, HTTP status, fetch time, job count, truncation flag and a confidence value — so an agent can verify before it acts, instead of trusting a claim.
MCP server
npx ats-jobs-mcp
Four tools, usable by any MCP client — Claude Desktop, Cursor, VS Code, your own agent:
| Tool | Question it answers |
|---|---|
find_job_board |
Which ATS does this company use, and what is its board token? |
list_jobs |
What roles are open right now? |
detect_changes |
What changed since the last time I looked? |
hiring_summary |
What is this company hiring for — which functions, which locations? |
Claude Desktop config:
{
"mcpServers": {
"ats-jobs": { "command": "npx", "args": ["-y", "ats-jobs-mcp"] }
}
}
State lives in ~/.ats-jobs-mcp/state.json. Override with ATS_MCP_STATE.
Why it stays cheap to run continuously
Every source is polled with If-None-Match. When nothing changed, the ATS answers 304 with no body.
Measured on the hosted Actor at 512 MB:
| Path | Compute |
|---|---|
Nothing changed (304) |
0.000344 CU per run |
| Baseline, 143 jobs | 0.001386 CU |
That is why watching hundreds of companies every few hours costs cents rather than dollars — and why this project will never open a headless browser to read a job board.
What it deliberately does not do
- No personal data. Recruiter names, emails and phone numbers are stripped at parse time and never stored.
- No headless browser, no proxies. Only public ATS endpoints that answer with JSON.
- No false layoffs. If a source response may be truncated by paging,
job_closedevents are suppressed — a paging artefact must never look like a company shutting down hiring.
Supported sources
greenhouse · lever · ashby · workable · teamtailor · smartrecruiters
Detection order: a link on the company careers page → the board token guessed from the domain → Workable short links resolved through their redirect.
Companies that cannot be resolved return a source_unresolved record explaining why, instead of failing silently.
Recruitee and Personio are not listed because they are not verified working. Personio currently answers 429 to non-browser clients; Recruitee endpoints did not resolve in testing. This project does not claim coverage it cannot deliver.
Repo layout
src/ Apify Actor: adapters, diff engine, derived signals
mcp/ MCP server — the same engine, self-hosted
tools/ discovery utilities (domain → ATS)
.actor/ Apify manifests and schemas
MIT licensed. Contributions welcome, especially new ATS adapters — the interface is one url() and one parse() function per system, see src/adapters/index.js.
