{ "openapi": "3.0.1", "info": { "title": "ATS Hiring Signals & Salary Feed", "description": "Monitor public job listings across Greenhouse, Lever, Ashby, Workable, and SmartRecruiters. Extract structured job data, published salary ranges, remote work details, and hiring changes. Track new, updated, and removed listings for recruitment, sales intelligence, and market research.", "version": "0.1", "x-build-id": "VDDP3wKM9Utd93zzv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/privatex~ats-hiring-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-privatex-ats-hiring-signals", "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/privatex~ats-hiring-signals/runs": { "post": { "operationId": "runs-sync-privatex-ats-hiring-signals", "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/privatex~ats-hiring-signals/run-sync": { "post": { "operationId": "run-sync-privatex-ats-hiring-signals", "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": { "demoMode": { "title": "Demo mode (free, synthetic data)", "type": "boolean", "description": "Preview the output format with FREE synthetic data about fictional companies. No job boards are contacted and nothing is charged. Untick it and fill in Companies for real data. A run that gives no Companies (for example empty API input) behaves the same way; untick this box to require Companies." }, "companies": { "title": "Companies", "type": "array", "description": "Required unless Demo mode is on. One entry per line. Accepts a company name (Airbnb), a domain (ramp.com), a careers URL (https://jobs.lever.co/palantir) or an explicit board (greenhouse:airbnb, ashby:ramp, lever:palantir, workable:huggingface, smartrecruiters:BoschGroup). Careers URLs and explicit boards are exact; names and domains are matched by their slug, so check the `ats`/`atsSlug` columns.", "items": { "type": "string" } }, "atsPlatforms": { "title": "ATS platforms to search", "type": "array", "description": "Which job-board systems to probe when a company is given as a name or domain.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby", "workable", "smartrecruiters" ], "enumTitles": [ "Greenhouse", "Lever", "Ashby", "Workable", "SmartRecruiters" ] }, "default": [ "greenhouse", "lever", "ashby", "workable", "smartrecruiters" ] }, "titleKeywords": { "title": "Job title must contain (any)", "type": "array", "description": "Keep only jobs whose title contains at least one of these words (case-insensitive). Leave empty for all jobs. Example: engineer, data, sales.", "default": [], "items": { "type": "string" } }, "excludeTitleKeywords": { "title": "Job title must not contain", "type": "array", "description": "Drop jobs whose title contains any of these words. Example: intern, director.", "default": [], "items": { "type": "string" } }, "locationKeywords": { "title": "Location contains (any)", "type": "array", "description": "Keep only jobs whose location, country or workplace type contains one of these words. Example: United States, London, Germany, remote.", "default": [], "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Return only jobs flagged as fully remote by the company's ATS.", "default": false }, "onlyWithSalary": { "title": "Only jobs with a pay range", "type": "boolean", "description": "Return only jobs where a salary range was published (structured ATS field or parsed from the job text). Useful for pay-transparency research.", "default": false }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "0 disables the filter. Jobs without a publish date are excluded when this is set.", "default": 0 }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap on returned jobs per company board (newest first). 0 = no cap. You only pay for returned jobs.", "default": 200 }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Adds the plain-text job description to every row. Makes the dataset much larger.", "default": false }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Remember each company's jobs in a named key-value store so every row is labelled new, updated, unchanged or removed compared with the previous run. Schedule the Actor daily to get a hiring-signal feed.", "default": true }, "changesOnly": { "title": "Return only new / updated / removed jobs", "type": "boolean", "description": "Skip unchanged jobs. Requires 'Track changes'. The first run for a company still returns all its jobs (labelled first_seen).", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Name of the key-value store that remembers previous runs. Use different names to keep separate watchlists.", "default": "ats-hiring-signals-state" }, "concurrency": { "title": "Parallel companies", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many companies are fetched at the same time (1-20).", "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 } } } } } } } } } }