{ "openapi": "3.0.1", "info": { "title": "ATS Hiring Signal Monitor: Who Is Hiring, Week Over Week", "description": "ATS hiring signal monitor: give it a company watchlist and get one row per company, not a job dump. Open roles, roles opened and closed since your last run, growth percent, job families, seniority mix and a verdict. Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Personio.", "version": "1.0", "x-build-id": "206qq3gSUe4QyHLIS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~ats-hiring-signal-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-ats-hiring-signal-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/accountable_eel~ats-hiring-signal-monitor/runs": { "post": { "operationId": "runs-sync-accountable_eel-ats-hiring-signal-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/accountable_eel~ats-hiring-signal-monitor/run-sync": { "post": { "operationId": "run-sync-accountable_eel-ats-hiring-signal-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": [ "companySlugs" ], "properties": { "companySlugs": { "title": "Companies to watch (slug or ATS board URL)", "type": "array", "description": "One company slug per line (e.g. \"stripe\"), or paste a full board URL from any of the six platforms below. The same slug is tried against all six, so you do not need to know which applicant-tracking system a company uses. Each company comes back as one summary row: how many roles are open, what changed since the last run, and a one-word verdict. Accepted formats: stripe, https://boards.greenhouse.io/stripe, https://jobs.lever.co/stripe. You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "mode": { "title": "What do you need back?", "enum": [ "signal" ], "type": "string", "description": "Pick the option that matches what you need — you can leave this on the recommended setting.", "default": "signal" }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit." }, "hiringForGroups": { "title": "Job families to report on", "type": "array", "description": "One job family per line, as \"family name: keyword, keyword\" — each company is then reported as hiring (or not) for that family, with a count. Keywords match inside the job title and case does not matter, so \"engineer\" also catches \"Engineering Manager\". Leave as-is for the five defaults, or replace them with your own segments (a territory, a product line, the roles that signal your own buying trigger).", "items": { "type": "string" } }, "deltaMode": { "title": "Remember each company between runs", "type": "boolean", "description": "On by default: this is what makes the actor a monitor rather than a snapshot. The watchlist memory records each company's board on every run, which is what lets the next run say how many roles opened and closed. Nothing is withheld from your results by this checkbox (a signal row summarises a whole board rather than listing postings), so every company you submit still comes back with a row and is still charged once. Turn it off only if you want a one-time snapshot with no week-over-week comparison.", "default": true }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty and one is derived for you, so every schedule of this actor shares one memory per company and platform. Type your own name to keep two independent watchlists over the same companies, for example a weekly one and a monthly one.", "default": "" }, "signals": { "title": "Compare each company against the previous run", "type": "boolean", "description": "On by default. Adds the change since your last run to every row: roles opened and closed, percent growth, which job families the new roles are in, seniority mix, remote share, and a one-word verdict (expanding, gtm-push, contracting, steady). The first run of a watchlist is the baseline and reports \"baseline\", so schedule this weekly and read from run two on. It costs nothing extra: the comparison is computed from the row you are already paying for.", "default": true }, "columns": { "title": "Which signals do you want (and pay for)?", "type": "array", "description": "Choose which sources to check. Only the sources you select here are checked — and only the ones that actually return data are billed. All are included by default.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby", "workable", "smartrecruiters", "personio" ], "enumTitles": [ "Greenhouse match", "Lever match", "Ashby match", "Workable match", "SmartRecruiters match", "Personio match" ] }, "default": [ "greenhouse", "lever", "ashby", "workable", "smartrecruiters", "personio" ] }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 5 } } }, "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 } } } } } } } } } }