# Job Boards Greenhouse — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access job listings, department information, office locations, and application forms from Greenhouse.io job boards, then submit applications directly through the platform. Search and filter available positions by keywords to find roles that match your qualifications.

**Category:** Jobs | **Website:** [job-boards.greenhouse.io/](https://job-boards.greenhouse.io/) | **Docs:** [parse.bot/marketplace/064e5b88-4142-4fec-9a36-42424988bc55/job-boards-greenhouse-io-api](https://parse.bot/marketplace/064e5b88-4142-4fec-9a36-42424988bc55/job-boards-greenhouse-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_board_info

Retrieve basic info about a company's Greenhouse job board, including the company name and any board-level content. One round-trip per board.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token (e.g. 'anthropic', 'spacex', 'stripe'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/get_board_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### get_job

Retrieve full details for a specific job, including HTML description content, compliance data, and application form questions. Requires both board_token and job_id. Returns upstream_error if the job does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `job_id` | string | Yes | The numeric job post ID. |
| `questions` | boolean | No | Whether to include application form questions in the response. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/get_job \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","job_id":"<string>","questions":"<boolean>"}'
```

### list_departments

List all departments and their associated jobs for a company's Greenhouse board. Each department includes its id, name, parent_id, child_ids, and a jobs array. One round-trip.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/list_departments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### list_jobs

Retrieve all job listings from a company's Greenhouse job board. Paginates server-side internally and returns the complete list. Each job includes id, title, absolute_url, location, departments, offices, and optionally content (HTML description). Large boards (300+ jobs) may take a few seconds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `content` | boolean | No | Whether to include full job description HTML and metadata. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/list_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","content":"<boolean>"}'
```

### list_offices

List all offices/locations and their associated departments and jobs for a company's Greenhouse board. Each office includes id, name, location, parent_id, child_ids, and a departments array containing jobs. One round-trip.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/list_offices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### search_jobs

Search for jobs using keyword, department, or office filters. Fetches all jobs from the board and filters client-side. query matches against title and HTML description. department and office use exact case-insensitive name matching. is_new restricts to jobs published within the last 7 days based on first_published timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `department` | string | No | Department name to filter by (exact match, case-insensitive). |
| `is_new` | boolean | No | When true, only return jobs published within the last 7 days. |
| `office` | string | No | Office/location name to filter by (exact match, case-insensitive). |
| `query` | string | No | Keyword to search in job title and description. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-job-boards-greenhouse-io-api-064e5b88/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","department":"<string>","is_new":"<boolean>","office":"<string>","query":"<string>"}'
```
