{ "openapi": "3.0.1", "info": { "title": "Greenhouse, Lever & Ashby Jobs API: ATS Job Postings Scraper", "description": "Greenhouse jobs API, Lever API and Ashby jobs in one scraper. Paste company slugs or careers URLs, get normalized job postings from their official public job board APIs (no API key, no login). Filter by keyword, location, remote, department, date. $1.50 per 1,000 jobs.", "version": "1.0", "x-build-id": "RvuLfWtH26MvUSpLm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/terracotta_hauyne~ats-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-terracotta_hauyne-ats-jobs-api", "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/terracotta_hauyne~ats-jobs-api/runs": { "post": { "operationId": "runs-sync-terracotta_hauyne-ats-jobs-api", "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/terracotta_hauyne~ats-jobs-api/run-sync": { "post": { "operationId": "run-sync-terracotta_hauyne-ats-jobs-api", "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 (slugs or careers URLs)", "type": "array", "description": "Board slugs or careers URLs. The ATS is detected from the URL: https://boards.greenhouse.io/stripe, https://jobs.lever.co/spotify, https://jobs.ashbyhq.com/ashby (also job-boards.greenhouse.io, jobs.eu.lever.co and the API URLs). A bare slug such as 'stripe' is tried on all three ATS unless you set the ATS below or write 'lever:spotify'. A company's own careers URL (https://stripe.com/jobs) is tried with the name taken from the domain. Up to 2,000 entries.", "items": { "type": "string" } }, "ats": { "title": "ATS (for bare slugs)", "enum": [ "auto", "greenhouse", "lever", "ashby" ], "type": "string", "description": "Applies to entries that are not a URL and have no 'ats:' prefix. Choosing one ATS is faster and avoids stale duplicate boards.", "default": "auto" }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep jobs whose title, department or team contains any of these words, e.g. 'engineer', 'data scientist'.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, department or team contains any of these words, e.g. 'intern', 'director'.", "items": { "type": "string" } }, "searchInDescription": { "title": "Also search the description", "type": "boolean", "description": "Apply the keywords and exclude keywords to the full job description too, not only title, department and team.", "default": false }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs with any location (or country) containing one of these texts, e.g. 'London', 'Germany', 'CA'. Remote jobs also match the text 'remote'.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs the company marks as remote (Lever and Ashby workplace type, Greenhouse location or workplace-type field).", "default": false }, "departments": { "title": "Departments / teams", "type": "array", "description": "Keep jobs whose department or team contains any of these texts, e.g. 'Engineering', 'Sales'.", "items": { "type": "string" } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Keep only these types. Jobs where the company does not publish a type (common on Greenhouse) are dropped when this is set.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "temporary", "other" ] } }, "postedSince": { "title": "Posted since", "type": "string", "description": "Keep jobs first published on or after this date: YYYY-MM-DD, or relative like '7 days', '24 hours', '2 weeks'. Uses the posted date, or the last update when no posted date exists." }, "descriptionFormat": { "title": "Job description", "enum": [ "text", "markdown", "html", "none" ], "type": "string", "description": "Format of the 'description' field. The same price applies to all formats; 'Leave out' gives the smallest dataset.", "default": "text" }, "maxResults": { "title": "Max jobs in total", "minimum": 1, "type": "integer", "description": "Stop after this many jobs across all companies. Leave empty for no limit other than your maximum cost per run." }, "maxResultsPerCompany": { "title": "Max jobs per company", "minimum": 1, "type": "integer", "description": "At most this many jobs from each company entry (after filters). Leave empty for all." }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many job board requests run at the same time. Default 3 is polite; the actor also retries with backoff and honours HTTP 429 Retry-After.", "default": 3 } } }, "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 } } } } } } } } } }