{ "openapi": "3.0.1", "info": { "title": "Multi-ATS Jobs Scraper (Greenhouse, Lever, Ashby)", "description": "Scrape public job postings from Greenhouse, Lever and Ashby career pages into one clean dataset. Filter by keyword, remote or location, get salary ranges, and use incremental mode to receive only new jobs on each run.", "version": "0.1", "x-build-id": "jYCvC2KdmPJ29IZ1W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alain_diaz~multi-ats-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alain_diaz-multi-ats-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/alain_diaz~multi-ats-jobs-scraper/runs": { "post": { "operationId": "runs-sync-alain_diaz-multi-ats-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/alain_diaz~multi-ats-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-alain_diaz-multi-ats-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": "Companies (ATS + token)", "type": "array", "description": "List of objects like {\"ats\": \"greenhouse\", \"token\": \"airbnb\"}. `ats` is one of greenhouse, lever, ashby. `token` is the company slug in the job board URL (e.g. boards.greenhouse.io/)." }, "boardUrls": { "title": "Job board URLs", "type": "array", "description": "Public job board URLs. ATS and company token are detected automatically. Supported: boards.greenhouse.io/, job-boards.greenhouse.io/, jobs.lever.co/, jobs.ashbyhq.com/.", "items": { "type": "string" } }, "keywords": { "title": "Include keywords", "type": "array", "description": "Keep only jobs whose title, department or team contains at least one of these keywords (case-insensitive). Enable \"Search keywords in description\" to also match the description. Leave empty to keep all.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, department or team (and description, if enabled) contains any of these keywords (case-insensitive).", "items": { "type": "string" } }, "searchInDescription": { "title": "Search keywords in description", "type": "boolean", "description": "By default keywords are matched against title, department and team. Enable to also match inside the full job description (more results, more noise).", "default": false }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs flagged or described as remote.", "default": false }, "locationContains": { "title": "Location contains", "type": "array", "description": "Keep only jobs whose location text contains at least one of these strings (e.g. \"Chile\", \"United States\", \"London\", \"EMEA\"). Case-insensitive. Country names and country codes (e.g. \"US\") are matched against the location text and, where the ATS provides it, the country field.", "items": { "type": "string" } }, "onlyNewSinceLastRun": { "title": "Only new jobs since last run", "type": "boolean", "description": "Return only jobs not seen in earlier runs. Seen job IDs are stored in a named key-value store (see `stateStoreName`) per ATS and company. The first run returns everything.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Name of the key-value store that remembers seen job IDs for incremental mode. Use different names for different monitoring setups (e.g. one per schedule).", "default": "multi-ats-jobs-state" }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Add the job description as plain text to each item. Makes the dataset larger.", "default": false }, "maxItemsPerCompany": { "title": "Max items per company", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of jobs returned per company (0 = unlimited).", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many company boards are fetched in parallel. Keep low to be polite to the job-board APIs.", "default": 3 } } }, "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 } } } } } } } } } }