# Greenhouse, Lever & Ashby Job Scraper API (`bovi/greenhouse-lever-ashby-job-scraper`) Actor
Scrape job postings across 6 ATS — Greenhouse, Lever, Ashby, Recruitee, SmartRecruiters & Personio — into one unified schema. Descriptions, salary, seniority and remote-type included. Change-detection between runs, ATS auto-detect, curated company presets. No login, no browser, pure API.
- **URL**: https://apify.com/bovi/greenhouse-lever-ashby-job-scraper.md
- **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 job results
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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Job Scraper — Greenhouse, Lever, Ashby, Recruitee, SmartRecruiters & Personio
Scrape job postings across **6 major ATS platforms** in a single run — every job
comes back in **one unified schema**, no matter which ATS hosted it. No login, no
API key, no browser: this scraper reads each ATS's public JSON/XML endpoint
directly, so it's **fast, cheap and stable**.
Give it a list of company slugs — or skip the research and use a **preset list**,
or let it **auto-detect** the ATS for you. Get clean, enriched rows with
**descriptions, salary, seniority and remote-type** built in. **Try it free** —
Apify's $5/month free tier covers thousands of jobs.
### What this job scraper does
- Pulls every open posting from **Greenhouse, Lever, Ashby, Recruitee,
SmartRecruiters and Personio** boards.
- Normalizes six wildly different ATS formats into **one flat schema**.
- **Auto-detects the ATS** when you only have a company name.
- Enriches every job with **seniority** (intern → executive) and **remote-type**
(remote / hybrid / onsite).
- Returns **full job descriptions** (plain text + HTML), salary where the ATS
exposes it, department, team, employment type, apply URL and posted date.
- **Change-detection between runs** — get only new and newly-closed jobs.
- **Curated company presets** so you can start without researching slugs.
- Filters by title keyword, location, or remote-only; output profiles to keep
payloads lean.
### Supported ATS platforms
| ATS | Board URL | Example slug |
|---|---|---|
| **Greenhouse** | `boards.greenhouse.io/{slug}` | `stripe` |
| **Lever** | `jobs.lever.co/{slug}` | `spotify` |
| **Ashby** | `jobs.ashbyhq.com/{slug}` | `ramp` |
| **Recruitee** | `{slug}.recruitee.com` | `bunq` |
| **SmartRecruiters** | `jobs.smartrecruiters.com/{slug}` | `Visa` |
| **Personio** | `{slug}.jobs.personio.de` | `personio` |
Most multi-ATS scrapers stop at the big three. This one covers **six**.
### What data you get
One rectangular row per job — identical keys across every ATS:
```json
{
"ats": "ashby",
"company": "ramp",
"title": "Senior Security Engineer, Cloud",
"location": "New York, NY (HQ)",
"remote": true,
"remote_type": "remote",
"department": "Engineering",
"team": "Backend",
"employment_type": "FullTime",
"seniority": "senior",
"salary": "$211.4K - $290.6K",
"url": "https://jobs.ashbyhq.com/ramp/34413f8d-...",
"apply_url": "https://jobs.ashbyhq.com/ramp/34413f8d-...",
"posted_at": "2026-04-07T17:12:35.753+00:00",
"job_id": "34413f8d-26bf-4bbc-8ade-eb309a0e2245",
"global_id": "ashby:ramp:34413f8d-...",
"description_text": "About Ramp\n\nRamp is building...",
"description_html": "About Ramp...
"
}
````
- **`global_id`** (`{ats}:{company}:{job_id}`) is a stable key for joining,
diffing and de-duplicating across runs.
- **`seniority`** and **`remote_type`** use the ATS's native fields where present
and fall back to title/location inference.
- **`salary`** is filled where the ATS publishes it (Ashby has the cleanest comp
data; most boards don't expose salary).
### Who uses this scraper
- **Job boards & aggregators** — power a niche board from a curated company list;
one ETL, six ATS covered.
- **Sales & B2B prospecting** — "company X just opened 5 engineering roles" is a
hiring signal. Track accounts and route to your CRM.
- **Recruiters & sourcers** — pull every open role at target companies, refresh
nightly with change-detection.
- **Market & wage researchers** — build salary and hiring datasets on a stable,
enriched schema.
### How to use
1. Click **Try for free**.
2. In the **Input** tab, either:
- add companies, e.g. `{ "ats": "greenhouse", "company": "stripe" }` (omit
`ats` to auto-detect), **or**
- pick a **preset list**: `top-tech`, `ai-ml`, `devtools`, `fintech`.
3. Optionally set `titleKeyword`, `locationKeyword`, `remoteOnly`,
`includeDescriptions`, `outputProfile`, or `maxJobsPerCompany`.
4. Click **Start**, then download the dataset as **JSON, CSV, or Excel** — or
pull it via the Apify API.
#### Daily "new jobs only" feed
Turn on **`onlyNewSinceLastRun`** and schedule the actor (hourly/daily). The first
run snapshots the jobs; every run after that emits only **new** jobs
(`is_new: true`) and **closed** jobs (`is_closed: true`). Wire it to a webhook,
Slack, Zapier or Make for real-time hiring alerts.
#### How to find a company's slug
The slug is the path segment in the company's careers URL:
- `boards.greenhouse.io/stripe` → `stripe`
- `jobs.lever.co/spotify` → `spotify`
- `jobs.ashbyhq.com/ramp` → `ramp`
- `bunq.recruitee.com` → `bunq`
- `jobs.smartrecruiters.com/Visa` → `Visa`
- `personio.jobs.personio.de` → `personio`
### Why use this scraper
- **Six ATS, one schema** — no per-ATS glue code on your side.
- **Public APIs, not HTML scraping** — doesn't break on careers-page redesigns,
and runs in seconds without a browser.
- **Enriched out of the box** — seniority, remote-type, descriptions, salary.
- **Change-detection** — track hiring movement, not just snapshots.
- **Pay only for results** — a run that finds nothing costs nothing.
### Pricing
This actor uses Apify's **pay-per-result** model: you're charged per job row
returned, nothing for companies that come back empty. The actor reads lightweight
JSON/XML, so runs are cheap and fast. Apify's free $5/month tier covers thousands
of jobs for testing. Tip: set `outputProfile` to `compact` or `minimal`, or use
`onlyNewSinceLastRun`, to keep scheduled runs lean.
### FAQ
**Do I need a proxy or API key?**
No. All six ATS expose public job-board endpoints that need no authentication.
**What output formats are available?**
JSON, JSONL, CSV, and Excel via the Apify dataset export, plus the Apify API.
**Can I run it on a schedule?**
Yes — use Apify Scheduler, and combine it with `onlyNewSinceLastRun` for a
new-jobs-only feed wired to a webhook.
**What if I don't know which ATS a company uses?**
Leave out the `ats` field. The actor probes each platform and uses whichever
responds — built-in ATS detection.
**What happens if a company's slug is wrong or it switches ATS?**
It's reported in the run summary's `failedTargets` and skipped — it never breaks
the run.
# Actor input Schema
## `companies` (type: `array`):
Companies to scrape. Each item is {"ats": "greenhouse|lever|ashby|recruitee|smartrecruiters|personio", "company": "slug"}. Omit "ats" to auto-detect (probes every ATS). The slug is what appears in the company's careers URL (e.g. boards.greenhouse.io/stripe -> "stripe"). Optional if you use presetLists.
## `presetLists` (type: `array`):
Curated, verified company bundles — run without researching slugs. Valid values: "top-tech", "ai-ml", "devtools", "fintech". Combine with companies; duplicates merged. Stale slugs are reported in failedTargets, never break the run.
## `titleKeyword` (type: `string`):
Keep only jobs whose title contains this substring (case-insensitive). Empty = no filter.
## `locationKeyword` (type: `string`):
Keep only jobs whose location contains this substring (case-insensitive). Empty = no filter.
## `remoteOnly` (type: `boolean`):
Keep only postings detected as fully remote.
## `maxJobsPerCompany` (type: `integer`):
Cap pushed jobs per company after filtering. Keeps trial runs cheap; raise or set 0 for unlimited. (Change detection still tracks all jobs for accurate diffs.)
## `includeDescriptions` (type: `boolean`):
Return full job description (plain text + HTML). Turn off for smaller, faster output when you only need metadata. For SmartRecruiters this adds one detail request per job.
## `onlyNewSinceLastRun` (type: `boolean`):
Diff mode: persists the set of seen jobs and on each subsequent run emits only NEW jobs (is\_new: true) plus CLOSED jobs that disappeared (is\_closed: true). Ideal for daily hiring-signal feeds. First run takes the snapshot.
## `outputProfile` (type: `string`):
full = all fields incl. HTML description. compact = drops description\_html. minimal = core fields only (ats, company, title, location, remote, seniority, url, posted\_at, global\_id).
## Actor input object example
```json
{
"companies": [
{
"ats": "greenhouse",
"company": "stripe"
},
{
"ats": "lever",
"company": "spotify"
},
{
"ats": "ashby",
"company": "ramp"
}
],
"presetLists": [],
"remoteOnly": false,
"maxJobsPerCompany": 50,
"includeDescriptions": true,
"onlyNewSinceLastRun": false,
"outputProfile": "full"
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"companies": [
{
"ats": "greenhouse",
"company": "stripe"
},
{
"ats": "lever",
"company": "spotify"
},
{
"ats": "ashby",
"company": "ramp"
}
],
"presetLists": []
};
// Run the Actor and wait for it to finish
const run = await client.actor("bovi/greenhouse-lever-ashby-job-scraper").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"companies": [
{
"ats": "greenhouse",
"company": "stripe",
},
{
"ats": "lever",
"company": "spotify",
},
{
"ats": "ashby",
"company": "ramp",
},
],
"presetLists": [],
}
# Run the Actor and wait for it to finish
run = client.actor("bovi/greenhouse-lever-ashby-job-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
{
"ats": "greenhouse",
"company": "stripe"
},
{
"ats": "lever",
"company": "spotify"
},
{
"ats": "ashby",
"company": "ramp"
}
],
"presetLists": []
}' |
apify call bovi/greenhouse-lever-ashby-job-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=bovi/greenhouse-lever-ashby-job-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Greenhouse, Lever & Ashby Job Scraper API",
"description": "Scrape job postings across 6 ATS — Greenhouse, Lever, Ashby, Recruitee, SmartRecruiters & Personio — into one unified schema. Descriptions, salary, seniority and remote-type included. Change-detection between runs, ATS auto-detect, curated company presets. No login, no browser, pure API.",
"version": "0.1",
"x-build-id": "vs30wAndDVt3g6eBQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/bovi~greenhouse-lever-ashby-job-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-bovi-greenhouse-lever-ashby-job-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/bovi~greenhouse-lever-ashby-job-scraper/runs": {
"post": {
"operationId": "runs-sync-bovi-greenhouse-lever-ashby-job-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/bovi~greenhouse-lever-ashby-job-scraper/run-sync": {
"post": {
"operationId": "run-sync-bovi-greenhouse-lever-ashby-job-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"companies": {
"title": "Companies",
"type": "array",
"description": "Companies to scrape. Each item is {\"ats\": \"greenhouse|lever|ashby|recruitee|smartrecruiters|personio\", \"company\": \"slug\"}. Omit \"ats\" to auto-detect (probes every ATS). The slug is what appears in the company's careers URL (e.g. boards.greenhouse.io/stripe -> \"stripe\"). Optional if you use presetLists."
},
"presetLists": {
"title": "Preset company lists",
"type": "array",
"description": "Curated, verified company bundles — run without researching slugs. Valid values: \"top-tech\", \"ai-ml\", \"devtools\", \"fintech\". Combine with companies; duplicates merged. Stale slugs are reported in failedTargets, never break the run."
},
"titleKeyword": {
"title": "Title keyword filter",
"type": "string",
"description": "Keep only jobs whose title contains this substring (case-insensitive). Empty = no filter."
},
"locationKeyword": {
"title": "Location keyword filter",
"type": "string",
"description": "Keep only jobs whose location contains this substring (case-insensitive). Empty = no filter."
},
"remoteOnly": {
"title": "Remote only",
"type": "boolean",
"description": "Keep only postings detected as fully remote.",
"default": false
},
"maxJobsPerCompany": {
"title": "Max jobs per company",
"minimum": 0,
"type": "integer",
"description": "Cap pushed jobs per company after filtering. Keeps trial runs cheap; raise or set 0 for unlimited. (Change detection still tracks all jobs for accurate diffs.)",
"default": 50
},
"includeDescriptions": {
"title": "Include job descriptions",
"type": "boolean",
"description": "Return full job description (plain text + HTML). Turn off for smaller, faster output when you only need metadata. For SmartRecruiters this adds one detail request per job.",
"default": true
},
"onlyNewSinceLastRun": {
"title": "Only new since last run (change detection)",
"type": "boolean",
"description": "Diff mode: persists the set of seen jobs and on each subsequent run emits only NEW jobs (is_new: true) plus CLOSED jobs that disappeared (is_closed: true). Ideal for daily hiring-signal feeds. First run takes the snapshot.",
"default": false
},
"outputProfile": {
"title": "Output profile",
"enum": [
"full",
"compact",
"minimal"
],
"type": "string",
"description": "full = all fields incl. HTML description. compact = drops description_html. minimal = core fields only (ats, company, title, location, remote, seniority, url, posted_at, global_id).",
"default": "full"
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```