Workable is an ATS with a public careers layer you can read without authentication. The widget-style JSON endpoint powers Workable-hosted career sites and embeddable job widgets.
This post shows how to list published jobs for one Workable account, request full descriptions, and normalize location and remote fields. For other ATS public feeds, see the Ashby, Greenhouse, and Lever posts.
Workable’s authenticated REST API v3 (https://{subdomain}.workable.com/spi/v3/) requires a bearer token and is meant for HR integrations, not public job aggregation.
Prerequisites
Node.js version 26
A company’s Workable account slug (see below)
No API key required for the public widget endpoint
Find the account slug
Workable career pages use URLs like https://apply.workable.com/{account_slug}/ or legacy https://{account_slug}.workable.com/. The slug is the account identifier in API paths.
Examples: huggingface for Hugging Face, flosum for Flosum.
API overview
Item
Value
Jobs (with details)
GET https://www.workable.com/api/accounts/{slug}?details=true
Locations
GET …/accounts/{slug}/locations
Departments
GET …/accounts/{slug}/departments
Auth
None
Format
JSON
Node fetch may follow a redirect to https://apply.workable.com/api/v1/widget/accounts/{slug}?details=true; both URLs return the same payload.
Set details=true to include description and full_description on each job. Without it you get summary fields only.
Common fields on each job in jobs():
Field
Description
title
Job title
url, shortlink
Apply links
location, locations
Structured location objects
experience
Seniority label (for example Mid-Senior level)
published_on, created_at
Timestamps
state
On public feeds this is often a region name, not listing status – prefer published_on to detect live roles
Basic integration
const accountSlug = process.env.WORKABLE_ACCOUNT_SLUG ?? ‘huggingface’;
const url = new URL(
`https://www.workable.com/api/accounts/${encodeURIComponent(accountSlug)}`,
);
url.searchParams.set(‘details’, ‘true’);
const response = await fetch(url);
if (!response.ok) {
throw new Error(`Workable API ${response.status}: ${response.statusText}`);
}
const data = await response.json();
for (const job of data.jobs ?? ()) {
console.log(job.title, ‘-‘, job.location?.location_str, ‘-‘, job.url);
}
Enter fullscreen mode
Exit fullscreen mode
Keep only published listings:
function isPublished(job) {
if (job.published_on?.trim()) return true;
return !job.state || job.state === ‘published’;
}
const publicJobs = (data.jobs ?? ()).filter(
(job) => job.title && (job.url || job.shortlink) && isPublished(job),
);
Enter fullscreen mode
Exit fullscreen mode
Locations and remote detection
Prefer location.location_str when present. Otherwise build a label from structured fields:
function stringifyLocation(entry) {
const city = entry.city?.trim();
const region = entry.state_code?.trim() || entry.region?.trim();
const country = entry.country_name?.trim() || entry.country?.trim();
if (city && region && country) return `${city}, ${region}, ${country}`;
if (city && country) return `${city}, ${country}`;
return country || city || ”;
}
function resolveLocation(job) {
const primary = job.location?.location_str?.trim();
if (primary) return primary;
const parts = (job.locations ?? ())
.map(stringifyLocation)
.filter(Boolean);
return parts.join(‘ / ‘) || ‘Unknown’;
}
function isRemoteJob(job, locationLabel) {
const structured =
Boolean(job.location?.telecommuting) ||
job.location?.workplace_type?.toLowerCase() === ‘remote’ ||
(job.locations ?? ()).some(
(loc) =>
Boolean(loc.telecommuting) ||
loc.workplace_type?.toLowerCase() === ‘remote’,
);
return structured || /remote/i.test(locationLabel);
}
Enter fullscreen mode
Exit fullscreen mode
Normalize to a stable shape
function normalizeWorkableJob(job, companyName) {
const location = resolveLocation(job);
const description = `${job.description ?? ”} ${job.full_description ?? ”}`.trim();
return {
id: job.id ?? job.shortcode,
title: job.title.trim(),
company: companyName,
location,
isRemote: isRemoteJob(job, location),
url: job.url || job.shortlink,
postedAt: job.created_at
? new Date(job.created_at)
: job.published_on
? new Date(job.published_on)
: null,
experience: job.experience ?? null,
description,
};
}
Enter fullscreen mode
Exit fullscreen mode
Optional companion calls enrich filters:
const (locationsRes, departmentsRes) = await Promise.all((
fetch(`https://www.workable.com/api/accounts/${accountSlug}/locations`),
fetch(`https://www.workable.com/api/accounts/${accountSlug}/departments`),
));
const { locations } = await locationsRes.json();
const { departments } = await departmentsRes.json();
Enter fullscreen mode
Exit fullscreen mode
Need help with your project?
Get personalized advice on your architecture, code, or career in a 45-minute 1-on-1 consultation.
→ Book a consultation
