\n
\n 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.<\/p>\n
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.<\/p>\n
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.<\/p>\n
Prerequisites<\/p>\n
Node.js version 26
\nA company’s Workable account slug (see below)
\nNo API key required for the public widget endpoint<\/p>\n
Find the account slug<\/p>\n
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.<\/p>\n
Examples: huggingface for Hugging Face, flosum for Flosum.<\/p>\n
API overview<\/p>\n
Item
\nValue<\/p>\n
Jobs (with details)
\nGET https:\/\/www.workable.com\/api\/accounts\/{slug}?details=true<\/p>\n
Locations
\nGET …\/accounts\/{slug}\/locations<\/p>\n
Departments
\nGET …\/accounts\/{slug}\/departments<\/p>\n
Auth
\nNone<\/p>\n
Format
\nJSON<\/p>\n
Node fetch may follow a redirect to https:\/\/apply.workable.com\/api\/v1\/widget\/accounts\/{slug}?details=true; both URLs return the same payload.<\/p>\n
Set details=true to include description and full_description on each job. Without it you get summary fields only.<\/p>\n
Common fields on each job in jobs():<\/p>\n
Field
\nDescription<\/p>\n
title
\nJob title<\/p>\n
url, shortlink<\/p>\n
Apply links<\/p>\n
location, locations<\/p>\n
Structured location objects<\/p>\n
experience
\nSeniority label (for example Mid-Senior level)<\/p>\n
published_on, created_at<\/p>\n
Timestamps<\/p>\n
state
\nOn public feeds this is often a region name, not listing status – prefer published_on to detect live roles<\/p>\n
Basic integration<\/p>\n
const accountSlug = process.env.WORKABLE_ACCOUNT_SLUG ?? ‘huggingface’;
\nconst url = new URL(
\n `https:\/\/www.workable.com\/api\/accounts\/${encodeURIComponent(accountSlug)}`,
\n);
\nurl.searchParams.set(‘details’, ‘true’);<\/p>\n
const response = await fetch(url);<\/p>\n
if (!response.ok) {
\n throw new Error(`Workable API ${response.status}: ${response.statusText}`);
\n}<\/p>\n
const data = await response.json();<\/p>\n
for (const job of data.jobs ?? ()) {
\n console.log(job.title, ‘-‘, job.location?.location_str, ‘-‘, job.url);
\n}<\/p>\n
Enter fullscreen mode<\/p>\n
Exit fullscreen mode<\/p>\n
Keep only published listings:<\/p>\n
function isPublished(job) {
\n if (job.published_on?.trim()) return true;
\n return !job.state || job.state === ‘published’;
\n}<\/p>\n
const publicJobs = (data.jobs ?? ()).filter(
\n (job) => job.title && (job.url || job.shortlink) && isPublished(job),
\n);<\/p>\n
Enter fullscreen mode<\/p>\n
Exit fullscreen mode<\/p>\n
Locations and remote detection<\/p>\n
Prefer location.location_str when present. Otherwise build a label from structured fields:<\/p>\n
function stringifyLocation(entry) {
\n const city = entry.city?.trim();
\n const region = entry.state_code?.trim() || entry.region?.trim();
\n const country = entry.country_name?.trim() || entry.country?.trim();<\/p>\n
if (city && region && country) return `${city}, ${region}, ${country}`;
\n if (city && country) return `${city}, ${country}`;
\n return country || city || ”;
\n}<\/p>\n
function resolveLocation(job) {
\n const primary = job.location?.location_str?.trim();
\n if (primary) return primary;<\/p>\n
const parts = (job.locations ?? ())
\n .map(stringifyLocation)
\n .filter(Boolean);<\/p>\n
return parts.join(‘ \/ ‘) || ‘Unknown’;
\n}<\/p>\n
function isRemoteJob(job, locationLabel) {
\n const structured =
\n Boolean(job.location?.telecommuting) ||
\n job.location?.workplace_type?.toLowerCase() === ‘remote’ ||
\n (job.locations ?? ()).some(
\n (loc) =>
\n Boolean(loc.telecommuting) ||
\n loc.workplace_type?.toLowerCase() === ‘remote’,
\n );<\/p>\n
return structured || \/remote\/i.test(locationLabel);
\n}<\/p>\n
Enter fullscreen mode<\/p>\n
Exit fullscreen mode<\/p>\n
Normalize to a stable shape<\/p>\n
function normalizeWorkableJob(job, companyName) {
\n const location = resolveLocation(job);
\n const description = `${job.description ?? ”} ${job.full_description ?? ”}`.trim();<\/p>\n
return {
\n id: job.id ?? job.shortcode,
\n title: job.title.trim(),
\n company: companyName,
\n location,
\n isRemote: isRemoteJob(job, location),
\n url: job.url || job.shortlink,
\n postedAt: job.created_at
\n ? new Date(job.created_at)
\n : job.published_on
\n ? new Date(job.published_on)
\n : null,
\n experience: job.experience ?? null,
\n description,
\n };
\n}<\/p>\n
Enter fullscreen mode<\/p>\n
Exit fullscreen mode<\/p>\n
Optional companion calls enrich filters:<\/p>\n
const (locationsRes, departmentsRes) = await Promise.all((
\n fetch(`https:\/\/www.workable.com\/api\/accounts\/${accountSlug}\/locations`),
\n fetch(`https:\/\/www.workable.com\/api\/accounts\/${accountSlug}\/departments`),
\n));<\/p>\n
const { locations } = await locationsRes.json();
\nconst { departments } = await departmentsRes.json();<\/p>\n
Enter fullscreen mode<\/p>\n
Exit fullscreen mode<\/p>\n
Need help with your project?<\/p>\n
Get personalized advice on your architecture, code, or career in a 45-minute 1-on-1 consultation.<\/p>\n
\u2192 Book a consultation<\/p>\n