# Lever Jobs — 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 postings on any Lever-hosted company job board. List, filter, search, and group open roles, retrieve full posting details, and extract application form questions via Lever's public API.

**Category:** Jobs | **Website:** [jobs.lever.co/](https://jobs.lever.co/) | **Docs:** [parse.bot/marketplace/673e428d-cced-419e-afa1-f2aeba7a03dc/jobs-lever-co-api](https://parse.bot/marketplace/673e428d-cced-419e-afa1-f2aeba7a03dc/jobs-lever-co-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-jobs-lever-co-api-673e428d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_job_board

Scrape the public Lever-hosted job board page for a company. Returns the company name, logo URL, and all job postings grouped by department as displayed on the site. Only works for companies with active Lever-hosted job boards.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company slug (e.g. 'palantir'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/get_company_job_board \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>"}'
```

### get_company_job_postings

Fetch active job postings for a company from the Lever public API. Supports filtering by team, location, and commitment type. Returns paginated results via offset. The location filter requires an exact match to the location string as stored by Lever.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `commitment` | string | No | Filter by commitment type (e.g. 'Full-time', 'Internship'). |
| `company` | string | Yes | The company slug as it appears in the Lever URL (e.g. 'palantir', 'netflix'). |
| `limit` | integer | No | Max results to return per page. |
| `location` | string | No | Filter by location. Requires exact match to the full location string (e.g. 'New York, NY'). |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `team` | string | No | Filter by team/department name. Requires exact match to the team value in the posting. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/get_company_job_postings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commitment":"<string>","company":"<string>","limit":"<integer>","location":"<string>","offset":"<integer>","team":"<string>"}'
```

### get_job_application_form_questions

Scrape the job application form page to extract all application questions. Returns each question's label, input type, required status, and available options for select/radio/checkbox fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company slug (e.g. 'palantir'). |
| `posting_id` | string | Yes | The job posting UUID (from get_company_job_postings results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/get_job_application_form_questions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>","posting_id":"<string>"}'
```

### get_job_posting_detail

Fetch full details for a single job posting by its UUID. Returns the complete posting object including HTML description, requirement lists, categories, and application URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company slug (e.g. 'palantir'). |
| `posting_id` | string | Yes | The job posting UUID (from get_company_job_postings results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/get_job_posting_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>","posting_id":"<string>"}'
```

### get_job_postings_grouped

Fetch all job postings for a company and group them by a specified field. Returns an object where keys are group names (e.g. department names) and values are arrays of full job posting objects. Useful for building categorized job board views.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company slug (e.g. 'palantir'). |
| `group_by` | string | No | Field to group postings by. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/get_job_postings_grouped \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>","group_by":"<string>"}'
```

### search_jobs

Search for jobs across a company's Lever board by keyword. Performs case-insensitive substring matching against job title, plain-text description, and categories. Returns matching job posting objects wrapped in an items array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company slug (e.g. 'palantir'). |
| `query` | string | Yes | Search keyword for case-insensitive substring matching against job titles, descriptions, and categories. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobs-lever-co-api-673e428d/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>","query":"<string>"}'
```