# Career Site Jobs API - Greenhouse, Lever, Ashby & 4 more ATS (`srkonkel/career-site-jobs-ats`) Actor

Get job postings straight from company career sites through the official public job-board APIs of Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee, Workable and Personio. One clean schema, filters, only-new-jobs mode. $1 per 1,000 jobs.

- **URL**: https://apify.com/srkonkel/career-site-jobs-ats.md
- **Developed by:** [Wellington Pereira Konkel](https://apify.com/srkonkel) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 job listing returneds

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

## Career Site Jobs API — Greenhouse, Lever, Ashby & 4 more ATS

**Get job postings straight from company career sites** — Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee,
Workable and Personio — in **one clean schema**. The Actor reads the **official public job-board APIs** each
applicant tracking system (ATS) publishes for job boards: no HTML scraping, no browser, no login.

**$1 per 1,000 jobs.** You pay only for jobs returned; companies that fail (wrong URL, board not found) cost nothing.

### What can this Actor do?

- 🏢 **7 ATS in one run** — paste career page URLs, the ATS is detected automatically.
- 🧹 **One schema for every ATS** — title, department, team, location(s), country, remote flag, workplace type,
  employment type, salary (when the employer publishes it), posted/updated dates, job and apply links.
- 🔎 **Filters** — title keywords (include/exclude), location keywords, remote only, posted in the last N days.
- 🔔 **Only new jobs** — monitoring mode that returns only jobs your previous runs did not return. Schedule it daily
  and get a feed of new openings (hiring signals, job alerts, market research).
- 📝 **Optional descriptions** as plain text, with contact details (emails, phone numbers, personal profile links)
  removed.
- ⚡ **Fast and light** — pure API calls, 256 MB of memory.

### Supported career sites

| ATS | Example input |
|---|---|
| Greenhouse | `https://boards.greenhouse.io/stripe` or `greenhouse:stripe` |
| Lever (incl. EU) | `https://jobs.lever.co/spotify` |
| Ashby | `https://jobs.ashbyhq.com/ashby` |
| SmartRecruiters | `https://careers.smartrecruiters.com/smartrecruiters` |
| Recruitee | `https://bunq.recruitee.com` |
| Workable | `https://apply.workable.com/<company>` |
| Personio | `https://personio.jobs.personio.de` |

Tip: open the company's "Careers" page and click any job — the address of the job page tells you the ATS.

### How to use it

1. Click **Try for free** (or **Start**).
2. Paste one career page per line in **Company career pages**.
3. Optionally add filters (title, location, remote, posted within N days).
4. Click **Start**. Each job becomes one row in the **Output** tab — export as JSON, CSV or Excel, or read it through
   the API.

### How much does it cost?

**$1.00 per 1,000 jobs** (pay-per-event `job-listing`, $0.001 per job), plus Apify's standard Actor start fee
($0.00005 per GB of run memory — about $0.0000125 per run at the default 256 MB). Platform usage is included.

| Jobs returned | Price |
|---|---|
| 100 | $0.10 |
| 1,000 | $1.00 |
| 10,000 | $10.00 |

- Jobs removed by your filters are **not charged**. Companies that fail are **not charged**.
- Set a **maximum cost per run** in the run options; the Actor stops cleanly when it is reached.

### Input

| Field | Description | Default |
|---|---|---|
| `companies` | Career page URLs or `ats:board` | — |
| `titleKeywords` | Keep titles containing any of these words | all |
| `excludeTitleKeywords` | Drop titles containing any of these words | none |
| `locationKeywords` | Keep jobs whose location/country contains any of these | all |
| `remoteOnly` | Only remote jobs | `false` |
| `postedWithinDays` | Only jobs posted in the last N days | all |
| `onlyNewJobs` | Only jobs not returned by previous runs (same company list) | `false` |
| `includeDescription` | Add the description as plain text | `false` |
| `maxJobsPerCompany` | Limit per company (after filters) | `500` |

```json
{
  "companies": ["https://boards.greenhouse.io/stripe", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/ashby"],
  "titleKeywords": ["engineer", "developer"],
  "remoteOnly": false
}
```

### Output

```json
{
  "company": "ashby",
  "ats": "ashby",
  "jobId": "d573471b-2005-482c-9fbf-d1df9550cb57",
  "title": "Engineering Manager - UK",
  "department": "Engineering",
  "team": "EMEA Engineering",
  "location": "United Kingdom",
  "locations": ["United Kingdom", "London", "Manchester"],
  "country": "United Kingdom",
  "remote": true,
  "workplaceType": "Remote",
  "employmentType": "FullTime",
  "salary": "£110K – £200K",
  "postedAt": "2025-04-01T14:39:51Z",
  "updatedAt": null,
  "url": "https://jobs.ashbyhq.com/ashby/d573471b-2005-482c-9fbf-d1df9550cb57",
  "applyUrl": "https://jobs.ashbyhq.com/ashby/d573471b-2005-482c-9fbf-d1df9550cb57/application",
  "description": null,
  "scrapedAt": "2026-10-01T06:40:00Z"
}
```

Fields an ATS does not publish are `null` (for example, SmartRecruiters' list has no description; many employers
do not publish salaries). A run summary (companies read, jobs, failures) is saved as `SUMMARY` in the run's
key-value store.

### Use it from your code (API)

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("srkonkel/career-site-jobs-ats").call(run_input={
    "companies": ["https://boards.greenhouse.io/stripe", "https://jobs.lever.co/spotify"],
    "titleKeywords": ["data"],
})
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["company"], job["title"], job["url"])
```

**JavaScript** (`npm install apify-client`):

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('srkonkel/career-site-jobs-ats').call({
    companies: ['https://jobs.ashbyhq.com/ashby'],
    remoteOnly: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, 'jobs');
```

**cURL** (run and get the jobs in one call):

```bash
curl -X POST "https://api.apify.com/v2/acts/srkonkel~career-site-jobs-ats/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" -H "Content-Type: application/json" \
  -d '{"companies": ["https://boards.greenhouse.io/stripe"], "postedWithinDays": 7}'
```

### Use it with AI agents (MCP)

Add this Actor as a tool in the Apify MCP server and your AI agent can look up open roles at any company that uses
a supported ATS, paying per job like any other user.

### FAQ

**Is this legal?** The Actor only reads the public job-board APIs that these ATS vendors publish so that job boards
and websites can display openings. It does not log in, bypass protections or scrape HTML. Use the data in line with
the terms of the sites involved and applicable law.

**Do you collect personal data?** No profiles or candidate data — only job postings. Descriptions are optional and
emails, phone numbers and personal profile links are removed from them.

**Why did a company fail?** The URL is not from a supported ATS, the board name is wrong, or the board is empty/
private. Failed companies are listed in the run log and in `SUMMARY`, and are never charged.

**Can I monitor companies for new jobs?** Yes: turn on **Only jobs not seen in previous runs** and schedule the
Actor (daily or hourly). Keep the same company list so the state matches.

**Workday / iCIMS / Taleo?** Not supported yet: they do not offer a comparable public job-board API.

### Limitations

- One run reads the companies you list; it is not a search over all companies on the internet.
- Each ATS controls its own data: missing fields stay `null`.

# Actor input Schema

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

One per line: the company's job board URL (e.g. https://boards.greenhouse.io/stripe, https://jobs.lever.co/spotify, https://jobs.ashbyhq.com/ashby, https://careers.smartrecruiters.com/smartrecruiters, https://bunq.recruitee.com, https://apply.workable.com/acme, https://personio.jobs.personio.de) or 'ats:board' (e.g. greenhouse:stripe).

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains at least one of these words (case-insensitive). Leave empty to keep all.

## `excludeTitleKeywords` (type: `array`):

Drop jobs whose title contains any of these words (e.g. intern, senior).

## `locationKeywords` (type: `array`):

Keep only jobs whose location or country contains one of these words (e.g. Berlin, Remote, US).

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

Keep only jobs marked as remote by the employer (or with 'remote' in the location).

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

Keep only jobs published (or updated, when the ATS gives no publish date) in the last N days.

## `onlyNewJobs` (type: `boolean`):

Monitoring mode: return only jobs that previous runs with the same company list did not return (state kept in your account's key-value store).

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

Add the description as plain text. Contact details (emails, phone numbers, personal profile links) are removed.

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

Upper limit of jobs returned per company (after filters). You pay only for jobs returned.

## Actor input object example

```json
{
  "companies": [
    "https://boards.greenhouse.io/stripe",
    "https://jobs.lever.co/spotify",
    "https://jobs.ashbyhq.com/ashby"
  ],
  "remoteOnly": false,
  "onlyNewJobs": false,
  "includeDescription": false,
  "maxJobsPerCompany": 500
}
```

# Actor output Schema

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

No description

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

No description

# 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://boards.greenhouse.io/stripe",
        "https://jobs.lever.co/spotify",
        "https://jobs.ashbyhq.com/ashby"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("srkonkel/career-site-jobs-ats").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://boards.greenhouse.io/stripe",
        "https://jobs.lever.co/spotify",
        "https://jobs.ashbyhq.com/ashby",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("srkonkel/career-site-jobs-ats").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://boards.greenhouse.io/stripe",
    "https://jobs.lever.co/spotify",
    "https://jobs.ashbyhq.com/ashby"
  ]
}' |
apify call srkonkel/career-site-jobs-ats --silent --output-dataset

```

## MCP server setup

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

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/zbofbh4zSKhI7oIFd/builds/ZAgnwbn23vK6W562u/openapi.json