> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Company job boards

> Get every open job from a company's own careers page on Greenhouse, Lever, Ashby, Workday or SmartRecruiters, with title, team, location, remote, salary and description, for 1 credit per 100 jobs.

Most companies list their jobs through a hiring system such as Greenhouse, Lever, Ashby, Workday or SmartRecruiters. Scrape the company's job board link and you get every open job on it, straight from the company: title, department, team, location, remote, employment type, posted date, salary where the company publishes it, the description and the apply link. Send `"output": "json"` to get just that data, or add a `prompt` or `schema` to shape it your own way ([how results come back](https://docs.spidra.io/sites/overview.md#how-results-come-back)).

A board costs 1 credit for up to 100 jobs, and 1 more credit for every further 100. A single job costs 1 credit. A link that can't be read costs nothing.

## Example

```json theme={null}
{ "urls": ["https://job-boards.greenhouse.io/stripe?q=engineer&location=remote"], "output": "json", "wait": true }
```

The batch item's `result` has the board's `company`, `totalJobs` (785 open at Stripe when we ran this), `matchingJobs` (17 remote engineering jobs) and `jobs`:

```json theme={null}
{
  "id": "6042172",
  "title": "Backend Engineer, Core Technology",
  "url": "https://stripe.com/jobs/search?gh_jid=6042172",
  "applyUrl": "https://stripe.com/jobs/search?gh_jid=6042172",
  "company": "Stripe",
  "department": "8127 Core Infrastructure",
  "location": "US-Remote, Chicago, Seattle, San Francisco",
  "locations": ["US-Remote, Chicago, Seattle, San Francisco", "US"],
  "remote": true,
  "postedAt": "2024-06-14T22:04:50.000Z",
  "updatedAt": "2026-11-03T19:33:24.000Z",
  "salary": null,
  "description": "Who we are\n\nAbout Stripe\n\nStripe is a financial infrastructure platform for businesses...",
  "platform": "greenhouse"
}
```

On Ashby, many companies publish pay. A research engineer job on `jobs.ashbyhq.com/openai` comes back with `"salary": { "min": 250000, "max": 445000, "currency": "USD", "interval": "year", "text": "$250K - $445K" }`.

## Links that work

| Hiring system | Board link | Job link |
| - | - | - |
| Greenhouse | `boards.greenhouse.io/<company>`, `job-boards.greenhouse.io/<company>` (and the `.eu.` hosts) | `.../<company>/jobs/<id>` |
| Lever | `jobs.lever.co/<company>`, `jobs.eu.lever.co/<company>` | `jobs.lever.co/<company>/<id>` |
| Ashby | `jobs.ashbyhq.com/<company>` | `jobs.ashbyhq.com/<company>/<id>` |
| Workday | `<company>.wd5.myworkdayjobs.com/<site>` (any `wd<n>` and locale) | `.../<site>/job/<location>/<title>_<id>` |
| SmartRecruiters | `jobs.smartrecruiters.com/<company>`, `careers.smartrecruiters.com/<company>` | `jobs.smartrecruiters.com/<company>/<id>` |

A company's own careers page usually links to one of these. If the jobs on `company.com/careers` open on `boards.greenhouse.io` or `jobs.lever.co`, use that link.

## Filters

Add these to a board link. They're read by Spidra and never sent to the company.

| Option | What it does | Example |
| - | - | - |
| `q` | Keeps jobs whose title, department or team has all these words | `?q=data engineer` |
| `location` | Keeps jobs whose location has these words. `remote` also matches jobs marked remote | `?location=london` |
| `jobs` | How many jobs to return: 100 by default, up to 5,000, or `all` | `?jobs=all` |
| `find=any` | Greenhouse links only: if the company has no Greenhouse board under this name, tries the same name on Lever and Ashby | `boards.greenhouse.io/notion?find=any` |

## Fields

| Page | Fields |
| - | - |
| Board | `platform`, `company`, `boardUrl`, `totalJobs`, `matchingJobs`, `jobCount`, `filters`, `credits` and `jobs` |
| Each job | `id`, `title`, `url`, `sourceUrl`, `applyUrl`, `company`, `department`, `team`, `location`, `locations`, `remote`, `workplaceType`, `employmentType`, `postedAt`, `postedText`, `updatedAt`, `requisitionId`, `salary` (`min`, `max`, `currency`, `interval`, `text`), `description`, `platform` |

* A field the company doesn't fill in comes back as `null`. Many companies leave `team`, `employmentType` or `salary` empty.
* `salary` appears when the company publishes a pay range. Ashby boards often have it. On Greenhouse, it comes with a single job's link.
* Greenhouse, Lever and Ashby send the full description with the board. Workday and SmartRecruiters list jobs without descriptions; scrape a job's link for its description. The result's `note` says so.

## Good to know

* These are the job boards companies publish so their jobs can be shown on other sites. No browser, proxy or login is involved. Greenhouse, Lever, Ashby and SmartRecruiters boards usually come back in one to five seconds, even with hundreds of jobs; Workday takes a few seconds longer because it pages through 20 jobs at a time.
* `matchingJobs` is `null` on Workday and SmartRecruiters, which page through jobs instead of sending the whole board.
* A company with no open jobs, a board that doesn't exist and a job that was taken down all fail with a plain message and cost nothing.

## Templates

The [template](https://docs.spidra.io/templates.md) "Jobs from company career pages" takes a list of company names or careers links and returns every open job at each, with keyword and location filters. Names are looked up on Greenhouse, Lever and Ashby. For a Workday or SmartRecruiters company, paste its careers link.

> [!NOTE]
>
> Check each company's terms before you collect data from its job board. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.