# ATS Jobs Monitor: Greenhouse, Lever, Ashby, Workable & more (`ghimli/ats-jobs-monitor`) Actor

Get job postings from company career boards through official public APIs, in one schema, with parsed salaries and an only-new-jobs mode for scheduled runs. No proxies or browser.

- **URL**: https://apify.com/ghimli/ats-jobs-monitor.md
- **Developed by:** [Damian Obernikowicz](https://apify.com/ghimli) (community)
- **Categories:** Jobs, Developer tools
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ATS Jobs Monitor

Get open jobs from company career boards on **Greenhouse, Lever, Ashby, Workable and SmartRecruiters** in one schema.

The Actor reads each platform's public job-board API. It doesn't use a browser or proxies, and it reads no login-protected data.

### What it does

- **One schema across five platforms**, so you can combine boards without writing mapping code.
- **Only new jobs:** turn on `onlyNew` and schedule the Actor to get just the jobs not seen in earlier runs.
- **Salaries as numbers:** uses the salary the ATS provides, or looks for an annual range in the description. `salarySource` tells you which.
- **Filters:** title keywords, excluded keywords, location, remote, salary present, posted within N days.
- **Bad boards don't fail the run:** each board's result is listed in `SUMMARY` in the key-value store.

### Input

```json
{
  "companies": [
    "https://job-boards.greenhouse.io/stripe",
    "https://jobs.lever.co/spotify",
    "ashby:ramp",
    "notion"
  ],
  "keywords": ["engineer", "data"],
  "excludeKeywords": ["intern"],
  "remoteOnly": false,
  "onlyNew": true,
  "monitorName": "engineering"
}
```

A bare slug such as `notion` is checked on each platform, and the first one with open jobs is used. Use a URL or `ats:slug` if you need a specific board. Boards hosted in Lever's EU region need a `jobs.eu.lever.co` URL.

You need to know which companies you want: this Actor reads the boards you list and doesn't search the whole job market.

### Output

```json
{
  "id": "ashby:ramp:34413f8d-26bf-4bbc-8ade-eb309a0e2245",
  "ats": "ashby",
  "company": "ramp",
  "companySlug": "ramp",
  "title": "Security Engineer, Cloud",
  "department": "Engineering",
  "team": "Backend",
  "location": "New York, NY (HQ)",
  "country": "USA",
  "isRemote": true,
  "workplaceType": "Hybrid",
  "employmentType": "FullTime",
  "salaryMin": 211400,
  "salaryMax": 290600,
  "salaryCurrency": "USD",
  "salaryPeriod": "year",
  "salarySource": "ats",
  "publishedAt": "2026-04-07T17:12:35.753+00:00",
  "updatedAt": null,
  "url": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245",
  "applyUrl": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245/app",
  "descriptionText": "...",
  "scrapedAt": "2026-11-04T16:00:00Z"
}
```

Fields a platform doesn't provide are `null`. `company` is the board's slug on Lever and Ashby, because their APIs don't return a display name.

### Pricing

$0.005 per run plus $0.001 per job returned. Filtered-out and already-seen jobs aren't charged. If you set a maximum cost per run, the Actor stops there, and jobs it didn't send stay "new" for the next run.

### Limits

- Salary parsing covers `$`, `€` and `£` annual ranges written as ranges in the description. It can miss or misread unusual wording, and it may pick up a range for a different location, so check it before relying on it.
- `isRemote` reflects what the board says. Without a platform flag, it means the location or workplace type contains "remote".
- With `onlyNew`, a job that leaves a board and returns later counts as new.

### Issues

Open an issue on the Actor's Issues tab with your input and run ID. This Actor isn't affiliated with or endorsed by the ATS platforms it reads.

# Actor input Schema

## `companies` (type: `array`):

Career board URLs (https://job-boards.greenhouse.io/stripe, https://jobs.lever.co/spotify, https://jobs.ashbyhq.com/ramp, https://apply.workable.com/acme, https://jobs.smartrecruiters.com/acme), or ats:slug such as greenhouse:stripe, or a bare slug such as stripe to detect the platform.

## `keywords` (type: `array`):

Keep jobs whose title contains any of these. Case-insensitive. Empty keeps all.

## `excludeKeywords` (type: `array`):

Drop jobs whose title contains any of these.

## `locations` (type: `array`):

Keep jobs whose location text contains any of these, such as Berlin or United Kingdom.

## `remoteOnly` (type: `boolean`):

Keep only jobs the board marks as remote or that say remote in their location.

## `onlyWithSalary` (type: `boolean`):

Keep only jobs with a salary from the ATS or found in the description.

## `postedWithinDays` (type: `integer`):

Keep only jobs published in the last N days. Jobs without a date are dropped when this is set.

## `onlyNew` (type: `boolean`):

Output only jobs not seen in earlier runs. Use with a schedule. The first run outputs everything that matches.

## `monitorName` (type: `string`):

Keeps separate seen-job history for each monitor when Only new jobs is on.

## `maxJobsPerCompany` (type: `integer`):

Limit output per company. 0 means no limit.

## `includeDescription` (type: `boolean`):

Include the job description as plain text.

## `includeDescriptionHtml` (type: `boolean`):

Also include the original description HTML.

## Actor input object example

```json
{
  "companies": [
    "https://job-boards.greenhouse.io/stripe",
    "https://jobs.ashbyhq.com/ramp"
  ],
  "remoteOnly": false,
  "onlyWithSalary": false,
  "onlyNew": false,
  "monitorName": "default",
  "maxJobsPerCompany": 0,
  "includeDescription": true,
  "includeDescriptionHtml": false
}
```

# Actor output Schema

## `jobs` (type: `string`):

Job postings returned by this run.

## `summary` (type: `string`):

Status and job counts for each company board.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "https://job-boards.greenhouse.io/stripe",
        "https://jobs.ashbyhq.com/ramp"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ghimli/ats-jobs-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "companies": [
        "https://job-boards.greenhouse.io/stripe",
        "https://jobs.ashbyhq.com/ramp",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("ghimli/ats-jobs-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    "https://job-boards.greenhouse.io/stripe",
    "https://jobs.ashbyhq.com/ramp"
  ]
}' |
apify call ghimli/ats-jobs-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ghimli/ats-jobs-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/LjPHZc4ca0bFduDrq/builds/kz6ZAKTOHh4fyxYBR/openapi.json