<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Anh Duy Trịnh</title>
    <description>The latest articles on DEV Community by Anh Duy Trịnh (@anh_duytrnh_a3159496c98).</description>
    <link>https://dev.to/anh_duytrnh_a3159496c98</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4246806%2Fe454ff18-bb12-4841-b87d-3e22dd2a1abb.png</url>
      <title>DEV Community: Anh Duy Trịnh</title>
      <link>https://dev.to/anh_duytrnh_a3159496c98</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/anh_duytrnh_a3159496c98"/>
    <language>en</language>
    <item>
      <title>Public job-board endpoints of Greenhouse, Lever and Ashby, and how to normalize them</title>
      <dc:creator>Anh Duy Trịnh</dc:creator>
      <pubDate>Mon, 16 Nov 2026 05:35:48 +0000</pubDate>
      <link>https://dev.to/anh_duytrnh_a3159496c98/public-job-board-endpoints-of-greenhouse-lever-and-ashby-and-how-to-normalize-them-2h06</link>
      <guid>https://dev.to/anh_duytrnh_a3159496c98/public-job-board-endpoints-of-greenhouse-lever-and-ashby-and-how-to-normalize-them-2h06</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;This post was written by AI coding agents working on my behalf, and it is labelled AI Generated.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;You can use all of it with &lt;code&gt;fetch&lt;/code&gt; and no tool of mine. A small runnable example is at the end.&lt;/p&gt;

&lt;h2&gt;
  
  
  The three endpoints
&lt;/h2&gt;

&lt;p&gt;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 &lt;code&gt;jobs.lever.co/leverdemo&lt;/code&gt; gives &lt;code&gt;leverdemo&lt;/code&gt;. It is often not the company's marketing name.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ATS&lt;/th&gt;
&lt;th&gt;Endpoint&lt;/th&gt;
&lt;th&gt;Auth&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Greenhouse&lt;/td&gt;
&lt;td&gt;&lt;code&gt;GET https://boards-api.greenhouse.io/v1/boards/{token}/jobs&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;none for GET&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Lever&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;GET https://api.lever.co/v0/postings/{site}?mode=json&lt;/code&gt; (EU: &lt;code&gt;api.eu.lever.co&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;none for GET&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Ashby&lt;/td&gt;
&lt;td&gt;&lt;code&gt;GET https://api.ashbyhq.com/posting-api/job-board/{name}?includeCompensation=true&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;none&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;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 (&lt;code&gt;skip&lt;/code&gt;, &lt;code&gt;limit&lt;/code&gt;, &lt;code&gt;location&lt;/code&gt;, &lt;code&gt;commitment&lt;/code&gt;, &lt;code&gt;team&lt;/code&gt;, &lt;code&gt;department&lt;/code&gt;). Ashby documents one endpoint and one parameter.&lt;/p&gt;

&lt;h3&gt;
  
  
  Greenhouse
&lt;/h3&gt;

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

&lt;ul&gt;
&lt;li&gt;The plain list does not include department or description. Add &lt;code&gt;?content=true&lt;/code&gt; to get the description, department and offices, or call &lt;code&gt;/departments&lt;/code&gt; and join on job id.&lt;/li&gt;
&lt;li&gt;Pay ranges are not in the list. The docs describe &lt;code&gt;pay_transparency=true&lt;/code&gt; on the single-job endpoint, &lt;code&gt;GET /jobs/{id}&lt;/code&gt;, which means one extra request per job.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Lever
&lt;/h3&gt;

&lt;p&gt;The response is a bare JSON array. Useful fields: &lt;code&gt;id&lt;/code&gt;, &lt;code&gt;text&lt;/code&gt; (the title), &lt;code&gt;categories&lt;/code&gt; (&lt;code&gt;location&lt;/code&gt;, &lt;code&gt;commitment&lt;/code&gt;, &lt;code&gt;team&lt;/code&gt;, &lt;code&gt;department&lt;/code&gt;, &lt;code&gt;allLocations&lt;/code&gt;), &lt;code&gt;country&lt;/code&gt;, &lt;code&gt;workplaceType&lt;/code&gt; (&lt;code&gt;on-site&lt;/code&gt;, &lt;code&gt;remote&lt;/code&gt;, &lt;code&gt;hybrid&lt;/code&gt; or &lt;code&gt;unspecified&lt;/code&gt;), &lt;code&gt;createdAt&lt;/code&gt; in milliseconds since the epoch, &lt;code&gt;hostedUrl&lt;/code&gt;, &lt;code&gt;applyUrl&lt;/code&gt;, and an optional &lt;code&gt;salaryRange&lt;/code&gt; with &lt;code&gt;currency&lt;/code&gt;, &lt;code&gt;interval&lt;/code&gt;, &lt;code&gt;min&lt;/code&gt; and &lt;code&gt;max&lt;/code&gt;. Descriptions come both as HTML and as plain text.&lt;/p&gt;

&lt;h3&gt;
  
  
  Ashby
&lt;/h3&gt;

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

&lt;h2&gt;
  
  
  Gotchas I hit
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Unknown boards return 404&lt;/strong&gt; on all three today (Greenhouse &lt;code&gt;{"status":404,"error":"Job not found"}&lt;/code&gt;, Lever &lt;code&gt;{"ok":false,"error":"Document not found"}&lt;/code&gt;, Ashby plain &lt;code&gt;Not Found&lt;/code&gt;). 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.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sizes differ a lot.&lt;/strong&gt; On the day I tested, one large Greenhouse board returned about 490 KB for its list without descriptions, and Ashby's own board with compensation was about 4.5 MB. Cache by board and do not refetch on every user request.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Timestamps differ.&lt;/strong&gt; Greenhouse and Ashby give ISO strings, Lever gives milliseconds. Convert to ISO 8601 UTC and keep &lt;code&gt;null&lt;/code&gt; when a source gives nothing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Salary is rarely present&lt;/strong&gt;, and it comes in source currency and period. Do not compare numbers across currencies.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Be polite.&lt;/strong&gt; Lever's &lt;code&gt;robots.txt&lt;/code&gt; on &lt;code&gt;api.lever.co&lt;/code&gt; states &lt;code&gt;Crawl-delay: 1&lt;/code&gt;. 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.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What I left out, and why
&lt;/h2&gt;

&lt;p&gt;I looked at three more systems and decided not to call them:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;SmartRecruiters.&lt;/strong&gt; &lt;code&gt;https://api.smartrecruiters.com/robots.txt&lt;/code&gt; on 2026-11-16 allows one named bot on &lt;code&gt;/v1/companies/&lt;/code&gt; and says &lt;code&gt;User-agent: *&lt;/code&gt; then &lt;code&gt;Disallow: /&lt;/code&gt;. A generic client is told to stay away, so I do not call it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Breezy HR.&lt;/strong&gt; The robots file on &lt;code&gt;breezy.hr&lt;/code&gt; disallows &lt;code&gt;/api/&lt;/code&gt;, and its terms of service prohibit accessing the service by means other than its publicly supported interfaces.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Workday.&lt;/strong&gt; Its job sites use an undocumented, per-tenant POST interface, and the site terms restrict scraping. Leaving it out is a judgment call. Check Workday's terms yourself if you need it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  A normalized schema
&lt;/h2&gt;

&lt;p&gt;Every record gets the same keys, and unknown values stay &lt;code&gt;null&lt;/code&gt;. I never invent a value. A salary of &lt;code&gt;0&lt;/code&gt; becomes &lt;code&gt;null&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"ats"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"lever"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"companySlug"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"leverdemo"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"jobId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ad208490-4052-4f91-a57e-433f2d1e484b"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"title"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Customer Success Manager"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"location"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Atlanta, Georgia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"department"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Customer Success"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"workplaceType"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"hybrid"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"postedAt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"2026-08-31T18:12:19.703Z"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"salaryMin"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;85000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"salaryMax"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;175000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"salaryCurrency"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"USD"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"https://jobs.lever.co/leverdemo/ad208490-4052-4f91-a57e-433f2d1e484b"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Design choices that matter later:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;A stable global id&lt;/strong&gt;, &lt;code&gt;ats:companySlug:jobId&lt;/code&gt;. Job ids alone collide across vendors.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keep the source label next to the normalized one.&lt;/strong&gt; Employment types arrive as &lt;code&gt;FullTime&lt;/code&gt;, &lt;code&gt;Regular Full Time (Salary)&lt;/code&gt; or nothing. Map the ones you recognize to &lt;code&gt;full_time&lt;/code&gt;, &lt;code&gt;part_time&lt;/code&gt;, &lt;code&gt;contract&lt;/code&gt; and so on, and keep the raw text too.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;remote&lt;/code&gt; is tri-state.&lt;/strong&gt; &lt;code&gt;true&lt;/code&gt;, &lt;code&gt;false&lt;/code&gt; or &lt;code&gt;null&lt;/code&gt;. Treat "hybrid" as not remote, and treat "unknown" as unknown.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No guessing.&lt;/strong&gt; If a source has no department, the field is &lt;code&gt;null&lt;/code&gt;, even if you could guess from the title.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Try it without my tool
&lt;/h2&gt;

&lt;p&gt;This short Node script (no dependencies, Node 18+) fetches one board and prints one normalized JSON record per line. It is in this repository: &lt;a href="https://github.com/anhduyhaha1234-droid/job-board-endpoints" rel="noopener noreferrer"&gt;https://github.com/anhduyhaha1234-droid/job-board-endpoints&lt;/a&gt; .&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;node normalize.mjs greenhouse stripe
node normalize.mjs lever leverdemo
node normalize.mjs ashby ashby
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;On 2026-11-16 these returned 785, 10 and 77 records. Those counts change daily.&lt;/p&gt;

&lt;h2&gt;
  
  
  Finding board tokens
&lt;/h2&gt;

&lt;p&gt;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): &lt;a href="https://lastroundai.com/blog/salary-transparency-study-2026" rel="noopener noreferrer"&gt;https://lastroundai.com/blog/salary-transparency-study-2026&lt;/a&gt; . I converted the CSV to compact JSON and normalized names. Credit to LastRound AI. A snapshot goes stale, and some boards will be closed.&lt;/p&gt;

&lt;h2&gt;
  
  
  If you would rather not write the loop
&lt;/h2&gt;

&lt;p&gt;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: &lt;a href="https://apify.com/duytrinh98/career-site-jobs" rel="noopener noreferrer"&gt;https://apify.com/duytrinh98/career-site-jobs&lt;/a&gt; . 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.&lt;/p&gt;

&lt;p&gt;Questions, bug reports and board URLs that do not work are welcome in the comments or in the Actor's Issues tab.&lt;/p&gt;

</description>
      <category>api</category>
      <category>webdev</category>
      <category>javascript</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
