# Workable Jobs Scraper (FreshActors) (`freshactors/workable-jobs-scraper`) Actor Reliable, always-fresh job postings from any Workable company board. Public JSON, no login, full descriptions in one call. Monitored daily. By FreshActors. - **URL**: https://apify.com/freshactors/workable-jobs-scraper.md - **Developed by:** [Martin Čech](https://apify.com/freshactors) (community) - **Categories:** Jobs, Lead generation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 company jobs fetcheds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Workable Jobs Scraper — Every Company Board as Clean JSON (No API Key) Scrape **Workable ATS job postings** from any company's public board into clean, structured JSON — title, full description, location, department, employment type, remote/hybrid flag, and apply URL. No account, no login, no API key. Point it at a list of Workable companies and get a normalized jobs feed back. > ✅ **Last verified working: 2026-06-02.** Monitored by an automated daily canary. When Workable changes its board API, we patch fast and log it in the changelog below — so your hiring-data pipeline doesn't silently break. --- ### Why this Workable scraper Most job scrapers go stale and break the moment an ATS tweaks a response — and the worst ones **silently return nothing** instead of erroring. When the feed behind your sourcing tool or dashboard quietly dies, you find out from your boss, not your logs. This one is built to **stay working**: - **Whole board in one request.** Workable's public widget API returns every open role for a company — **including the full job description** — in a single call. That keeps runs fast, cheap, and reliable (one HTTP request per company, no per-job round-trips). - **One normalized schema.** Every posting comes back as the same stable job record as our [Greenhouse & Lever scraper](https://apify.com/freshactors/greenhouse-lever-jobs-scraper), so you can query Workable companies the same way you query the rest of your ATS coverage — no special-case parsing. - **Per-company isolation + retries.** A dead, renamed, or private board is skipped and logged — it never crashes the whole run. Transient errors retry with backoff. - **Stable, versioned output** (`_schemaVersion` on every record) — fields don't silently disappear between runs. - **Monitored daily.** A canary scrapes a known live board every day and writes a pass/fail status; that "last verified working" date is real, not decorative. The moat here isn't a trick — it's **operational reliability**. This scraper is maintained to keep working, which is the one thing a hiring-data pipeline actually needs. ### What data you get Each row is one normalized job posting. Fields Workable doesn't provide come back as `null` rather than disappearing, so your downstream schema stays predictable. | Field | Type | Description | |---|---|---| | `_type` | string | Always `job`. | | `_schemaVersion` | string | Output schema version. | | `_source` | string | Always `workable`. | | `company` | string | Workable shortcode / company slug. | | `jobId` | string | Workable posting shortcode (unique per role). | | `title` | string | Job title. | | `department` | string \| null | Department. | | `team` | string \| null | Function (e.g. "Engineering", "Sales"). | | `location` | string \| null | Primary location (city, country). | | `allLocations` | string[] \| null | All listed locations. | | `workplaceType` | string \| null | `remote` where the role is telecommuting. | | `commitment` | string \| null | Employment type (full-time, contract, …) where set. | | `country` | string \| null | Country. | | `url` | string | Public posting URL. | | `applyUrl` | string \| null | Direct apply URL. | | `postedAt` | string \| null | Publish date. | | `descriptionText` | string \| null | Full description text (when `includeDescription` is on). | | `_scrapedAt` | string | ISO timestamp this record was fetched. | ### Use cases - **Sales intelligence / hiring-signal tracking.** Watch which companies are hiring for which roles — a leading indicator of growth, new initiatives, and budget. Feed `department`, `team`, `location`, and `postedAt` into your lead-scoring or intent model. Searching for a *Workable jobs API* to power hiring-intent data? This is the structured feed. - **Recruiting & talent sourcing.** Aggregate live openings across dozens of target employers into one table; filter by `workplaceType: remote` or `commitment` without writing a Workable-specific adapter. - **Job boards & aggregators.** Building a niche board and need to *scrape Workable jobs* into a uniform feed? Point the actor at your company list and ingest normalized records on a schedule. - **Labor-market & VC research.** Track headcount-growth signals across a portfolio. `postedAt` gives you a clean time series of when roles open across companies — no manual board-watching. ### Input | Field | Type | Required | Notes | |---|---|---|---| | `companies` | string[] | ✅ | Workable shortcodes (`pearltalent`) or board URLs (`https://apply.workable.com/pearltalent/`). One per row. The shortcode is the slug in the company's `apply.workable.com` careers URL. | | `includeDescription` | boolean | — | Include the full description text per posting. Default `true`. | | `maxJobsPerCompany` | integer | — | Cap per company (1–5000). Default `1000`. | ```json { "companies": ["pearltalent", "https://apply.workable.com/walletconnect/"], "includeDescription": true, "maxJobsPerCompany": 1000 } ```` ### Output sample ```json { "_type": "job", "_schemaVersion": "1.0", "_source": "workable", "company": "walletconnect", "jobId": "2EB3D29E9B", "title": "Product Manager - Merchant Experience", "department": "Product", "team": null, "location": "United Kingdom", "allLocations": ["United Kingdom", "Portugal"], "workplaceType": "remote", "commitment": null, "country": "United Kingdom", "url": "https://apply.workable.com/j/2EB3D29E9B", "applyUrl": "https://apply.workable.com/j/2EB3D29E9B/apply", "postedAt": "2026-04-27", "updatedAt": null, "descriptionText": "About the role...", "_scrapedAt": "2026-06-02T16:40:46.908Z" } ``` ### Use with AI agents (MCP) This scraper is callable as a tool by AI agents via the **[Apify MCP server](https://mcp.apify.com)** — so assistants like **Claude, Cursor, and VS Code** can run it and use the structured results mid-conversation, with no glue code. Simplest path: in a recent **Claude Desktop**, add the hosted server `https://mcp.apify.com` under **Settings → Connectors** and authorize with OAuth. For any config-file client: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server"], "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" } } } } ``` Then ask in plain language, e.g. *"List the open jobs at pearltalent and walletconnect from their Workable boards with titles, locations, and apply links."* — the agent calls **`freshactors/workable-jobs-scraper`** with the right input and reads back the JSON. Full setup: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp). ### Pricing Pay-per-event — **no subscription**. You pay only for the boards you fetch and the postings you receive: | Event | Price (USD) | When it fires | |---|---|---| | **Company jobs fetched** | **$0.02** | Once per company board successfully fetched (with ≥1 open job). | | **Job posting fetched** | **$0.0005** | Once per job posting returned. | **Worked example — "how much do 100 results cost?"** Scrape **5 companies** for **100 postings** total: - Boards: 5 × $0.02 = **$0.10** - Postings: 100 × $0.0005 = **$0.05** - **Total: $0.15** for 100 normalized jobs across 5 companies. Because one request returns the whole board *with* descriptions, runs are fast and cheap. (Apify platform usage is billed separately per their standard rates.) ### FAQ **Is scraping Workable jobs legal?** This actor reads **public, non-personal** job-posting data from companies' own public Workable boards — the same data their careers pages serve to any visitor. No login, no personal data. Use responsibly and in line with applicable terms and laws. **Do I need an API key?** No. There's no Workable API key, account, or login. You provide a list of company shortcodes or board URLs and the actor reads their public JSON boards. **How do I find a company's Workable shortcode?** It's the slug in their careers URL — `apply.workable.com/**pearltalent**/`. You can paste either the bare shortcode or the full URL. **Does it include full job descriptions?** Yes — `includeDescription` defaults to `true`, and each posting includes `descriptionText`. One request returns the whole board with descriptions inline; turn it off for leaner, faster output. **Can I scrape many companies at once?** Yes — pass as many shortcodes/URLs in `companies` as you need. Each board is fetched in isolation; a dead or private board is skipped rather than failing the run. Use `maxJobsPerCompany` (1–5000) to cap per-company volume. **What if a company has no open roles?** The board is fetched and returns an empty result for that company — no jobs, no charge for that company. Your run continues. **How often is the data updated?** It's live — every run fetches the companies' current public boards in real time. The actor itself is monitored by a daily canary so parsing stays correct as Workable's board API evolves. ### Other FreshActors tools | FreshActors actor | What it scrapes | |---|---| | [Greenhouse & Lever Jobs Scraper](https://apify.com/freshactors/greenhouse-lever-jobs-scraper) | Greenhouse + Lever — normalized job postings | | [App Store Scraper](https://apify.com/freshactors/app-store-scraper) | Apple App Store — app details, search, reviews | | [Google Play Scraper](https://apify.com/freshactors/google-play-scraper) | Google Play — app details + reviews | | [Shopify App Store Scraper](https://apify.com/freshactors/shopify-app-store-scraper) | Shopify App Store — app details, reviews, discovery | | [Redfin Scraper](https://apify.com/freshactors/redfin-scraper) | Redfin — US real-estate listings | ### Reliability Staying fresh is the whole point of FreshActors. A scheduled **daily canary** scrapes a known Workable board, validates the normalized schema, and alerts the moment a parse changes. When Workable shifts its board API, we patch the same day and record it in the changelog below. Every record is stamped with `_schemaVersion` and `_scrapedAt` so you always know what shape you're consuming and when it was fetched. **Changelog** - **2026-06-02** — v1.0 launch. Per-company Workable boards, full descriptions in one call, normalized schema, per-company isolation, daily canary monitoring. **Legal note:** Reads public, non-personal job-posting data from companies' own public Workable boards (the same data their careers pages serve). No login, no personal data. Use responsibly and in line with applicable terms and laws. *Found a problem? Open an issue on the actor — issues are answered fast.* # Actor input Schema ## `companies` (type: `array`): Workable company shortcodes (e.g. pearltalent) or board URLs (e.g. https://apply.workable.com/pearltalent/). One per row. The shortcode is the slug in the company's apply.workable.com careers URL. ## `includeDescription` (type: `boolean`): Include the full job description text in each record. One request returns the board either way; turn off for leaner, faster output. ## `maxJobsPerCompany` (type: `integer`): Cap on postings returned per company (1–5000). ## Actor input object example ```json { "companies": [ "pearltalent", "walletconnect" ], "includeDescription": true, "maxJobsPerCompany": 1000 } ``` # Actor output Schema ## `results` (type: `string`): Normalized job postings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "companies": [ "pearltalent", "walletconnect" ] }; // Run the Actor and wait for it to finish const run = await client.actor("freshactors/workable-jobs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "companies": [ "pearltalent", "walletconnect", ] } # Run the Actor and wait for it to finish run = client.actor("freshactors/workable-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "companies": [ "pearltalent", "walletconnect" ] }' | apify call freshactors/workable-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=freshactors/workable-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Workable Jobs Scraper (FreshActors)", "description": "Reliable, always-fresh job postings from any Workable company board. Public JSON, no login, full descriptions in one call. Monitored daily. By FreshActors.", "version": "1.0", "x-build-id": "0D2Mii0FCg0RPbuTC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/freshactors~workable-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-freshactors-workable-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/freshactors~workable-jobs-scraper/runs": { "post": { "operationId": "runs-sync-freshactors-workable-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/freshactors~workable-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-freshactors-workable-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "Workable company shortcodes (e.g. pearltalent) or board URLs (e.g. https://apply.workable.com/pearltalent/). One per row. The shortcode is the slug in the company's apply.workable.com careers URL.", "items": { "type": "string" } }, "includeDescription": { "title": "Include full descriptions", "type": "boolean", "description": "Include the full job description text in each record. One request returns the board either way; turn off for leaner, faster output.", "default": true }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on postings returned per company (1–5000).", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```