Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Greenhouse Search

Liste les offres d'un board Greenhouse. query est le jeton, par exemple discord.

Actif1 crédit = 1 requêteGET/v2/greenhouse/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

OverviewLink to Overview

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.

QuickstartLink to Quickstart

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"

ParametersLink to Parameters

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.

Response fieldsLink to Response fields

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.

PaginationLink to Pagination

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.

Use casesLink to Use cases

  • 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.

Error codesLink to Error codes

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é.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus