{
"openapi": "3.0.1",
"info": {
"title": "ATS Jobs Scraper & Hiring Monitor - Greenhouse, Lever, Ashby",
"description": "Track which companies are hiring. Enter company domains or careers URLs; the ATS is auto-detected (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Personio, Teamtailor, BambooHR). Get only NEW jobs since the last run, closed jobs, and a hiring summary per company.",
"version": "1.0",
"x-build-id": "h8TSXPnPolAWNrMvQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/ivan-petrus-g~company-hiring-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-ivan-petrus-g-company-hiring-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/ivan-petrus-g~company-hiring-monitor/runs": {
"post": {
"operationId": "runs-sync-ivan-petrus-g-company-hiring-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/ivan-petrus-g~company-hiring-monitor/run-sync": {
"post": {
"operationId": "run-sync-ivan-petrus-g-company-hiring-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",
"properties": {
"companies": {
"title": "Companies",
"type": "array",
"description": "One company per line. Accepted: a company domain (stripe.com), a careers page URL (https://www.figma.com/careers), a job-board URL (https://jobs.lever.co/palantir, https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite), ats:token (greenhouse:airbnb, ashby:notion, workday:nvidia.wd5/NVIDIAExternalCareerSite) or a plain company name (token is guessed). The job system is detected automatically.",
"items": {
"type": "string"
}
},
"boards": {
"title": "Explicit job boards (optional)",
"type": "array",
"description": "Alternative to auto-detection: a JSON list of boards, e.g. [{\"ats\": \"greenhouse\", \"boardToken\": \"airbnb\", \"companyName\": \"Airbnb\"}, {\"ats\": \"workday\", \"boardToken\": \"nvidia\", \"workdayHost\": \"wd5\", \"workdaySite\": \"NVIDIAExternalCareerSite\"}]. ats = greenhouse, lever, ashby, workday, smartrecruiters, workable, recruitee, personio, teamtailor or bamboohr."
},
"onlyNewJobs": {
"title": "Only new jobs (monitor mode)",
"type": "boolean",
"description": "On: each run outputs only jobs that were not there in the previous run of the same company (state is kept per company in a named key-value store), plus closed jobs. Off: output all current open jobs every run (closed/new detection still runs).",
"default": true
},
"firstRunBehavior": {
"title": "First run for a company",
"enum": [
"outputAll",
"baselineOnly"
],
"type": "string",
"description": "What to output the first time a company is checked in monitor mode: all current open jobs, or nothing (just remember them, so you only get truly new jobs from the next run on - cheaper).",
"default": "outputAll"
},
"includeClosedJobs": {
"title": "Output closed jobs (free rows)",
"type": "boolean",
"description": "Add a row for every job that disappeared from the company's board since the last run. Free - not charged.",
"default": true
},
"titleKeywords": {
"title": "Job title must contain (any)",
"type": "array",
"description": "Only output jobs whose title contains at least one of these words (case-insensitive), e.g. engineer, sales. Filters apply to job and closed-job rows; the summary always covers all jobs.",
"items": {
"type": "string"
}
},
"excludeTitleKeywords": {
"title": "Job title must NOT contain",
"type": "array",
"description": "Skip jobs whose title contains any of these words, e.g. intern, senior.",
"items": {
"type": "string"
}
},
"departmentKeywords": {
"title": "Department / team contains (any)",
"type": "array",
"description": "Only jobs whose department or team contains one of these words, e.g. marketing.",
"items": {
"type": "string"
}
},
"locationKeywords": {
"title": "Location contains (any)",
"type": "array",
"description": "Only jobs whose location (any of its locations or country) contains one of these words, e.g. Berlin, Germany, Remote.",
"items": {
"type": "string"
}
},
"remoteOnly": {
"title": "Remote jobs only",
"type": "boolean",
"description": "Only output jobs marked as remote by the ATS (or with 'remote' in the location/title).",
"default": false
},
"includeDescription": {
"title": "Include job descriptions",
"type": "boolean",
"description": "Add the plain-text job description (max 6,000 characters) where the public board provides it in the list (Greenhouse, Lever, Ashby, Workable, Recruitee, Personio, Teamtailor). Not available for Workday, SmartRecruiters, BambooHR.",
"default": false
},
"maxJobsPerCompany": {
"title": "Max jobs to read per company",
"minimum": 0,
"type": "integer",
"description": "Upper limit of jobs read from one board (0 = all). Big boards (Workday, SmartRecruiters) are paginated; when the limit cuts the list, closed-job detection is switched off for that company.",
"default": 2000
},
"maxJobsOutputPerCompany": {
"title": "Max job rows to output per company per run",
"minimum": 0,
"type": "integer",
"description": "Cost guard: at most this many (charged) job rows per company per run (0 = no limit). Jobs above the limit are still remembered as seen.",
"default": 500
},
"includeSummary": {
"title": "Hiring summary row per company (free)",
"type": "boolean",
"description": "One free row per company: open jobs, new/closed since last run, change vs last run, top departments and locations, remote and salary counts, new departments/locations.",
"default": true
},
"guessBoardTokens": {
"title": "Guess board token if not found on the website",
"type": "boolean",
"description": "If no job-board link is found on the company's careers pages, try the domain name as board token on each supported ATS (e.g. stripe.com -> greenhouse:stripe). Guesses are marked with detectionMethod = slug-guess.",
"default": true
},
"stateStoreName": {
"title": "State store name",
"type": "string",
"description": "Named key-value store that remembers the jobs per company between runs. Use different names for independent monitors.",
"default": "company-hiring-monitor-state"
},
"maxConcurrency": {
"title": "Companies in parallel",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many companies are checked at the same time.",
"default": 3
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Not needed for the official job-board APIs. Enable only if a careers website blocks requests.",
"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
}
}
}
}
}
}
}
}
}
}