# ATS Jobs Scraper: Greenhouse, Lever, Ashby & SmartRecruiters (`crawlgrid/ats-jobs-scraper`) Actor

Fast API-first job scraper across Greenhouse, Lever, Ashby, and SmartRecruiters with 681 pre-indexed boards, structured salary extraction, remote/LATAM filters, and incremental monitoring.

- **URL**: https://apify.com/crawlgrid/ats-jobs-scraper.md
- **Developed by:** [CrawlGrid Labs](https://apify.com/crawlgrid) (community)
- **Features:** Limited permissions
- **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 scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Multi-ATS Jobs Scraper: Greenhouse, Lever, Ashby & SmartRecruiters

Fast, lightweight, API-first career site job scraper that extracts structured, normalized open roles across **Greenhouse**, **Lever (US & EU)**, **Ashby**, and **SmartRecruiters** directly from official JSON endpoints — with **$0 proxy cost**, structured salary extraction, LATAM/US/EU/Remote filtering, Apify Dataset chaining, and incremental monitoring.

***

### Key Capabilities

- **Zero-Config Global Search (681 Live Boards / 39,280+ Active Roles Indexed):** Leave target fields empty to immediately query a live-verified curated index covering **Ashby (443 boards)**, **Greenhouse (173 boards)**, **Lever (58 boards)**, and **SmartRecruiters (7 enterprise boards)** across global tech, AI, fintech, SaaS, and enterprise employers (including Latin America tech leaders such as VTEX, Stone, Nubank, QuintoAndar, Despegar, EBANX, Clara, Addi, and Simetrik).
- **Direct Company Lookup, ATS URLs & Dataset Chaining:**
  - Pass company names, domains, or slugs (`"stripe"`, `"openai.com"`, `"vtex"`, `"BoschGroup"`).
  - Pass direct ATS career board URLs (`boards.greenhouse.io/...`, `job-boards.eu.greenhouse.io/...`, `jobs.lever.co/...`, `jobs.eu.lever.co/...`, `jobs.ashbyhq.com/...`, `jobs.smartrecruiters.com/...`).
  - Chain any upstream Apify Dataset ID (`datasetId`) directly from **CrawlGrid B2B & E-commerce Website Enricher** (`crawlgrid/b2b-website-enricher`), reading `atsLinks`, `atsUrl`, `domain`, and `companyName` automatically.
- **Unified Normalized Schema:** All 4 ATS providers normalize into one consistent record structure (`jobId`, `title`, `companyName`, `ats`, `workplaceType`, `isRemote`, `location`, `locations`, `country`, `department`, `seniority`, `employmentType`, `postedAt`, `salaryText`, `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod`, `salaryAnnualMinUsdEstimate`, `hasSalary`, `url`, `applyUrl`, `description`).
- **Smart Salary & Compensation Extraction:** Reads native structured compensation blocks (Ashby & Lever) and filters false positives like startup funding rounds or ARR metrics when parsing Greenhouse & SmartRecruiters descriptions.
- **Regional Alias Expansion:** Filter `locations` using shortcuts like `LATAM`, `Latin America`, `Europe`, `EMEA`, `US`, `UK`, or `APAC`, as well as specific cities or countries (`Brazil`, `São Paulo`, `Mexico`, `Bogotá`, `Argentina`, `London`, `Berlin`).
- **Incremental Job Monitoring:** Enable `onlyNewSinceLastRun` with an optional `stateKey` to deduplicate across scheduled runs using persistent Key-Value Store (`ats-jobs-state`), emitting only net-new postings.

***

### Example Inputs

#### 1. Global Search for Remote Engineering Roles with Salary

```json
{
  "keywords": ["software engineer", "backend", "ai engineer"],
  "excludeKeywords": ["intern", "internship"],
  "remoteOnly": true,
  "onlyWithSalary": true,
  "minAnnualSalary": 120000,
  "maxItems": 100
}
```

#### 2. Target Specific Companies Across All 4 ATS Platforms

```json
{
  "companies": ["stripe", "openai", "palantir", "vtex", "BoschGroup"],
  "keywords": ["engineer", "data"],
  "maxItems": 200
}
```

#### 3. LATAM Tech Hiring Monitor (Scheduled Weekly/Daily)

```json
{
  "locations": ["LATAM"],
  "keywords": ["engineer", "product", "data"],
  "postedWithinDays": 14,
  "onlyNewSinceLastRun": true,
  "stateKey": "latam-tech-daily",
  "maxItems": 250
}
```

#### 4. Chain Output from B2B Website Enricher

```json
{
  "datasetId": "YOUR_ENRICHER_DATASET_ID",
  "keywords": ["sales", "marketing", "growth"],
  "includeDescription": true,
  "maxItems": 500
}
```

***

### Example Output Record

```json
{
  "jobId": "ashby:openai:example-id",
  "externalId": "example-id",
  "ats": "ashby",
  "companySlug": "openai",
  "companyName": "OpenAI",
  "companyDomain": "openai.com",
  "companyIndustry": "AI",
  "title": "Senior Software Engineer, Platform",
  "url": "https://jobs.ashbyhq.com/openai/example-id",
  "applyUrl": "https://jobs.ashbyhq.com/openai/example-id/application",
  "location": "San Francisco",
  "locations": ["San Francisco", "New York"],
  "country": "United States",
  "isRemote": false,
  "workplaceType": "onsite",
  "department": "Engineering",
  "team": "Core Infrastructure",
  "employmentType": "full-time",
  "seniority": "senior",
  "postedAt": "2026-11-15T18:00:00.000Z",
  "updatedAt": null,
  "salaryText": "$207K - $285K",
  "salaryMin": 207000,
  "salaryMax": 285000,
  "salaryCurrency": "USD",
  "salaryPeriod": "year",
  "salaryAnnualMinUsdEstimate": 207000,
  "salaryAnnualMaxUsdEstimate": 285000,
  "hasSalary": true,
  "description": "Clean plain-text job description...",
  "scrapedAt": "2026-11-18T23:50:00.000Z"
}
```

***

### Pricing & Resource Usage

- **Proxy Usage:** None required (`$0` proxy costs).
- **Memory & Speed:** Runs fast in `512 MB – 1024 MB` using native concurrent API requests directly to ATS JSON endpoints.
- **Pay-Per-Event:** Charges only per normalized job record emitted (`job-scraped`), strictly respecting `maxItems` and your run budget (`maxTotalChargeUsd`). Failed lookups, filtered-out postings, and already-seen jobs in incremental runs are never charged.

# Actor input Schema

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

Optional list of company names, domains, or ATS board slugs (e.g., "Stripe", "openai.com", "vtex", "BoschGroup"). Leave all target fields empty to run Global Search across 681 pre-indexed boards.

## `atsUrls` (type: `array`):

Direct career board URLs from Greenhouse, Lever, Ashby, or SmartRecruiters (e.g., "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/palantir", "https://jobs.ashbyhq.com/openai").

## `datasetId` (type: `string`):

Optional Apify Dataset ID to chain from another Actor such as CrawlGrid's B2B & E-commerce Website Enricher (reads atsLinks, atsUrl, url, domain, and company fields automatically).

## `atsPlatforms` (type: `array`):

Restrict scraping to specific ATS providers. Leave empty to include all four supported platforms (Greenhouse, Lever, Ashby, SmartRecruiters).

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

Include jobs matching at least one keyword in title, department, team, location, or description.

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

Skip jobs containing any of these terms in title, department, employment type, or description.

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

Filter by cities, countries, or regional aliases (supports "LATAM", "Europe", "EMEA", "US", "UK", "APAC", plus country/city names like "Brazil", "Mexico", "Colombia", "San Francisco", "London").

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

Keep only jobs explicitly marked or detected as remote.

## `workplaceTypes` (type: `array`):

Filter by normalized workplace mode (leave empty for any).

## `departments` (type: `array`):

Match department or team substrings (e.g., "Engineering", "Product", "Sales", "Data").

## `employmentTypes` (type: `array`):

Match normalized employment types (e.g., "full-time", "part-time", "contract", "internship").

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

Only return postings published or updated within the last N days.

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

Keep only postings that disclose a compensation range or base salary.

## `minAnnualSalary` (type: `integer`):

Keep only postings whose parsed annual compensation estimate meets or exceeds this USD value.

## `maxItems` (type: `integer`):

Maximum number of matching job records to output. In Pay-Per-Event pricing, this also caps billed job-scraped events. Set 0 for unlimited.

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

Include clean plain-text job description in each record. Disabling makes SmartRecruiters boards faster.

## `onlyNewSinceLastRun` (type: `boolean`):

Skip jobs already emitted in previous runs sharing the same stateKey (stored in Key-Value Store "ats-jobs-state"). Ideal for scheduled job monitors.

## `stateKey` (type: `string`):

Named key inside Key-Value Store "ats-jobs-state" to isolate seen-job history across separate saved searches or schedules.

## `maxCompanies` (type: `integer`):

Optional limit on how many curated boards Global Search will inspect before stopping.

## `maxConcurrency` (type: `integer`):

Concurrent ATS API board fetches (1 to 40).

## Actor input object example

```json
{
  "companies": [
    "stripe",
    "openai",
    "vtex",
    "BoschGroup"
  ],
  "atsUrls": [
    "https://boards.greenhouse.io/stripe",
    "https://jobs.ashbyhq.com/openai"
  ],
  "keywords": [
    "software engineer",
    "backend",
    "ai"
  ],
  "excludeKeywords": [
    "intern",
    "internship",
    "staff"
  ],
  "locations": [
    "LATAM",
    "Remote"
  ],
  "remoteOnly": false,
  "onlyWithSalary": false,
  "maxItems": 50,
  "includeDescription": true,
  "onlyNewSinceLastRun": false,
  "stateKey": "default",
  "maxConcurrency": 25
}
```

# Actor output Schema

## `results` (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 = {
    "keywords": [
        "engineer"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlgrid/ats-jobs-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["engineer"] }

# Run the Actor and wait for it to finish
run = client.actor("crawlgrid/ats-jobs-scraper").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 '{
  "keywords": [
    "engineer"
  ]
}' |
apify call crawlgrid/ats-jobs-scraper --silent --output-dataset

```

## MCP server setup

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

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/8TlFqcHPfxbNtYOut/builds/PP8xdU3KUXpMiyIhB/openapi.json
