{ "openapi": "3.0.1", "info": { "title": "Career Site Jobs API | Greenhouse, Lever, Ashby", "description": "Paste company websites or board URLs and get open jobs from Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee and Personio in one format. Salary, remote flag and new-jobs-only monitoring included. $5 per 1,000 jobs.", "version": "1.0", "x-build-id": "KgnGZCpD18dCKB22y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atesen-software~career-site-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atesen-software-career-site-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/atesen-software~career-site-jobs-api/runs": { "post": { "operationId": "runs-sync-atesen-software-career-site-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/atesen-software~career-site-jobs-api/run-sync": { "post": { "operationId": "run-sync-atesen-software-career-site-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", "type": "array", "description": "One per line. Any of: a company website (\"stripe.com\"), a careers page URL, a job board URL (\"https://jobs.lever.co/palantir\", \"https://boards.greenhouse.io/airbnb\"), an explicit \"ats:board\" pair (\"ashby:notion\", \"workable:huggingface\", \"smartrecruiters:BoschGroup\", \"recruitee:bunq\", \"personio:acme\") or a company name. The ATS is detected automatically.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alternative)", "type": "array", "description": "Same as Companies, in request-list format, if you already have URL lists from other actors.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Title keywords", "type": "array", "description": "Only jobs whose title contains at least one of these words (case-insensitive), e.g. \"engineer\", \"data\", \"sales\". Empty = all jobs.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Skip jobs whose title contains any of these words, e.g. \"intern\", \"senior\".", "items": { "type": "string" } }, "locations": { "title": "Location contains", "type": "array", "description": "Only jobs whose location contains one of these texts, e.g. \"London\", \"Berlin\", \"remote\".", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Only jobs in these countries: ISO codes or names (\"US\", \"DE\", \"United Kingdom\").", "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace type", "type": "array", "description": "Only these workplace types. Jobs whose workplace type is not published (and not stated in the title or location) are excluded when this filter is set.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Only these (normalised) employment types. Jobs without a published employment type are excluded when this filter is set.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "internship", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract / freelance", "Temporary", "Internship / working student", "Other" ] } }, "departments": { "title": "Department or team contains", "type": "array", "description": "Only jobs whose department or team contains one of these texts, e.g. \"Engineering\".", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Only jobs posted in the last N days (0 = any date).", "default": 0 }, "incrementalMode": { "title": "Only new jobs since the last run (monitoring)", "type": "boolean", "description": "Remembers the jobs of each board between runs (under the state name below) and returns only jobs that are new. The first run returns all jobs. You pay only for new jobs.", "default": false }, "stateKey": { "title": "State name (for monitoring)", "type": "string", "description": "Use a different name for each separate watch list (e.g. \"fintech-companies\"). Stored in your key-value store \"career-jobs-state\".", "default": "default" }, "reportClosedJobs": { "title": "Report closed jobs (monitoring)", "type": "boolean", "description": "In monitoring mode, also add a free row for each job that disappeared from a board since the last run.", "default": true }, "descriptionFormat": { "title": "Job description", "enum": [ "text", "html", "both", "none" ], "type": "string", "description": "Plain text (default), HTML, both, or none (faster, smaller output; SmartRecruiters then needs no extra requests).", "default": "text" }, "dedupeSimilarJobs": { "title": "Merge duplicate postings", "type": "boolean", "description": "Some companies post the same job several times (same title and location). Keep only one.", "default": true }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Newest first (0 = no limit).", "default": 0 }, "maxJobs": { "title": "Max jobs in total", "minimum": 0, "type": "integer", "description": "Stop after this many jobs (0 = no limit).", "default": 0 } } }, "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 } } } } } } } } } }