{ "openapi": "3.0.1", "info": { "title": "ATS Jobs Feed (Greenhouse, Lever, Ashby & more)", "description": "Job listings from the public JSON APIs of Greenhouse, Lever, Ashby, Workable and SmartRecruiters. One clean record per job (Markdown description, department, locations, remote flag, salary when published, apply URL) plus a diff mode that flags new, updated and closed jobs between runs.", "version": "0.1", "x-build-id": "HfVX9hrt3poGQmXuU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vellumlabs~ats-job-boards-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vellumlabs-ats-job-boards-feed", "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/vellumlabs~ats-job-boards-feed/runs": { "post": { "operationId": "runs-sync-vellumlabs-ats-job-boards-feed", "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/vellumlabs~ats-job-boards-feed/run-sync": { "post": { "operationId": "run-sync-vellumlabs-ats-job-boards-feed", "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 / job boards", "type": "array", "description": "Objects `{ \"ats\": \"greenhouse|lever|ashby|workable|smartrecruiters\", \"slug\": \"\" }` or plain board URLs (ATS auto-detected). The slug is the board token in the company's careers URL: `boards.greenhouse.io/`, `jobs.lever.co/`, `jobs.ashbyhq.com/`, `apply.workable.com/`, `careers.smartrecruiters.com/`." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep only jobs whose title or description contains at least one of these words or phrases (case-insensitive). Leave empty for all jobs.", "default": [], "items": { "type": "string" } }, "locationContains": { "title": "Location contains", "type": "array", "description": "Keep only jobs whose location text contains at least one of these strings (case-insensitive), e.g. `Berlin`, `United States`, `EMEA`.", "default": [], "items": { "type": "string" } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs flagged remote by the ATS or whose location / title says remote.", "default": false }, "departments": { "title": "Departments", "type": "array", "description": "Keep only jobs whose department or team contains one of these strings (case-insensitive), e.g. `Engineering`.", "default": [], "items": { "type": "string" } }, "maxJobs": { "title": "Max jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on job records exported in one run, across all boards. Each exported record is one `job-exported` billing event, so this also caps your cost.", "default": 500 }, "diff": { "title": "Diff mode (new / updated / closed since the previous run)", "type": "boolean", "description": "Remember every job seen (per board) in a named key-value store and mark each record `new`, `updated` or `closed` compared with the previous run. Unchanged jobs are not exported unless **Emit unchanged jobs** is on. Schedule the Actor and you get a change feed.", "default": false }, "emitUnchanged": { "title": "Emit unchanged jobs (diff mode)", "type": "boolean", "description": "In diff mode, also export jobs that did not change (status `unchanged`). Off by default so a scheduled run only bills for changes.", "default": false }, "stateStoreName": { "title": "State store name (diff mode)", "type": "string", "description": "Name of the key-value store that keeps the seen-jobs state between runs. Use a different name per schedule / per filter set.", "default": "ats-jobs-feed-state" }, "includeHtml": { "title": "Include description HTML", "type": "boolean", "description": "Also store the original job description HTML on each record (`description_html`). Increases dataset size.", "default": false } } }, "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 } } } } } } } } } }