Workable public jobs API와 통합

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