cd /news/developer-tools/public-job-board-endpoints-of-greenh… · home › topics › developer-tools › article
[ARTICLE · art-170355] src=dev.to ↗ pub= topic=developer-tools verified=true sentiment=· neutral

Public job-board endpoints of Greenhouse, Lever and Ashby, and how to normalize them

A developer documented the public, unauthenticated JSON job-board endpoints of Greenhouse, Lever and Ashby, re-running every request on 2026-11-16 and verifying field names against live responses and vendor docs. The writeup maps the three differing response shapes — Greenhouse's jobs/meta wrapper, Lever's bare array with millisecond timestamps, and Ashby's apiVersion-wrapped list with structured compensation tiers — into a single schema, and notes that Lever's robots.txt sets a Crawl-delay of 1 second.

by read5 min views1 publishedNov 16, 2026

This post was written by AI coding agents working on my behalf, and it is labelled AI Generated.

Disclosure: I built this tool with AI coding agents, and AI helped draft this article. Every request below was re-run on 2026-11-16, and the numbers and field names were checked against the live responses and the vendors' docs.

Many companies host their careers page on an applicant tracking system (ATS). Three of the common ones, Greenhouse, Lever and Ashby, publish the open jobs of each customer through plain JSON endpoints. You need no API key and no login. This post documents what each endpoint returns, where they differ, which sources I decided not to use, and how I map the three shapes into one schema.

You can use all of it with fetch and no tool of mine. A small runnable example is at the end.

The identifier is called a "board token" (Greenhouse), a "site" (Lever) or a "job board name" (Ashby). It is usually the last part of the company's hosted board URL, for example jobs.lever.co/leverdemo gives leverdemo. It is often not the company's marketing name.

ATS Endpoint Auth
Greenhouse GET https://boards-api.greenhouse.io/v1/boards/{token}/jobs none for GET
Lever GET https://api.lever.co/v0/postings/{site}?mode=json (EU:api.eu.lever.co ) none for GET
Ashby GET https://api.ashbyhq.com/posting-api/job-board/{name}?includeCompensation=true none

Greenhouse's docs say "Job Board data is publicly available, so authentication is not required for any GET endpoints." Lever's repository documents the posting list and its filters (skip, limit, location, commitment, team, department). Ashby documents one endpoint and one parameter.

The list response is { "jobs": [...], "meta": { "total": N } }. Each job has id, title, location.name, absolute_url, first_published, updated_at, company_name and a few compliance fields. Two things to know:

?content=true to get the description, department and offices, or call /departments and join on job id.pay_transparency=true on the single-job endpoint, GET /jobs/{id}, which means one extra request per job. The response is a bare JSON array. Useful fields: id, text (the title), categories (location, commitment, team, department, allLocations), country, workplaceType (on-site, remote, hybrid or unspecified), createdAt in milliseconds since the epoch, hostedUrl, applyUrl, and an optional salaryRange with currency, interval, min and max. Descriptions come both as HTML and as plain text.

The response is { "apiVersion": "1", "jobs": [...] }. Each job has title, department, team, employmentType, location, secondaryLocations, isRemote, workplaceType (OnSite, Remote, Hybrid), publishedAt, jobUrl, applyUrl, descriptionHtml, descriptionPlain, isListed and, with includeCompensation=true, a compensation object. Ashby's docs say a job with isListed: false "should only be available via direct link", so skip those. Compensation is structured: each tier has components, and a salary component has minValue, maxValue, currencyCode and interval. Bonus and equity components can appear in the same list with null values, so filter on compensationType === "Salary".

{"status":404,"error":"Job not found"}, Lever {"ok":false,"error":"Document not found"}, Ashby plain Not Found). A 200 with an empty list means the board exists and has no open jobs, but a 404 does not tell you the company is gone, only that this token is wrong. Some write-ups say Lever returns an empty array for unknown sites. I did not see that.null when a source gives nothing.robots.txt on api.lever.co states Crawl-delay: 1. I wait at least one second between requests to one host and send a descriptive User-Agent. I have not found a published rate limit for the GET endpoints of the three vendors, so I keep the pace low. I looked at three more systems and decided not to call them:

https://api.smartrecruiters.com/robots.txt on 2026-11-16 allows one named bot on /v1/companies/ and says User-agent: * then Disallow: /. A generic client is told to stay away, so I do not call it.breezy.hr disallows /api/, and its terms of service prohibit accessing the service by means other than its publicly supported interfaces. A missing robots rule is not a permission, and terms of service apply either way. My rule: if I cannot show the access is at least not prohibited, I skip the source.

Every record gets the same keys, and unknown values stay null. I never invent a value. A salary of 0 becomes null.

{
  "ats": "lever",
  "companySlug": "leverdemo",
  "jobId": "ad208490-4052-4f91-a57e-433f2d1e484b",
  "title": "Customer Success Manager",
  "location": "Atlanta, Georgia",
  "department": "Customer Success",
  "workplaceType": "hybrid",
  "postedAt": "2026-08-31T18:12:19.703Z",
  "salaryMin": 85000,
  "salaryMax": 175000,
  "salaryCurrency": "USD",
  "url": "https://jobs.lever.co/leverdemo/ad208490-4052-4f91-a57e-433f2d1e484b"
}

Design choices that matter later:

ats:companySlug:jobId. Job ids alone collide across vendors. FullTime, Regular Full Time (Salary) or nothing. Map the ones you recognize to full_time, part_time, contract and so on, and keep the raw text too.remote is tri-state.true, false or This short Node script (no dependencies, Node 18+) fetches one board and prints one normalized JSON record per line. It is in this repository: https://github.com/anhduyhaha1234-droid/job-board-endpoints .

node normalize.mjs greenhouse stripe
node normalize.mjs lever leverdemo
node normalize.mjs ashby ashby

On 2026-11-16 these returned 785, 10 and 77 records. Those counts change daily.

For name lookups I use the "ATS Company Directory" published by LastRound AI under CC BY 4.0, about 9,900 boards on these three systems (August 2026 snapshot): https://lastroundai.com/blog/salary-transparency-study-2026 . I converted the CSV to compact JSON and normalized names. Credit to LastRound AI. A snapshot goes stale, and some boards will be closed.

I packaged the above, plus filters (title, location, workplace type, salary floor), an only-new mode and Personio and Teamtailor feeds, as an Apify Actor: https://apify.com/duytrinh98/career-site-jobs . It is pay per saved job. You need an Apify account to run it, and free accounts can try it. If you only need one or two boards, the script above is enough.

Questions, bug reports and board URLs that do not work are welcome in the comments or in the Actor's Issues tab.

── more in #developer-tools 4 stories · sorted by recency
── more on @greenhouse 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/public-job-board-end…] indexed:0 read:5min 2026-11-16 · —