{ "openapi": "3.0.1", "info": { "title": "Public ATS Job Board Scraper (Greenhouse, Ashby, Lever)", "description": "Full job descriptions from companies' public ATS APIs. No proxy, no browser - pay per job result, not per page load.", "version": "0.0", "x-build-id": "RS2gwXkXcAbBCMF7A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vocal_pedestal~ats-job-board-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vocal_pedestal-ats-job-board-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/vocal_pedestal~ats-job-board-scraper/runs": { "post": { "operationId": "runs-sync-vocal_pedestal-ats-job-board-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/vocal_pedestal~ats-job-board-scraper/run-sync": { "post": { "operationId": "run-sync-vocal_pedestal-ats-job-board-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": "One entry per line: an ATS board token (`stripe`, `linear`) or a careers URL (`https://jobs.ashbyhq.com/linear`, `https://boards.greenhouse.io/stripe`, `https://jobs.lever.co/spotify`). Tokens are tried against Greenhouse, Ashby and Lever in turn.", "items": { "type": "string" } }, "ats": { "title": "Applicant tracking system", "enum": [ "auto", "greenhouse", "ashby", "lever" ], "type": "string", "description": "\"Auto\" detects the ATS from a careers URL, otherwise tries Greenhouse, then Ashby, then Lever. Pin it if you know the vendor - it avoids two wasted lookups per company.", "default": "auto" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of job results to store. Results are taken round-robin across companies, so a capped run still covers every company you asked for.", "default": 500 }, "keywords": { "title": "Include only jobs matching these keywords", "type": "array", "description": "Case-insensitive substrings, matched against the job title, location and department (and the description if \"Search inside job descriptions\" is on). Any single match keeps the job. Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude jobs matching these keywords", "type": "array", "description": "Any match drops the job. Applied after `keywords`.", "items": { "type": "string" } }, "keywordMatchContent": { "title": "Search inside job descriptions", "type": "boolean", "description": "Match `keywords` / `excludeKeywords` against the full job text as well as the title and location. Costs no extra requests, but a keyword hit anywhere in the description keeps the job.", "default": false }, "locationKeywords": { "title": "Keep only these locations", "type": "array", "description": "Case-insensitive substrings of the location label the company published (e.g. `berlin`, `new york`, `emea`). Locations are free text in every ATS, so treat this as a substring filter, not an exact match.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Keeps only jobs the company itself marked remote. Greenhouse has no remote flag, so a Greenhouse job is kept only when its own location/office label says \"remote\"; anything ambiguous is excluded rather than guessed.", "default": false }, "publishedWithinDays": { "title": "Published in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Uses the posting's own first-published/created date. 0 disables the filter. Jobs whose source does not publish a date are dropped when this filter is on - we never fill a date in.", "default": 0 }, "includeJobContent": { "title": "Include the full job description", "type": "boolean", "description": "Stores `contentHtml` plus a tag-stripped `contentText`. Turning this off makes each result far smaller and cheaper to transfer; title, location, dates and links are always included.", "default": true }, "maxContentChars": { "title": "Max characters of job description per result", "minimum": 500, "maximum": 100000, "type": "integer", "description": "Truncates the stored description and sets `contentTruncated: true` so you can tell. Applies to HTML and text alike.", "default": 20000 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per HTTP request. Large boards return a few megabytes in one response, so keep this generous.", "default": 30 }, "concurrency": { "title": "Companies fetched in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many boards are read at once. Higher is faster but uses more memory; the run stays within the memory you selected for the run.", "default": 8 } } }, "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 } } } } } } } } } }