List open jobs on a public Greenhouse board. query is the board token, such as discord, or https://job-boards.greenhouse.io/discord. Optional keyword filters title and location. A job URL, or discord/{job id}, returns 400 here. Pass that value to the job endpoint.
Greenhouse returns the whole board. This endpoint slices it into pages of 20.
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/search?query=discord"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/search?query=discord&page=2"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/search?query=discord&keyword=policy"
| Name |
Detail |
| query |
Required string. Board token or a job-boards.greenhouse.io board URL. Example: discord. A job URL returns 400. |
| keyword |
Optional string. Case-insensitive filter on title and location. Example: policy. |
| page |
Optional integer from 1. Example: 2. Defaults to 1. |
| Name |
Detail |
| results[].id |
Integer. Greenhouse job id. Pass discord/{id} to the job endpoint. |
| results[].title |
String. |
| results[].company_name |
String or null. |
| results[].location |
String or null. |
| results[].url |
String or null. Public job URL. |
| results[].updated_at |
String or null. |
| results[].first_published |
String or null. |
| results[].requisition_id |
String or null. |
| results[].language |
String or null. |
| results[].application_deadline |
String or null. |
| pagination.page |
Integer. |
| pagination.per_page |
Integer. 20. |
| pagination.total_results |
Integer. Jobs on the board after the keyword filter. |
| pagination.total_pages |
Integer. |
| pagination.next |
String or null. https://job-boards.greenhouse.io/discord?page=2, with keyword when you set one. Null on the last page. |
Page size is 20. The Discord board currently needs more than one page, so pagination.next is https://job-boards.greenhouse.io/discord?page=2. Request page=2 for the next slice. Job ids do not repeat across pages. next is null when the filtered list fits on the current page. keyword=policy on Discord is a one-page filter, so next is null and total_results is the number of title or location matches.
- A recruiting ops team exports every open role on the
discord board by following pagination.next.
- A policy newsletter calls
query=discord&keyword=policy and stops when next is null.
- A careers aggregator stores
id and url, then fetches the posting text from the job endpoint.
| Name |
Detail |
| 400 |
Missing board, a host other than greenhouse.io, or a job URL sent to search. |
| 404 |
Unknown board, no jobs, or page past the last page. |
| 401 |
Missing API key. |
| 500 |
The Greenhouse request failed. |