# Greenhouse Jobs Scraper & API: Every Open Job, No Login (`conserving_celerytop/greenhouse-jobs-api`) Actor

Greenhouse jobs scraper and API: every open job on the Greenhouse boards of the companies you name, read live. Title, department, location, pay ranges and apply link. $0.10 per company, up to 1,000 jobs, descriptions free. No API key or login. Schedule it for new-job alerts.

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

## Pricing

from $70.00 / 1,000 company lookups

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 Scraper & API** gets every open job on the **Greenhouse job boards** of the companies you name, read live during your run: title, department, location, remote, **pay ranges** when published, posted date and apply link. Paste board links, company names or websites. You pay **$0.10 per company**, with up to 1,000 jobs included, and there is no API key or login.

You pay **$0.10 per company**, including up to 1,000 jobs ($0.09 on the Scale plan, $0.07 on Business). Per job, that is $2 per 1,000 jobs for a company with 50 open jobs, $0.50 for one with 200, and $0.10 for one with 1,000. No API key, proxy or login. It does not search all Greenhouse jobs by keyword: you bring the list of companies.

### What the Greenhouse jobs scraper returns

- **Pay ranges.** `salaryRanges` lists every range the company adds to a job, such as one per pay zone. `salaryMin`, `salaryMax`, `salaryCurrency` and `salaryPeriod` hold the range in the currency of the job's country, else the first. With **Include job description**, pay written in the text fills the salary when a job has none (`salarySource` is `text`, else `board`).
- **Nested departments.** `departmentPath` gives the full path and `department` the last level. Greenhouse has no team field.
- **Company fields.** `requisitionId`, `applicationDeadline` when set, and `updatedAt`, the job's last change.
- **Language.** Greenhouse gives each job's `language`, so that filter works without descriptions.
- **Own-site links.** When a company shows its jobs on its own site, `url` and `applyUrl` point there, and `companyDomain` is its domain, such as `dropbox.com`.
- **Job type and remote.** `employmentType` comes from the Employment Type and Time Type fields. A location that says "Remote" or "Hybrid" sets `remote` and `workplaceType`; on-site jobs stay null.

### How to scrape Greenhouse jobs, step by step

1. In **Companies** (`companies`), paste Greenhouse board links, company names or websites, up to 500. A job link reads the whole board. Or pick a list in **Ready-made company lists** (`companyLists`), such as `tech-companies` (204 on Greenhouse).
2. Set filters if you need them, such as **Title includes**, **Location** or **Posted since**, and turn on **Include job description** for the full text.
3. Run it. Each company costs $0.10, with up to 1,000 jobs included, also when the name is not on Greenhouse. Descriptions are free.
4. Open the **Jobs** view of the results. Set **Rows to return** (`outputMode`) to `companies` for one summary row per company instead.
5. To repeat it, save the input as a task and schedule it, as in [Get only new and closed Greenhouse jobs on a schedule](#get-only-new-and-closed-greenhouse-jobs-on-a-schedule).

### How to find a company's Greenhouse board link

If a job's address on the company's careers page starts with `boards.greenhouse.io/<name>` or `job-boards.greenhouse.io/<name>`, paste it: a job link reads the whole board. Embed links work too. EU boards (`job-boards.eu.greenhouse.io`) are not supported yet. If the job opens on the company's own site with `gh_jid=` in the address, paste the website instead. Or type the name, such as `discord`.

A plain name can belong to another company. `companyName` is the name Greenhouse gives, and `warning` says when it differs from yours. `matchedBy` says how the board was found, and `companySlug` is its name.

### Fields on every job

`jobId`, `jobKey` (the same in every run), `locations`, `countryCodes`, `country`, `city` and `region` from the location text, `seniority` and `jobFunction` from the title, `employmentTypeNormalized` (such as `full_time`), `postedAt`, and `salaryAnnualMin` and `salaryAnnualMax` (pay per year). With **Include job description**: `description` without email addresses, phone numbers or profile links, the `tools` it names, `experienceYearsMin`, `experienceYearsMax`, `experienceLevel`, `educationMin`, `educationRequired`, `visaSponsorship`, `visaSponsorshipText` and `securityClearance`. Rows also have the city's `latitude`, `longitude` and `timeZone`, `remoteRegions`, and `ukVisaSponsor` with `ukSponsorRoutes`.

### Filters

Filters lower the price only above 1,000 jobs.

- **Words and places:** `titleIncludes` and `titleExcludes` (whole words), `department`, `location` (a country name or code, else whole words), `locationExcludes`, `remoteOnly`, `remoteRegions` (where remote work may be done), and `near` with `radiusKm` (distance from one city).
- **Values:** `workplaceTypes`, `employmentTypes`, `seniorities`, `jobFunctions` and `languages`. On Greenhouse, many jobs lack a workplace or job type, so those filters drop many.
- **Pay and dates:** `hasSalary`, `minAnnualSalary` in `minAnnualSalaryCurrency` (no exchange rates), `postedSince` and `postedBefore` (a date or a period such as `7 days`).
- **From the description:** `descriptionIncludes`, `skills` (sets `matchedSkills`), `maxExperienceYears` and `visaSponsorship` turn on `includeDescription` and its price. `descriptionFormat` picks `text`, `html` or `markdown`.
- **Size:** `maxJobsPerCompany` keeps the newest jobs.

A job without the value a filter needs is left out, and `warning` counts them. `startUrls` and `urls` are other names for `companies`. `excludeCompanies` leaves companies out. `ukVisaSponsorOnly` keeps companies on the UK visa sponsor register. `companyLists` adds ready-made lists of companies, such as `tech-companies` (204 on Greenhouse). Rows of list companies also end with their industry, headquarters country and size, in `companyIndustry`, `companyCountry` and `companySizeBand`, when known.

### How much does the Greenhouse jobs API cost?

| Event | Price | What you get |
|---|---|---|
| Company lookup (`company-lookup`) | $0.10 (Scale $0.09, Business $0.07) | One company's job list, up to 1,000 jobs, including the first check with **Only new jobs** |
| Extra 1,000 jobs (`extra-1000-jobs`) | $0.045 (see the Store page) | Each further 1,000 job rows of the same company, or part of them |
| New jobs check (`new-jobs-check`) | $0.002 | A later check with **Only new jobs**, per started 1,000 open jobs on the board |

So 100 companies cost $10 ($7 on the Business plan). A daily **Only new jobs** check of them then costs $0.20.

A website that links no job board, and whose name is not on Greenhouse, costs the company price. A company over your spending limit is neither delivered nor charged.

### Get only new and closed Greenhouse jobs on a schedule

Turn on **Only new jobs since my last check** (`onlyNewJobs`), save the input as a task, and schedule it. The first check of a company returns its full list for the company price. Later checks return new and closed jobs, with `change` set to `new` or `closed` and an alert line (`alertText`), for $0.002 per started 1,000 open jobs on the board.

**Alert webhook URL** (`alertWebhookUrl`) posts to Slack, Discord, Teams, Make, Zapier or n8n after a check with changes, not on quiet days (`alertMaxJobs`, `alertOnFirstCheck`).

Rows have `firstSeenAt`, closed rows `closedAt` and `daysOpen`. `reposted` marks a new job matching one closed within 30 days; `skipReposts` leaves those out, counted in `skippedRepostsCount` and `skippedReposts`. With `includeUpdatedJobs`, changed jobs come back as `updated`, with `changedFields` and `previous` values.

Each `monitorName` and filter set keeps its own memory in your Apify account.

### For AI agents

Use it to answer "is company X hiring for Y right now?" for companies on Greenhouse. Input (only `companies` is required, up to 500):

`{"companies": ["https://boards.greenhouse.io/dropbox", "duolingo"], "jobFunctions": ["engineering"], "postedSince": "7 days", "maxJobsPerCompany": 50}`

Output, one row per job: `company`, `companyStatus`, `title`, `departmentPath`, `location`, `countryCode`, `remote`, `jobFunction`, `salaryMin`, `salaryMax`, `salaryCurrency`, `postedAt`, `url` and more, plus `description` with `includeDescription`. A company without jobs gets a status row.

Price: $0.10 per company with up to 1,000 jobs, also when the name is not on Greenhouse. Descriptions are free. More in [How much does the Greenhouse jobs API cost?](#how-much-does-the-greenhouse-jobs-api-cost).

Many companies, or companies on different job boards? [ATS Jobs API](https://apify.com/conserving_celerytop/live-career-page-jobs-api) reads Greenhouse and 21 other job boards in one run for $0.045 per company.

### Output

A job row from a real run, shortened. Unknown values are `null`.

```json
{
  "rowType": "job",
  "company": "https://boards.greenhouse.io/dropbox",
  "ats": "greenhouse",
  "companyName": "Dropbox",
  "companyStatus": "ok",
  "charged": true,
  "requisitionId": "R11708",
  "title": "Product Manager",
  "departmentPath": "EPD > Product Team > Prod - DocSend (Sub Team)",
  "location": "Remote - Canada: Select locations",
  "countryCode": "CA",
  "employmentType": "Regular, Full Time",
  "salaryMin": 157300,
  "salaryMax": 212700,
  "salaryCurrency": "CAD",
  "postedAt": "2026-09-23T19:29:14.000Z",
  "url": "https://jobs.dropbox.com/listing/8220578?gh_jid=8220578"
}
```

Set **Rows to return** (`outputMode`) to `companies` for one summary row per company, or `both`. `rowType` is `job`, `company` or `status`. Summary rows have `boardUrl`, `openJobs`, `jobsPostedLast7Days`, `jobsPostedLast30Days`, `jobsOpenOver90Days`, `newestPostedAt`, `oldestPostedAt`, `remoteJobs`, `remoteShare`, `engineeringShare`, `salesShare`, `salaryCoverage`, `salaryMedians`, `medianSalaryMin`, `medianSalaryMax`, `medianSalaryCurrency`, `medianSalaryPeriod`, `topDepartments`, `topLocations`, `countries`, `seniorityCounts`, `functionCounts`, `functionCountsLast30Days`, `leadershipRoles` and `firstHireRoles`. Descriptions add `topTools`, `toolCoverage`, `visaSponsorshipShare` and `medianExperienceYearsMin`. **Only new jobs** adds `newJobs`, `closedJobs`, `updatedJobs`, `repostedJobs`, `medianDaysOpen`, `newFunctions`, `newCountries` and `previousCheckAt`.

The `COMPANIES` record has each company's status, with `inputDomain`, `careerPageSource`, `fetchedAt`, `error`, `chargedEvent`, `chargedEventCount`, `extraJobBlocksCharged`, `upstreamCalls`, `companyTotalOpenJobs`, `companyMatchedJobs`, `companyJobsReturned`, `companyJobsWithoutDate`, `newJobsCount`, `closedJobsCount`, `updatedJobsCount` and `firstCheck`.

### Statuses and charges

| `companyStatus` | Meaning | Charged |
|---|---|---|
| `ok`, `no_matching_jobs`, `no_open_jobs` | The board was read | Yes |
| `not_found` | Greenhouse has no board by this name | Yes |
| `source_error` | Greenhouse failed or did not answer | Yes |
| `no_job_board_found` | The website links no job board, and its name is not on Greenhouse | Yes |
| `unsupported_job_board` | Another job board, linked or found on the website, or an EU board. `error` says why | No |
| `website_unavailable` | We could not read the website, and its name is not on Greenhouse | No |
| `invalid_input`, `duplicate` | Not a link, website or name, or the same board as another entry | No |
| `skipped_time_limit`, `skipped_spending_limit` | Out of time, or over your spending limit | No |
| `skipped_client_disconnected` | Only in Live Jobs HTTP API. Your client disconnected first | No |
| `internal_error` | Something failed on our side | Only if it happened after we read the board |

### Other job boards: ATS Jobs API and more

This Actor reads only Greenhouse. The same list of companies works in our other job Actors:

- [ATS Jobs API](https://apify.com/conserving_celerytop/live-career-page-jobs-api): 22 job boards in one run, when you do not know which board a company uses.
- [Lever Jobs Scraper & API](https://apify.com/conserving_celerytop/lever-jobs-api)
- [Ashby Jobs Scraper & API](https://apify.com/conserving_celerytop/ashby-jobs-api)
- [Workday Jobs Scraper & API](https://apify.com/conserving_celerytop/workday-jobs-api)
- [Tech Jobs Search](https://apify.com/conserving_celerytop/tech-jobs-search): search the open jobs of 824 companies by keyword, place and salary.
- [Live Jobs HTTP API](https://apify.com/conserving_celerytop/live-jobs-http-api): the same job data in one HTTP request, for scripts, Clay and no-code tools.
- [Website Tech Stack Detector](https://apify.com/conserving_celerytop/website-tech-stack-detector): the CMS, analytics and other tools on the same companies' websites.

### FAQ

**Is this an official Greenhouse API?** No. It reads the public Greenhouse job board API, with no login. It is not affiliated with or endorsed by Greenhouse, whose name is a trademark of its owner.

**Why did a name return `not_found`?** Board names often differ from brand names. Paste a job's link or the company's website.

Found a problem? Open an issue under **Issues**.

**Related Actors.** [Live Jobs HTTP API](https://apify.com/conserving_celerytop/live-jobs-http-api) returns jobs in one HTTP response, at its own prices plus platform usage. [Tech Jobs Search](https://apify.com/conserving_celerytop/tech-jobs-search) searches the open jobs of 824 companies by keyword.

# Actor input Schema

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

Greenhouse board links, company names or websites, up to 500. Links like boards.greenhouse.io/dropbox. A plain name (discord) is looked up on Greenhouse. A website is searched for its Greenhouse board. $0.10 per company, 1,000 jobs included, also when it is not found. Another board's link is free and not read. For other job boards, use the Actor "ATS Jobs API: Greenhouse, Lever & Ashby Jobs, No Login", which reads 22 job boards.

## `companyLists` (type: `array`):

Run on ready-made lists of companies instead of, or next to, your own list in Companies. Each company in a list is one company lookup ($0.10, 1,000 jobs included), and filters such as title, location and posted date apply as usual. To run only the lists, clear Companies. A company in two lists, or in a list and in Companies, is read and charged once. At most 500 companies per run in all. The lists are refreshed monthly. API value: a list such as \["ai-companies"].

## `excludeCompanies` (type: `array`):

Companies to leave out, such as your own employer or companies you already track: company names, websites or job board links, up to 1,000. Most useful with Ready-made company lists. A company left out is not read and not charged. Leave empty to keep every company.

## `outputMode` (type: `string`):

jobs: one row per job. companies: one summary row per company with open jobs, jobs posted in the last 7 and 30 days, remote share, top departments, locations, countries, seniority, job functions, leadership and first-hire roles, salary medians, top tools, and new and closed jobs with Only new jobs. Counts use every job passing your filters. It costs one lookup per company, never the extra 1,000-job charge. both: job rows plus summary rows (rowType job, company or status).

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

true: add each job's full description as plain text, up to 60,000 characters, without emails, phone numbers or profile links, and the tools it names (field tools). Same price: Greenhouse sends all descriptions in one list. Pay written in a description fills the salary when the job has no pay range. With Only new jobs, only new jobs are described. With Rows to return: companies, summary rows get top tools and first-hire roles.

## `descriptionFormat` (type: `string`):

How each description comes, with Include job description on. text: plain text. html: the board's own HTML, kept safe: no scripts, styles, frames or event handlers, only basic tags such as paragraphs, headings, lists, bold and links. markdown: the same converted to Markdown (headings, lists, links, bold). Every format has emails, phone numbers and profile links removed and is cut at 60,000 characters. Same price.

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

Return at most this many jobs per company, the newest first, for example 50. To answer a quick question, 20 is enough. Leave empty for all jobs, up to 10,000 per company. Set 1,000 or less to never pay the $0.045 charge for each further 1,000 jobs. With Only new jobs, closed jobs come on top of this cap and count toward that charge. Summary rows still count every matching job.

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

true: return only jobs you have not received from this Actor before, plus jobs that closed since your previous check (field change is new or closed). The first check of a company returns all its jobs for $0.10. A later check costs $0.002 per started 1,000 open jobs on the board, so $0.002 for 300 jobs and $0.006 for 2,400. Use it with a schedule. What you received is saved in your own Apify account, per Monitor name and set of filters. Default false.

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

Only used with Only new jobs. Name of the saved list of jobs you received, so separate watchlists do not mix, for example sales-accounts or competitors. Letters, numbers, - and \_ only, up to 40 characters. Default: default.

## `includeUpdatedJobs` (type: `boolean`):

Only used with Only new jobs. true: also return jobs you received before whose title, location, salary or job type changed since your previous check, with change updated, changedFields and the previous values. Each is one more row, so it counts toward the $0.045 per further 1,000 jobs. Default false: the price stays the same and changes are only counted in summary rows.

## `skipReposts` (type: `boolean`):

Only used with Only new jobs. true: leave out a new job with the same title and location as a job you received that closed in the last 30 days, a repost under a new id. It gets no row, is not counted as new and is not in the alert, and it never comes back as new. The company's status (skippedRepostsCount) and summary row (skippedReposts) say how many were left out. Default false: reposts come as new jobs with reposted true.

## `alertWebhookUrl` (type: `string`):

Only used with Only new jobs. An https link that gets one short message after a check with new or closed jobs, and nothing on days without changes. Paste the incoming webhook link of a Slack, Discord or Teams channel, or a Make, Zapier or n8n webhook, such as https://hooks.slack.com/services/... The message has the counts per company and the jobs with their links. Free. Kept secret. Leave empty for no alert.

## `alertMaxJobs` (type: `integer`):

Only used with Alert webhook URL. How many new and closed jobs the alert lists, one line each with title, location and salary when known, for example 20. More jobs are counted with a link to the dataset. A whole number from 1 to 50. Free. Default 10.

## `alertOnFirstCheck` (type: `boolean`):

Only used with Alert webhook URL. true: also send an alert on the first check of a company, which returns all its open jobs as new. Default false: the first check sends nothing, and later checks alert only on new and closed jobs. Free.

## `titleIncludes` (type: `array`):

Keep only jobs whose title contains one of these words or phrases, ignoring case. Use it to check if a company is hiring for a role, for example data engineer or account executive. Whole words only, so engineer matches Software Engineer but not Engineering Manager. A list of up to 100. Leave empty for all titles.

## `department` (type: `string`):

Keep only jobs whose department, team or department path contains this text, ignoring case, for example engineering. For several, put one per line. A job that matches any of them is kept. In API input, put a line break between values, as in "engineering\nsales". Up to 100. Leave empty for all departments.

## `location` (type: `string`):

Keep only jobs in this place, such as London, California or Germany. A country name or code (Germany, DE) keeps jobs in that country, so DE does not keep Rio de Janeiro. A US state or Canadian province keeps its region, so California keeps San Mateo, CA. Other text matches whole words, so York keeps New York, not Yorkshire. For several, put one per line. Any match keeps a job. In API input, put a line break between values. For remote jobs use Remote only. Leave empty for all.

## `locationExcludes` (type: `array`):

Leave out jobs in any of these places, matched like Location: India or IN also leaves out jobs in Bangalore, and California leaves out San Mateo, CA. A job with several places is left out when any of them matches. Jobs with no location are kept. A list of up to 100, for example India and Brazil. Leave empty to keep every location.

## `near` (type: `string`):

Keep only jobs within the distance below of one city, such as Berlin or Austin, TX. Add the country or US state to a shared name (Cambridge, UK). Distances run from each city's center, and every place of a job counts. A remote job is kept only when it lists such a place; do not combine with Remote only. Jobs whose city we do not know (only a country, or a town under 15,000 people) are left out; the warning counts them. An unknown city stops the run free, with close matches.

## `radiusKm` (type: `integer`):

How far from the city in Near a city a job may be, in kilometers, from 1 to 500. Default 50. Used only with Near a city.

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

true: keep only jobs that can be done fully remote. Hybrid and on-site jobs are left out. Default false.

## `remoteRegions` (type: `array`):

Keep only remote jobs open to one of these places: worldwide, americas, us, canada, latam, emea, europe, uk, apac, or a country code such as DE. Read from the job's location and title, for example Remote - US or Remote (EMEA). A job open worldwide matches every value, and a region matches the countries in it: europe keeps a job open in Germany. Remote jobs whose places are unknown are left out, and the warning says how many. Leave empty to keep every job.

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

Keep only jobs with one of these workplace types: remote, hybrid or onsite (field workplaceType). Greenhouse has no workplace field, so it is read from the location text: remote and hybrid jobs are marked, on-site jobs are unknown. Jobs whose workplace type is unknown are left out, and the company's warning says how many. Leave empty for all jobs.

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

Keep only jobs with one of these job types (field employmentTypeNormalized). Greenhouse gives a job type only when the company fills its Employment Type or Time Type field; otherwise title words like Intern or Part-time tell. Jobs whose type is unknown are left out, and the company's warning says how many. Leave empty for all.

## `seniorities` (type: `array`):

Keep only jobs at one of these levels (field seniority), read from the title: Senior Engineer is senior, Head of Sales is director. A title without a level word, such as Software Engineer, has no seniority: those jobs are left out, and the company's warning says how many. Leave empty for all levels.

## `jobFunctions` (type: `array`):

Keep only jobs in these functions, read from each job's title, then its department and team (output field jobFunction). Pick one or more, for example Engineering and Data. English and German titles are read, and basic French, Spanish, Dutch and Swedish ones. In our tests about 9 in 10 jobs got the right function. API value: a list such as \["engineering", "data"]. Leave empty for all functions.

## `languages` (type: `array`):

Keep only jobs written in one of these languages, as two-letter codes such as en, de, fr, es, nl or pt (field language). Greenhouse gives each job's language, so this works without descriptions. Jobs whose language is unknown are left out, and the company's warning says how many.

## `titleExcludes` (type: `array`):

Leave out jobs whose title contains any of these words or phrases, ignoring case. Whole words only, so intern does not match International. A list of up to 100, for example senior and intern. An excluded word wins over Title includes. Leave empty to keep every title.

## `descriptionIncludes` (type: `array`):

Keep only jobs whose description names any of these words or phrases, ignoring case, such as Snowflake, Rust or C++. Whole words only, so Rust does not match trust. A tool also matches its other names, so Postgres finds PostgreSQL. Up to 100. This reads the description, so it turns on Include job description, also with Rows to return: companies, at the same price. Leave empty for all jobs.

## `skills` (type: `array`):

Keep only jobs that name at least one of these skills in their tools, such as Python, Snowflake or Salesforce, ignoring case. Other spellings work, so golang finds Go. Each job lists the ones it has in matchedSkills. A word that is not a skill we know stops the run before any charge and names close skills. Up to 100. This turns on Include job description, with its price on the boards that need one request per job (see Pricing). Leave empty for all jobs.

## `hasSalary` (type: `boolean`):

true: keep only jobs with a salary (salaryMin or salaryMax), from the pay ranges the company adds to its jobs on Greenhouse. With Include job description, pay written in the description counts too. Default false.

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

Keep jobs whose yearly salary reaches this amount, such as 120000: the top of the range (salaryAnnualMax, else salaryAnnualMin), in the currency below. Pay in the description counts too, so this turns on Include job description, at the same price. No exchange rates: jobs paid in another currency, and jobs with no yearly salary are left out; the warning says how many. Empty for no minimum.

## `minAnnualSalaryCurrency` (type: `string`):

Currency of Minimum yearly salary, as a three-letter code such as USD, EUR or GBP. Only jobs whose salary is in this currency can pass. Used only with Minimum yearly salary. Default USD.

## `postedSince` (type: `string`):

Keep only jobs posted on or after this date. Use a date as YYYY-MM-DD, for example 2026-09-01, or a period as a number plus hours, days, weeks, months or years, for example 24 hours or 7 days. A period counts back from the start of each run, which suits schedules. Jobs whose board gives no posting date are left out. Leave empty for all dates.

## `postedBefore` (type: `string`):

Keep only jobs posted before this date. Use a date as YYYY-MM-DD, for example 2026-06-01, or a period such as 30 days for jobs posted more than 30 days ago. With Posted since it gives a date range. Jobs whose board gives no posting date are left out, and the company's warning says how many. Leave empty for all dates.

## `maxExperienceYears` (type: `integer`):

Keep only jobs whose description asks for at most this many years of experience, read from phrases like 5+ years or mindestens 3 Jahre. A whole number from 0 to 50, for example 3. Jobs that give no years are left out, and the warning says how many. This reads the description, so it turns on Include job description, also with Rows to return: companies, at the same price. Leave empty for all.

## `visaSponsorship` (type: `boolean`):

true: keep only jobs whose description says the company sponsors visas. Jobs that do not mention it are left out, and the warning says how many. This reads the description, so it turns on Include job description, also with Rows to return: companies, at the same price. Default false.

## `ukVisaSponsorOnly` (type: `boolean`):

true: keep only jobs at companies on the UK Home Office register of licensed sponsors for workers (ukVisaSponsor true). The company name must match a register name exactly, once words like Ltd, Limited, PLC and UK are set aside, so a company listed under another legal name is left out, and so is a name too short or too common to match safely. The warning says why. Default false.

## `startUrls` (type: `array`):

Another name for Companies, so input written for other Actors works: links as strings or as {"url": "..."} objects. Merged into Companies.

## `urls` (type: `array`):

Another name for Companies, so input written for other Actors works: links as strings or as {"url": "..."} objects. Merged into Companies.

## Actor input object example

```json
{
  "companies": [
    "https://boards.greenhouse.io/dropbox",
    "https://job-boards.greenhouse.io/duolingo",
    "https://boards.greenhouse.io/discord"
  ],
  "excludeCompanies": [
    "openai",
    "stripe.com"
  ],
  "outputMode": "jobs",
  "includeDescription": false,
  "descriptionFormat": "text",
  "maxJobsPerCompany": 50,
  "onlyNewJobs": false,
  "monitorName": "default",
  "includeUpdatedJobs": false,
  "skipReposts": false,
  "alertMaxJobs": 10,
  "alertOnFirstCheck": false,
  "titleIncludes": [
    "engineer"
  ],
  "department": "engineering",
  "location": "London",
  "near": "Berlin",
  "radiusKm": 50,
  "remoteOnly": false,
  "jobFunctions": [
    "engineering",
    "data"
  ],
  "descriptionIncludes": [
    "Snowflake",
    "dbt"
  ],
  "skills": [
    "Python",
    "Kubernetes"
  ],
  "hasSalary": false,
  "minAnnualSalaryCurrency": "USD",
  "postedSince": "7 days",
  "visaSponsorship": false,
  "ukVisaSponsorOnly": false
}
```

# Actor output Schema

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

Dataset items, one per job: company, companyName, matchedBy, companyStatus, title, department, team, location, countryCode, city, remote, seniority, jobFunction, employment type, salary with its yearly value, tools (with descriptions), postedAt and url. The dataset has more fields (jobId, applyUrl, description, country, region, salaryRanges, charged, warning, error); read it with fields=... to keep only what you need.

## `companies` (type: `string`):

JSON array, one object per company in input order: companyStatus (ok, no\_open\_jobs, not\_found, no\_job\_board\_found, invalid\_input and others), charged, chargedEvent, companyName, matchedBy (link, website, directory, name or name variant), inputDomain and boardUrl for websites, companyTotalOpenJobs, companyMatchedJobs, companyJobsReturned, newJobsCount, closedJobsCount, updatedJobsCount, error and warning.

## `companySummaries` (type: `string`):

Dataset items with rowType company, one per company, when Rows to return is companies or both: openJobs, jobs posted in the last 7 and 30 days, jobs open over 90 days, remote, engineering and sales shares, top departments, locations and countries, seniority and job function counts, jobs per function posted in the last 30 days, leadership and first-hire roles, top tools, salary medians, and new, closed, updated and reposted jobs with Only new jobs. With jobs, this view has no summary rows.

# 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/dropbox",
        "https://job-boards.greenhouse.io/duolingo",
        "https://boards.greenhouse.io/discord"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("conserving_celerytop/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": [
        "https://boards.greenhouse.io/dropbox",
        "https://job-boards.greenhouse.io/duolingo",
        "https://boards.greenhouse.io/discord",
    ] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,conserving_celerytop/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/FSxUeZvr9LtTIdkbw/builds/sLqoX7d6bjsZae4K6/openapi.json