# Greenhouse Job Boards API

> Open jobs of any company hiring on Greenhouse: listings, job details, departments, offices

- Vendor: `greenhousejobboardsapi` · version 1.0 · category Jobs · tags greenhouse api, job board api, job postings api, careers page api, open jobs api, hiring data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/greenhousejobboardsapi
- This document: https://apiclay.com/docs/greenhousejobboardsapi.md
- OpenAPI 3.1: https://apiclay.com/api/greenhousejobboardsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `greenhousejobboardsapi`
- Updated: 2026-11-18

## About

## Greenhouse Job Boards API

Read the open jobs of any company that hires through Greenhouse: every posting with title, location, department, publish and update dates and apply URL, the full job description, and the company's departments and offices.

Data comes from **greenhouse.io** (https://job-boards.greenhouse.io). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://job-boards.greenhouse.io) and returns it unchanged.

Typical flow: take the board token from the company's careers URL (`job-boards.greenhouse.io/airbnb` -&gt; `airbnb`), call `/jobs`, then `/job` for a description.

### Routes

#### GET `/jobs` - Jobs of a company
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| board | path | string | yes | Board token, e.g. `airbnb`, `stripe`. |
| content | query | string | no | `true` adds each job's HTML description (much bigger). |

Returns: `jobs[]` (`id`, `title`, `location.name`, `absolute_url`, `updated_at`, `first_published`, `company_name`, `metadata`) and `meta.total`.

#### GET `/job` - Job details
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| board | path | string | yes | Board token. |
| job_id | path | number | yes | `id` from `/jobs`. |
| questions | query | string | no | `true` adds the application questions. |

Returns: the job with `content` (HTML), `departments`, `offices`.

#### GET `/board` - Board info
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| board | path | string | yes | Board token. |

Returns: `name`, `content` (the careers intro).

#### GET `/departments`, `/offices`
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| board | path | string | yes | Board token. |

Returns: `departments[]` / `offices[]`, each with its `jobs[]`.

### Caveats

- Only boards the company publishes publicly; an unknown token answers 404.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by greenhouse.io.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /jobs — Jobs of a company
- Gateway: `GET https://api.apiclay.com/v1/api/greenhousejobboardsapi/jobs`
- Public query params: `content` (string), `board` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /job — Job details
- Gateway: `GET https://api.apiclay.com/v1/api/greenhousejobboardsapi/job`
- Public query params: `questions` (string), `board` (string, required), `job_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /board — Board info
- Gateway: `GET https://api.apiclay.com/v1/api/greenhousejobboardsapi/board`
- Public query params: `board` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /departments — Departments
- Gateway: `GET https://api.apiclay.com/v1/api/greenhousejobboardsapi/departments`
- Public query params: `board` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /offices — Offices
- Gateway: `GET https://api.apiclay.com/v1/api/greenhousejobboardsapi/offices`
- Public query params: `board` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/greenhousejobboardsapi/jobs?board=<board>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
