Skip to main content
Piloterr
Back to library

Greenhouse Job API

Fetch one Greenhouse job by board/id, such as discord/8806482002, or by a job-boards.greenhouse.io job URL.

Active1 credit = 1 requestGET/v2/greenhouse/job

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Fetch one Greenhouse job. query is {board}/{job id}, for example discord/8806482002, or https://job-boards.greenhouse.io/discord/jobs/8806482002. The response is a flat object. description is plain text taken from the posting HTML. Search cards do not include description, departments, or offices.

QuickstartLink to Quickstart

curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/job?query=discord/8806482002"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/job?query=https%3A%2F%2Fjob-boards.greenhouse.io%2Fdiscord%2Fjobs%2F8806482002"

ParametersLink to Parameters

Name Detail
query Required string. {board}/{job id} or a job URL. Example: discord/8806482002.

Response fieldsLink to Response fields

Name Detail
id Integer. Same id as the search card.
title String.
description String or null. Full plain-text posting.
departments Array of strings.
offices Array of strings.
company_name String or null.
location String or null.
url String. Public job URL.
updated_at String or null.
first_published String or null.
requisition_id String or null.
language String or null.
application_deadline String or null.

PaginationLink to Pagination

One job. No pagination object.

Use casesLink to Use cases

  • An ATS mirror fetches the plain-text description for discord/8806482002 after a board search.
  • A job alert stores departments and offices for one posting.
  • A career page links the public url returned for that board and id.

Error codesLink to Error codes

Name Detail
400 Missing board or job id, a non-numeric id, or a host other than greenhouse.io.
404 Unknown job.
401 Missing API key.
500 The Greenhouse request failed.

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included