{ "openapi": "3.0.1", "info": { "title": "ATS Jobs Feed: Greenhouse & Lever Job Postings", "description": "Get job postings from company Greenhouse and Lever boards through their official public APIs (no login, no API key), normalized to one clean JSON shape, with new and closed job detection between runs. Polite and robots.txt-aware.", "version": "0.1", "x-build-id": "0Q47jvcsEFWo3AaJu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/madpai~ats-jobs-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-madpai-ats-jobs-feed", "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/madpai~ats-jobs-feed/runs": { "post": { "operationId": "runs-sync-madpai-ats-jobs-feed", "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/madpai~ats-jobs-feed/run-sync": { "post": { "operationId": "run-sync-madpai-ats-jobs-feed", "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": [ "boards" ], "properties": { "boards": { "title": "Company job boards", "type": "array", "description": "Greenhouse or Lever boards: a board URL (job-boards.greenhouse.io/stripe, boards.greenhouse.io/stripe, jobs.lever.co/spotify, jobs.eu.lever.co/company) or source:name (greenhouse:stripe, lever:spotify, lever-eu:company). Ashby and other systems are not supported.", "items": { "type": "string" } }, "maxJobsPerBoard": { "title": "Max jobs per board", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Default mode: most open jobs (new or existing) delivered per board, after filters; closed-job items don't count. With changesOnly: most changes (new + closed) delivered per board per run; extra changes wait for the next run. Caps cost either way.", "default": 500 }, "keywords": { "title": "Keywords (title or department)", "type": "array", "description": "Keep only jobs whose title, department or team contains any of these words (case-insensitive), e.g. engineer, data.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep only jobs whose location contains any of these (case-insensitive), e.g. London, Remote, United States.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs the board marks as remote (workplace type, or 'Remote' in the location).", "default": false }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Add the job description as plain text (up to 5,000 characters). Email addresses and phone numbers in it are replaced with [redacted].", "default": false }, "changesOnly": { "title": "Only new and closed jobs", "type": "boolean", "description": "Output only jobs that are new or closed since the previous run with the same state key. Unchanged jobs are not output and not charged. The first run records every job on the board, outputs up to maxJobsPerBoard as new and records the rest silently (not output, not charged).", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Name of the saved state (job IDs, status and timestamps only) used for change detection (named key-value store 'ats-jobs-feed-state'). Leave empty to derive it from the boards and filters. Use the same key in a scheduled task to track one feed over time." }, "leverEu": { "title": "Lever boards are on the EU site", "type": "boolean", "description": "Use Lever's EU API (api.eu.lever.co) for every Lever board given as lever:name. jobs.eu.lever.co URLs and lever-eu:name always use it.", "default": 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 } } } } } } } } } }