Integration with Workable public jobs API

Published July 1, 2026・Last updated July 1, 2026・4 min read

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

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[]:

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);
}

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),
);

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);
}

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,
  };
}

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();