{ "openapi": "3.0.1", "info": { "title": "Workable Jobs Scraper - apply.workable.com Careers, No API Key", "description": "Scrape published job postings from any apply.workable.com careers page: title, department, location, remote flag, dates, links, optional full description. New-postings-only mode. No API key.", "version": "1.0", "x-build-id": "YWDfLpffX2IGaorLr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~workable-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-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/maydit~workable-jobs-scraper/runs": { "post": { "operationId": "runs-sync-maydit-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/maydit~workable-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-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", "properties": { "companies": { "title": "Workable careers pages", "type": "array", "description": "One entry per company: the account slug or the careers-page URL, both work. The slug is the path segment in https://apply.workable.com// (for example 'blueground'); job links such as https://apply.workable.com/blueground/j/186545F8C1/ are parsed to the same slug. A bare job link (https://apply.workable.com/j/) has no account in it and is skipped with a warning. Slugs are case-insensitive. Leave empty to run the preset below. A slug with no careers page returns HTTP 404 and is reported for that company only; an account that exists but publishes no jobs is reported as 'empty' in the run's SUMMARY, not treated as an error.", "items": { "type": "string" } }, "preset": { "title": "Preset company list", "enum": [ "verified-sample", "none" ], "type": "string", "description": "Used only when 'companies' is empty. 'verified-sample' is 18 Workable accounts that each published at least 3 jobs when checked on 2026-09-25 (Blueground, Skroutz, Epignosis, Novibet, Viva.com, Spotawheel, Welcome Pickups, Printec, Orfium, European Dynamics, Grecotel, payabl., Costa Navarino, Uni Systems, Eightcap, EXUS, Hellas Direct, Stoiximan). Boards change, so the run's SUMMARY reports which preset accounts still publish jobs. 'none' means run only the companies you list; if that list is also empty the sample is used anyway so the run returns something.", "default": "verified-sample" }, "includeDetails": { "title": "Include full job description", "type": "boolean", "description": "Fetch each careers page with details=true and keep the full job description as clean plain text in descriptionText (HTML tags removed, entities decoded, list items kept as '- ' bullets, capped at 20,000 characters). Off by default: it makes each response roughly 5-10x larger. Every other field is the same either way.", "default": false }, "titleContains": { "title": "Title contains", "type": "string", "description": "Optional. Keep only postings whose title contains this text (case-insensitive, partial match), for example 'engineer' or 'sales'. Leave empty for every posting." }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only postings the employer flagged as remote in Workable (the 'telecommuting' flag). Workable has no hybrid or on-site flag, so a role that is remote only in its description text is not matched.", "default": false }, "maxResultsPerCompany": { "title": "Max postings per company", "minimum": 1, "type": "integer", "description": "Upper bound on rows kept for each company. Postings are sorted newest-published first, so a low cap keeps the freshest roles. Workable returns a whole careers page in one request, so raising this costs no extra requests.", "default": 100 }, "maxResults": { "title": "Max postings in total", "minimum": 1, "type": "integer", "description": "Upper bound on rows saved for the whole run, applied after all companies are fetched and sorted newest-published first across companies.", "default": 300 }, "onlyNewSinceLastRun": { "title": "Only postings new since the last run", "type": "boolean", "description": "Save only postings this Actor has not seen before. The job ids of every published posting on each successfully fetched careers page are recorded in a named key-value store ('workable-jobs-scraper-state') and compared on the next run with this option on. The FIRST run for a company has no baseline, so it returns every posting and records the baseline; from the second run on you get only new ones. A run with nothing new finishes successfully with an empty dataset and a warning in the log. Leave this off for one-off scrapes.", "default": false }, "maxRunSeconds": { "title": "Max run seconds", "minimum": 30, "type": "integer", "description": "Wall-clock budget for the run. When it is reached the Actor stops cleanly, saves everything already collected, and lists in the log and SUMMARY which companies it did not reach - instead of being killed with a failed run. A careers page takes well under a second, so the default covers hundreds of companies.", "default": 240 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }