{ "openapi": "3.0.1", "info": { "title": "ATS Jobs Monitor", "description": "The ATS Jobs Monitor watches company job boards on a schedule and returns only what changed — roles opened since the last check, and roles closed — with canonical apply URLs, true first-published dates, structured locations, remote and employment type, department and salary.", "version": "0.0", "x-build-id": "V8piy5WVp595W36rS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~ats-jobs-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-ats-jobs-monitor", "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/piotrv1001~ats-jobs-monitor/runs": { "post": { "operationId": "runs-sync-piotrv1001-ats-jobs-monitor", "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/piotrv1001~ats-jobs-monitor/run-sync": { "post": { "operationId": "run-sync-piotrv1001-ats-jobs-monitor", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Companies to watch", "type": "array", "description": "Company homepage URLs. The monitor finds each company's job board once and then re-checks it on every run. You can also paste a board URL directly (Greenhouse, Lever, Ashby, Workday, Oracle HCM, SmartRecruiters, Workable, Radancy).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxNewJobsPerRun": { "title": "Maximum new jobs per run", "minimum": 1, "type": "integer", "description": "Stop after this many newly found roles. Anything beyond it is not lost — it is reported by the next run — so this caps what a single check can cost. The first run of a new monitor reports every open role it finds, so keep this in mind when watching large employers.", "default": 200 }, "reportClosedJobs": { "title": "Also report closed jobs", "type": "boolean", "description": "Report roles that have come off a board since the last check — filled, pulled or expired. A closure is only reported after two consecutive checks miss it, so a board that answers oddly for one run is never mistaken for a wave of closures. Adds a charge per closed role.", "default": false }, "keywords": { "title": "Keywords", "type": "array", "description": "Only report jobs whose title, department or team contains any of these. Leave empty to watch every role.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location contains", "type": "string", "description": "Only report jobs whose location matches this text (e.g. \"United States\", \"Berlin\"). Leave empty for all locations.", "default": "" }, "workplaceType": { "title": "Workplace type", "type": "array", "description": "Only report remote, hybrid or on-site roles. Read from the field the employer's own system publishes, so this filters rather than merely appears to. Jobs whose source does not report the field are always kept.", "items": { "type": "string", "enum": [ "remote", "hybrid", "on-site" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "employmentType": { "title": "Employment type", "type": "array", "description": "Only report these employment types (e.g. Full-time, Part-time, Contract, Internship). Jobs whose source does not report the field are always kept.", "default": [], "items": { "type": "string" } }, "enrichWithAI": { "title": "AI enrichment", "type": "boolean", "description": "Additionally extract structured skills, requirements, responsibilities and benefits from each new job's description. Off by default: the fields the employer publishes are already structured, and this makes each check slower.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Optional. Runs sharing an ID share one memory of what has already been reported. Leave empty and the memory is tied to the exact companies and filters — which means editing any of them starts a fresh monitor that reports everything again. Set an ID if you want to add a company or change a filter later without being sent, and charged for, roles you already have." }, "maxJobsPerCompany": { "title": "Maximum jobs read per company", "minimum": 1, "type": "integer", "description": "How deep into each board a check reads. This is not a limit on results — it is how much of the board the monitor can see. A company with more open roles than this is reported as truncated and is left out of closed-job detection, because a partial view cannot tell a closed role from one further down the list. Raise it for very large employers.", "default": 500 } } }, "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 } } } } } } } } } }