Liste les offres d'un board Greenhouse public. query est le jeton du board, par exemple discord, ou https://job-boards.greenhouse.io/discord. keyword filtre le titre et le lieu, sans obligation. Une URL d'offre, ou discord/{id}, renvoie 400 ici. Passez-la à l'endpoint job.
Greenhouse renvoie tout le board. Cet endpoint le découpe en pages de 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&keyword=policy"
| Name |
Detail |
| query |
Chaîne obligatoire. Jeton du board ou URL du board. Exemple : discord. Une URL d'offre renvoie 400. |
| keyword |
Chaîne facultative. Filtre sur le titre et le lieu. Exemple : policy. |
| page |
Entier facultatif à partir de 1. Exemple : 2. Défaut : 1. |
| Name |
Detail |
| results[].id |
Entier. Id Greenhouse. Passez discord/{id} à l'endpoint job. |
| results[].title |
Chaîne. |
| results[].company_name |
Chaîne ou null. |
| results[].location |
Chaîne ou null. |
| results[].url |
Chaîne ou null. |
| pagination.per_page |
Entier. 20. |
| pagination.total_results |
Entier. Offres après filtre. |
| pagination.next |
Chaîne ou null. URL de la page suivante, null sur la dernière page. |
Pages de 20. Pour Discord, next ressemble à https://job-boards.greenhouse.io/discord?page=2. Les ids ne se répètent pas. next est null quand le filtre tient sur la page. keyword=policy sur Discord tient sur une page.
- Une équipe recrutement exporte le board
discord en suivant pagination.next.
- Une veille policy appelle
query=discord&keyword=policy et s'arrête quand next est null.
- Un agrégateur garde
id et url, puis lit le texte via l'endpoint job.
| Name |
Detail |
| 400 |
Board absent, mauvais hôte, ou URL d'offre envoyée à search. |
| 404 |
Board inconnu, aucune offre, ou page trop loin. |
| 401 |
Clé API absente. |
| 500 |
L'appel Greenhouse a échoué. |