# Greenhouse Jobs API: Job Board Scraper & Daily Feed (`deftcell/greenhouse-jobs-api`) Actor

Get every public job from Greenhouse job boards as clean JSON: locations, remote flag, pay ranges, departments, dates, apply links, and plain-text descriptions. Give board names, board URLs, careers pages, or domains. Incremental mode returns only new jobs for daily feeds.

- **URL**: https://apify.com/deftcell/greenhouse-jobs-api.md
- **Developed by:** [Ervin Amaya](https://apify.com/deftcell) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 1,000 job delivereds

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

## Greenhouse Jobs API: Job Board Scraper & Daily Feed

Get **every public job posting from any Greenhouse job board** as clean, structured JSON: title, department, office locations, remote flag, **pay ranges**, employment type, dates, apply link, and a plain-text description.

Give it board names (`figma`), board URLs, careers pages, or bare domains. Turn on **incremental mode** and each scheduled run returns only jobs you haven't received yet: a ready-made daily Greenhouse job feed for job boards, recruiting tools, sales signals, market research, and AI agents.

**Built and maintained by an AI agent operated by Elite Tech Global LLC (Deftcell).** Issues are monitored and answered by the same AI-assisted team.

> Need Lever, Ashby, or Workable too? [ATS Jobs API](https://apify.com/deftcell/ats-jobs-api) reads all four in one run with the same output schema. This edition is the same engine, focused on Greenhouse.

### What it does

- **Reads Greenhouse's public Job Board API**, the one companies use to publish openings on their own careers sites. No login, no API key, no browser.
- **Pay ranges, parsed carefully.** Greenhouse pay-transparency ranges come first. If a posting has none, a salary *range* is taken from the description only when it is clearly stated next to words like "salary", "base", or "pay". Every salary says where it came from (`salarySource`) and the wording it was read from (`salaryText`).
- **Remote and workplace flags.** `workplaceType` is `remote`, `hybrid`, `onsite`, or `null` when unknown; `isRemote` is `true` for fully remote jobs and jobs with a remote option.
- **Board finder.** Pass `https://example.com/careers` or `example.com` and the Actor finds the company's Greenhouse board from that one page, including script embeds.
- **Filters:** keywords, locations, remote only, "posted within N days", and a per-company cap. Filtered-out jobs are not charged.
- **Incremental mode** for daily feeds, with one memory per `feedName`.
- **Polite and reliable:** at most 5 requests in flight, robots.txt (including Crawl-delay) honoured, retries with backoff on 429/5xx, timeouts on every request.

### Input examples

**Board names (the simplest input):**

```json
{ "companies": ["figma", "airbnb", "gitlab"] }
```

**URLs, careers pages, and domains:**

```json
{
  "companies": [
    "https://job-boards.greenhouse.io/figma",
    "https://boards.greenhouse.io/embed/job_board?for=airbnb",
    "https://www.example.com/careers"
  ],
  "maxJobsPerCompany": 100
}
```

**Remote engineering jobs from the last two weeks:**

```json
{
  "companies": ["gitlab", "figma", "airbnb"],
  "keywords": ["engineer", "developer"],
  "remoteOnly": true,
  "postedWithinDays": 14
}
```

**Daily feed of new jobs only (pair it with an Apify schedule):**

```json
{
  "companies": ["figma", "airbnb", "gitlab"],
  "incremental": true,
  "feedName": "daily-greenhouse-feed"
}
```

#### Input fields

| Field | Type | Default | Description |
|---|---|---|---|
| `companies` | array (required) | – | Greenhouse board names, board or embed URLs, careers-page URLs, domains, or `{ "ats": "greenhouse", "token", "companyName" }` objects. Up to 10,000 per run. |
| `keywords` | string\[] | `[]` | Keep jobs whose title, department, or team contains any keyword. Whole words, case-insensitive; `engineer` also matches "Engineering". |
| `keywordsInDescription` | boolean | `false` | Also search the description text. |
| `locations` | string\[] | `[]` | Keep jobs matching any location: city, region, country, or `Remote`. `US`/`USA`/`United States` are treated as the same place. |
| `remoteOnly` | boolean | `false` | Keep only jobs with `isRemote: true`. |
| `postedWithinDays` | integer | none | Keep jobs whose `postedAt` (or `updatedAt`) is within this many days. |
| `maxJobsPerCompany` | integer | none | Deliver at most this many jobs per company, newest first. |
| `includeDescriptionHtml` | boolean | `false` | Add the original description HTML (`descriptionHtml`). Plain text is always included. |
| `incremental` | boolean | `false` | Deliver only jobs not delivered by earlier runs with the same `feedName`. |
| `feedName` | string | `"default"` | Name of the feed whose memory is used. |

### Output

One dataset item per job, in the same schema as [ATS Jobs API](https://apify.com/deftcell/ats-jobs-api). A real posting, description shortened:

```json
{
  "id": "aa161e4d60aa2b4566e3a2bd",
  "ats": "greenhouse",
  "companyToken": "figma",
  "companyName": "Figma",
  "atsJobId": "6211910004",
  "title": "Technical Program Manager, AI Tooling",
  "department": "Business Operations",
  "team": null,
  "employmentType": null,
  "employmentTypeRaw": null,
  "locations": ["San Francisco, CA", "New York, NY", "United States"],
  "isRemote": false,
  "workplaceType": null,
  "salaryMin": 169000,
  "salaryMax": 245000,
  "salaryCurrency": "USD",
  "salaryPeriod": "YEAR",
  "salarySource": "ats",
  "salaryText": "Annual Base Salary Range: 169,000–245,000 USD",
  "postedAt": "2026-10-02T14:59:12.000Z",
  "updatedAt": "2026-10-02T14:59:12.000Z",
  "applyUrl": "https://boards.greenhouse.io/figma/jobs/6211910004?gh_jid=6211910004",
  "jobUrl": "https://boards.greenhouse.io/figma/jobs/6211910004?gh_jid=6211910004",
  "descriptionText": "Figma is growing our team of passionate creatives and builders on a mission to make design accessible to all. Figma’s platform helps teams bring ideas …",
  "companyInput": "figma",
  "scrapedAt": "2026-10-05T01:33:44.858Z"
}
```

- `id` is stable across runs (a hash of ATS + board + job ID), so you can de-duplicate or upsert on it.
- `companyName` comes from Greenhouse's board metadata. Greenhouse has no team field, so `team` is `null`; `employmentType` and `workplaceType` are filled only when the posting states them.
- When a posting lists several pay zones in one currency, the range spans all of them, and the zones are listed in `salaryText`.
- `applyUrl` and `jobUrl` are the same Greenhouse link.
- Personal e-mail addresses in descriptions are replaced with `[email removed]`.

The dataset's **Overview** tab shows company, title, locations, workplace, type, salary, posted date, and job link. Export as JSON, CSV, Excel, or through the API.

Each run also saves `RUN_SUMMARY` in its key-value store: one record per input with its `status` (`ok`, `no_jobs`, `no_matching_jobs`, `no_new_jobs`, `duplicate`, `board_not_found`, `not_detected`, `robots_disallowed`, `unsupported_ats`, `invalid_input`, `error`, and the charge-limit statuses), the board it resolved to, and job counts.

### Incremental mode for daily feeds

1. Set `incremental: true` and pick a `feedName`, such as `"daily-feed"`.
2. Create an [Apify schedule](https://docs.apify.com/platform/schedules) that runs the Actor (or a saved task) every day.
3. The **first run delivers every matching job.** Later runs deliver only jobs no earlier run with the same `feedName` delivered.

Delivered job IDs are stored per board in a named key-value store in your Apify account (`ats-jobs-api-incremental`, shared with ATS Jobs API, so one feed name means one memory across both Actors). A job counts as seen only once it is actually delivered. IDs of removed jobs are forgotten after 180 days. Don't run two incremental runs with the same `feedName` at the same time. To start a feed over, use a new `feedName`.

### Pricing

Pay per event: **about $0.0015 per job delivered** (1,000 jobs ≈ $1.50), plus Apify's small automatic start event per run. Final prices are on the Actor's pricing tab. Jobs removed by filters, jobs already delivered in incremental mode, boards on other ATSs, and companies that fail are never charged. Set a **maximum charge per run** to cap spend.

### For AI agents and MCP clients

- **Smallest useful input:** `{"companies": ["figma"], "maxJobsPerCompany": 20}`.
- **API:** `POST https://api.apify.com/v2/actors/deftcell~greenhouse-jobs-api/run-sync-get-dataset-items?token=<APIFY_TOKEN>&maxTotalChargeUsd=1` with the input JSON as the body.
- **MCP:** add `https://mcp.apify.com?tools=deftcell/greenhouse-jobs-api` to your MCP client ([Apify MCP docs](https://docs.apify.com/integrations/mcp)).

### FAQ

**Why did a company return no jobs?** Check `RUN_SUMMARY`. `not_detected`: no Greenhouse board was found from the page you gave; pass the board name or URL. `board_not_found`: Greenhouse has no public board with that name. `unsupported_ats`: the company uses another ATS; use [ATS Jobs API](https://apify.com/deftcell/ats-jobs-api).

**How do I find a company's board name?** Open one of its job posts. The board name is the part after `boards.greenhouse.io/` or `job-boards.greenhouse.io/`. Or just pass the careers page.

**Can it scrape LinkedIn, Indeed, or arbitrary sites?** No. It reads only Greenhouse's public Job Board API, plus the single careers page you give it for detection.

### Data source and compliance

- Jobs come only from Greenhouse's **public [Job Board API](https://developers.greenhouse.io/job-board.html)**, which companies use to publish openings. No data is taken from behind a login.
- The output contains **job postings, not people.** Recruiter and contact fields are never output, and personal e-mail addresses are removed. Role mailboxes such as `careers@` stay.
- **robots.txt is respected** for every host, including Crawl-delay. Requests are rate-limited and identified by the user agent `DeftcellJobsAPI/1.0 (+https://apify.com/deftcell)`.
- You are responsible for how you use the data, including the hiring companies' terms and applicable privacy law.
- Not affiliated with or endorsed by Greenhouse Software, Inc. The name only describes where the data comes from.

### Support

Open an issue on the **Issues** tab with your run ID and what you expected. **Built and maintained by an AI agent operated by Elite Tech Global LLC (Deftcell).**

# Actor input Schema

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

One entry per company. Accepted forms:

- Board name: "figma" (the part after boards.greenhouse.io/)
- Board URL: https://job-boards.greenhouse.io/figma, https://boards.greenhouse.io/airbnb, or an embed URL (...embed/job\_board?for=gitlab)
- Careers page or domain: https://example.com/careers or example.com (the Actor fetches that one page, respecting robots.txt, and looks for a Greenhouse link or embed)
- Object: {"ats": "greenhouse", "token": "figma", "companyName": "Figma"}
  Boards on other ATSs are reported in RUN\_SUMMARY and never charged; use deftcell/ats-jobs-api for Lever, Ashby, and Workable.

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

Keep jobs whose title, department, or team contains any of these words or phrases (case-insensitive, whole words; "engineer" also matches "Engineering"). Leave empty to keep all jobs.

## `keywordsInDescription` (type: `boolean`):

When on, keywords also match the job description text (useful for skills such as "Kubernetes").

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

Keep jobs whose location matches any entry, for example "London", "United States", "Germany", or "Remote". "US" and "UK" also match their full names, and US jobs listed as "City, ST" count as United States.

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

Keep only jobs the ATS or the posting marks as remote.

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

Keep only jobs first published within this many days (uses the posting date from the ATS). Leave empty for no limit.

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

Deliver at most this many jobs per company, newest first. Leave empty for all jobs.

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

Add the original description HTML in `descriptionHtml`. Plain text (`descriptionText`) is always included.

## `incremental` (type: `boolean`):

When on, each run delivers only jobs that earlier runs with the same feed name have not delivered yet. The first run delivers everything that matches. Ideal for scheduled daily feeds.

## `feedName` (type: `string`):

Name of the feed whose memory to use, such as `daily-design-jobs`. Use a different name for each separate feed or schedule. Leave empty to use the feed named `default`. (Formerly `incrementalKey`, which still works.)

## Actor input object example

```json
{
  "companies": [
    "figma",
    "https://boards.greenhouse.io/airbnb",
    {
      "ats": "greenhouse",
      "token": "gitlab",
      "companyName": "GitLab"
    }
  ],
  "keywordsInDescription": false,
  "remoteOnly": false,
  "maxJobsPerCompany": 50,
  "includeDescriptionHtml": false,
  "incremental": false
}
```

# Actor output Schema

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

Normalized job postings (one item per job) in the default dataset.

## `runSummary` (type: `string`):

Per-company status, detection method and job counts (RUN\_SUMMARY record).

# 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": [
        "figma",
        "airbnb",
        "https://job-boards.greenhouse.io/gitlab"
    ],
    "maxJobsPerCompany": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("deftcell/greenhouse-jobs-api").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": [
        "figma",
        "airbnb",
        "https://job-boards.greenhouse.io/gitlab",
    ],
    "maxJobsPerCompany": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("deftcell/greenhouse-jobs-api").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": [
    "figma",
    "airbnb",
    "https://job-boards.greenhouse.io/gitlab"
  ],
  "maxJobsPerCompany": 50
}' |
apify call deftcell/greenhouse-jobs-api --silent --output-dataset

```

## MCP server setup

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

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/WNTfohM6fxErdecnI/builds/rj32vXGIZiJmpDcBT/openapi.json