{ "openapi": "3.0.1", "info": { "title": "Job Postings Tracker: Greenhouse, Lever, Ashby & more", "description": "Track open jobs at any list of companies on Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee and Personio. One clean row per job (department, location, remote, salary, dates) plus what changed since the last run: new, closed and edited postings. Public job-board APIs only, no login.", "version": "0.1", "x-build-id": "Dofa3716i9f7He9Kh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/descriptive_orbit~ats-job-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-descriptive_orbit-ats-job-tracker", "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/descriptive_orbit~ats-job-tracker/runs": { "post": { "operationId": "runs-sync-descriptive_orbit-ats-job-tracker", "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/descriptive_orbit~ats-job-tracker/run-sync": { "post": { "operationId": "run-sync-descriptive_orbit-ats-job-tracker", "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 company per line. Accepted forms: a job board URL (https://job-boards.greenhouse.io/figma, https://boards.greenhouse.io/figma, https://jobs.lever.co/spotify, https://jobs.eu.lever.co/company, https://jobs.ashbyhq.com/ramp, https://apply.workable.com/huggingface, https://jobs.smartrecruiters.com/BoschGroup, https://bunq.recruitee.com, https://ottonova.jobs.personio.de); an ATS prefix plus board name (greenhouse:stripe, lever:palantir, ashby:openai, workable:blueground, smartrecruiters:Ubisoft2, recruitee:bunq, personio:ottonova); a plain company name (Stripe), which is looked up on each ATS in turn; or the company's own careers page URL, which is scanned once for a link to one of these job boards. An entry that cannot be read produces one free error row and the run carries on.", "items": { "type": "string" } }, "ats": { "title": "ATS for plain company names", "enum": [ "auto", "greenhouse", "lever", "ashby", "workable", "smartrecruiters", "recruitee", "personio" ], "type": "string", "description": "Which applicant tracking system to use for entries that are just a name (like \"stripe\"). \"Auto\" tries Greenhouse, Lever, Ashby, Workable, Recruitee, SmartRecruiters and Personio in that order and uses the first one with open jobs (the run log and the OUTPUT record show what was tried). URLs and \"ats:name\" entries ignore this setting.", "default": "auto" }, "keywords": { "title": "Keywords", "type": "array", "description": "Only output jobs whose title, department or team contains one of these words (any one is enough, case does not matter). A keyword matches the start of a word, so \"engineer\" finds \"Engineer\" and \"Engineering\". Leave empty for all jobs. Filters only change which rows are saved (and charged); change tracking always compares the full list.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Only output jobs whose location contains one of these texts, for example \"London\", \"Germany\", \"New York\" or \"Remote\". Case does not matter. Leave empty for all locations.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only output jobs the ATS marks as remote, or whose location says \"Remote\".", "default": false }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Add the job description as plain text (up to 5,000 characters). Off by default to keep the dataset small. For SmartRecruiters this needs one extra request per saved job, so runs with many SmartRecruiters jobs take longer.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Save at most this many rows per company per run (after filters). Change rows (new, updated, removed) come first. Change tracking still reads the company's whole list, so the limit never causes fake \"removed\" rows; changes beyond the limit are reported on the next run.", "default": 500 }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Saves each company's list of open jobs in a named key-value store after the run, so the next run can mark every row as new, updated (title, department, location, workplace type, employment type or salary changed), removed (the posting closed) or unchanged. The first run for a company marks everything as new.", "default": true }, "onlyChanges": { "title": "Output only changes", "type": "boolean", "description": "Skip unchanged jobs, so each run saves (and charges) only new, updated and removed postings. Ideal for daily schedules. Needs change tracking (it is switched on automatically).", "default": false }, "stateStoreName": { "title": "Snapshot store name", "type": "string", "description": "Name of the key-value store that keeps the job lists between runs. Use a different name to run separate monitors of the same companies, or to start a fresh baseline.", "default": "ats-job-tracker-state" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed: these job-board APIs are public. If a board answers with HTTP 403 or 429 in the error row, try Apify Proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }