# Workable Jobs Scraper (`khadinakbar/workable-jobs-scraper`) Actor Extract current public Workable job boards by company slug or careers URL. Returns validated job records with titles, locations, departments, salaries, descriptions, application URLs, and source provenance. - **URL**: https://apify.com/khadinakbar/workable-jobs-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Jobs, Lead generation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 validated workable job returneds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Workable Jobs Scraper returns one structured dataset record for each current public job opening on a specified Workable company board. Give it a company slug or public `apply.workable.com` URL to collect titles, departments, locations, salary text, workplace type, optional description-level content, application URLs, and source URLs for traceable recruiting or job-market analysis. ### Best fit - Use this actor when you already know employers that use Workable and need their current public openings in a consistent dataset. - Pass one or more employer slugs or Workable careers URLs, then use title, location, or department filters before a record is written and billed. - This focused public-board workflow complements dedicated tools for employer discovery, candidate records, applications, and interview data. ### Focused standalone workflow This actor is designed as a focused standalone workflow for teams that already have a selected employer list and need a source-linked Workable job dataset. It works as a focused standalone workflow because each call starts with explicit public company boards, applies filters before the dataset write, and preserves the listing and detail sources alongside the result. ### From employer list to recruiting signal A talent-intelligence team maintains a list of competitors with Workable career boards. They pass those employers with an engineering and remote filter. The actor returns `title`, `location`, `department`, `workplaceType`, `postedAt`, `applyUrl`, and source provenance; the team can compare role mix, keep a current hiring watchlist, or route an opening into a job-matching workflow. ### Quick start ```json { "companies": ["recurly", "https://apply.workable.com/platzi/"], "maxJobsPerCompany": 25, "titleIncludes": "engineer", "locationIncludes": "remote", "departmentIncludes": "engineering", "includeDescriptions": true } ```` `companies` accepts raw Workable slugs and public Workable careers URLs. `maxJobsPerCompany` is a per-employer collection boundary; the actor deliberately uses Workable's bounded public listing route rather than making unbounded requests. ### What data you receive Every dataset row is one public job post. The fields keep source and collection context beside the business data. | Field | Meaning | | --- | --- | | `jobId`, `companySlug`, `companyName` | Public job identity and employer context. | | `title`, `location`, `department`, `employmentType` | Role fields for filtering and analysis. | | `workplaceType`, `salary`, `postedAt` | Public work-model, compensation, and freshness signals when exposed. | | `descriptionText`, `requirementsText`, `benefitsText` | Detail-page content when enabled. | | `applyUrl`, `jobUrl`, `sourceListingUrl`, `scrapedAt` | Direct application path and provenance. | ```json { "jobId": "54B48C70F0", "title": "Staff Software Engineer", "companyName": "Recurly", "companySlug": "recurly", "location": "MedellΓ­n, Colombia (Hybrid)", "department": "Engineering", "employmentType": "Full-time", "workplaceType": "hybrid", "descriptionText": "We're looking for a Staff Full-Stack Engineer...", "applyUrl": "https://apply.workable.com/recurly/j/54B48C70F0/apply", "jobUrl": "https://apply.workable.com/recurly/jobs/view/54B48C70F0.md", "sourceDetailUrl": "https://apply.workable.com/recurly/jobs/view/54B48C70F0.md", "sourceListingUrl": "https://apply.workable.com/recurly/jobs.md?query=a", "postedAt": null } ``` ### API and agent use ```bash curl -X POST "https://api.apify.com/v2/acts/khadinakbar~workable-jobs-scraper/runs" \ -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"companies":["recurly"],"maxJobsPerCompany":25,"includeDescriptions":true}' ``` For an AI agent workflow through Apify MCP, use this prompt: > Collect up to 25 public engineering jobs from the Workable company board `recurly`. Return title, location, department, workplace type, direct application URL, posted timestamp, and source URLs. Preserve the actor outcome and provenance in the final analysis. The actor is read-only. It returns its data in the default dataset, a compact `OUTPUT` contract, and a detailed `RUN_SUMMARY` diagnostic record. `INVALID_INPUT` and valid empty matches succeed truthfully; a completely inaccessible board fails as `UPSTREAM_FAILED`, while useful partial records are retained as `PARTIAL`. ### Pricing and boundaries This actor uses Pay per event plus Apify platform usage. A validated job written to the dataset costs **$0.004 per job**; filtering happens before writing and no record is charged before it is persisted. The actor-start event is **$0.00005**. For a bounded 25-record run, event charges are at most **25 records Γ— $0.004 + $0.00005 = $0.10005**, plus Apify platform usage. Workable's public listing route is bounded, and `maxJobsPerCompany` makes the collection and event-cost ceiling explicit. The live Pricing tab is the source of truth for current event pricing and platform-usage details. ### Limits and recovery The public Workable Markdown listing route returns a bounded current listing, so each company is capped at 30 returned records and no unverified pagination is attempted. If a board is temporarily unavailable, retry later with the same public company slug; if a detail page is unavailable after a listing is collected, the actor preserves the useful listing fields and reports a `PARTIAL` outcome. Use the `OUTPUT` and `RUN_SUMMARY` records to distinguish a valid empty filter result from an unavailable public board. ### Freshness and provenance The implementation uses Workable's public `jobs.md` listing and matching job-detail Markdown routes. `sourceListingUrl`, `sourceDetailUrl`, `postedAt`, and `scrapedAt` are persisted so downstream users can verify the source and collection time for every job record. ### Best results - Start from selected employers that visibly host their careers board on Workable. - Set `includeDescriptions` to false for a compact role inventory; keep it on when requirements and benefit text matter. - Preserve `sourceListingUrl`, `sourceDetailUrl`, and `scrapedAt` in downstream reporting so others can verify the public record. - Schedule a focused repeat collection for hiring monitoring and compare `postedAt` with `scrapedAt` rather than treating a single run as a permanent record. ### Builder's note I designed this actor around Workable's public Markdown routes because the listing and job-detail responses are stable, compact, and source-addressable. Keeping a listing source, detail source, direct application URL, and machine-readable run outcome in the same contract makes the data useful to both recruiters and agents without exposing private ATS data. ### Responsible use Use publicly available or authorized data in accordance with applicable laws, source terms, and your organization's data-governance policies. Keep source URLs with shared records so recipients can review the employer's current public posting. # Actor input Schema ## `companies` (type: `array`): Enter one Workable company slug or public careers URL per line, such as recurly or https://apply.workable.com/recurly/. The actor extracts up to 25 unique slugs. This is required and is not an arbitrary company website, login page, individual application form, or private ATS URL. ## `maxJobsPerCompany` (type: `integer`): Caps validated job records returned for each Workable company board. Enter an integer such as 25. It defaults to 30 and accepts 1 through 30 because Workable's current public Markdown listing route returns a bounded set. This is a per-company result cap, not a page count or global collection budget. ## `searchQuery` (type: `string`): Optional text passed to Workable's public jobs listing route, for example engineer. Use it to narrow a large board before extraction. Leave blank to request the board's current public listing. This is not a Boolean expression or a cross-company Workable search. ## `titleIncludes` (type: `string`): Optionally retain only jobs whose public title contains this text, such as engineer. Matching is case-insensitive literal text and happens before a dataset record is written or billed. Leave blank to keep all titles. This does not search private application data or description text. ## `locationIncludes` (type: `string`): Optionally retain only jobs whose public Workable location contains this text, such as remote or london. Matching is case-insensitive literal text against the board's location column. Leave blank to keep all locations. This does not geocode roles or search office addresses. ## `departmentIncludes` (type: `string`): Optionally retain only jobs whose public Workable department contains this text, such as engineering. Matching is case-insensitive literal text and occurs before write and billing. Leave blank to keep all departments. This does not infer departments from a description. ## `includeDescriptions` (type: `boolean`): Controls whether the actor reads each matched public Workable job detail route for description, requirements, benefits, workplace type, and apply URL. Set false for a smaller, faster listing-level dataset. It defaults to true. This does not access candidates, hiring notes, or application answers. ## Actor input object example ```json { "companies": [ "recurly", "https://apply.workable.com/platzi/" ], "maxJobsPerCompany": 25, "searchQuery": "engineer", "titleIncludes": "engineer", "locationIncludes": "remote", "departmentIncludes": "engineering", "includeDescriptions": true } ``` # Actor output Schema ## `jobs` (type: `string`): Validated public Workable job records returned by this run. ## `output` (type: `string`): Compact outcome, item counts, warnings, and charged event totals. ## `runSummary` (type: `string`): Detailed board coverage, source diagnostics, and billing information for this run. # 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": [ "recurly" ], "maxJobsPerCompany": 30, "searchQuery": "", "titleIncludes": "", "locationIncludes": "", "departmentIncludes": "", "includeDescriptions": true }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/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": ["recurly"], "maxJobsPerCompany": 30, "searchQuery": "", "titleIncludes": "", "locationIncludes": "", "departmentIncludes": "", "includeDescriptions": True, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/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": [ "recurly" ], "maxJobsPerCompany": 30, "searchQuery": "", "titleIncludes": "", "locationIncludes": "", "departmentIncludes": "", "includeDescriptions": true }' | apify call khadinakbar/workable-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/workable-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Workable Jobs Scraper", "description": "Extract current public Workable job boards by company slug or careers URL. Returns validated job records with titles, locations, departments, salaries, descriptions, application URLs, and source provenance.", "version": "1.0", "x-build-id": "9G75BNrHaGpgk8rVp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~workable-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~workable-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~workable-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": "Workable company slugs or careers URLs", "type": "array", "description": "Enter one Workable company slug or public careers URL per line, such as recurly or https://apply.workable.com/recurly/. The actor extracts up to 25 unique slugs. This is required and is not an arbitrary company website, login page, individual application form, or private ATS URL.", "items": { "type": "string" } }, "maxJobsPerCompany": { "title": "Maximum jobs per company", "minimum": 1, "maximum": 30, "type": "integer", "description": "Caps validated job records returned for each Workable company board. Enter an integer such as 25. It defaults to 30 and accepts 1 through 30 because Workable's current public Markdown listing route returns a bounded set. This is a per-company result cap, not a page count or global collection budget.", "default": 30 }, "searchQuery": { "title": "Workable listing query", "type": "string", "description": "Optional text passed to Workable's public jobs listing route, for example engineer. Use it to narrow a large board before extraction. Leave blank to request the board's current public listing. This is not a Boolean expression or a cross-company Workable search.", "default": "" }, "titleIncludes": { "title": "Job title contains", "type": "string", "description": "Optionally retain only jobs whose public title contains this text, such as engineer. Matching is case-insensitive literal text and happens before a dataset record is written or billed. Leave blank to keep all titles. This does not search private application data or description text.", "default": "" }, "locationIncludes": { "title": "Location contains", "type": "string", "description": "Optionally retain only jobs whose public Workable location contains this text, such as remote or london. Matching is case-insensitive literal text against the board's location column. Leave blank to keep all locations. This does not geocode roles or search office addresses.", "default": "" }, "departmentIncludes": { "title": "Department contains", "type": "string", "description": "Optionally retain only jobs whose public Workable department contains this text, such as engineering. Matching is case-insensitive literal text and occurs before write and billing. Leave blank to keep all departments. This does not infer departments from a description.", "default": "" }, "includeDescriptions": { "title": "Include job descriptions", "type": "boolean", "description": "Controls whether the actor reads each matched public Workable job detail route for description, requirements, benefits, workplace type, and apply URL. Set false for a smaller, faster listing-level dataset. It defaults to true. This does not access candidates, hiring notes, or application answers.", "default": true } } }, "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 } } } } } } } } } } ```