{ "openapi": "3.0.1", "info": { "title": "Lever Jobs Scraper — Job Boards & Postings", "description": "Scrape Lever jobs from any Lever job board (jobs.lever.co) or company career site built on Lever. Every job posting with title, team, location, commitment, salary, posted date, full description and apply URL; filter by keyword, location or team. Monitor new job postings on a schedule.", "version": "0.1", "x-build-id": "Hyo8ZBdUszo71IZ2T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~lever-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-lever-jobs-scraper", "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/tortuga~lever-jobs-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-lever-jobs-scraper", "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/tortuga~lever-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-lever-jobs-scraper", "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": { "startUrls": { "title": "Lever job board or careers page URLs", "type": "array", "description": "Lever job boards (https://jobs.lever.co/palantir, EU boards on jobs.eu.lever.co, a single posting URL scrapes its whole board, api.lever.co posting URLs work too) or a company careers page / homepage: the Actor looks for the Lever board it embeds or links to, follows the 'Careers' link and tries /careers and /jobs (at most 4 pages per site).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "boards": { "title": "Lever company slugs", "type": "array", "description": "Optional: boards you already know, as the company part of the jobs.lever.co URL, e.g. palantir, octoenergy. Write eu/acme for a board on Lever's EU instance (jobs.eu.lever.co/acme); lever:palantir and full URLs are accepted too. Via the API you can also pass objects: {\"slug\": \"palantir\", \"companyName\": \"Palantir Technologies\"}.", "items": { "type": "string" } }, "keywords": { "title": "Title keywords", "type": "array", "description": "Keep only jobs whose title contains at least one of these words or phrases (case-insensitive), e.g. engineer, sales, \"product manager\". Leave empty for all jobs.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep only jobs whose location text or country contains one of these, e.g. London, Germany, US, Remote. Leave empty for all locations.", "items": { "type": "string" } }, "departments": { "title": "Departments / teams", "type": "array", "description": "Keep only jobs whose Lever department or team contains one of these, e.g. Engineering, Sales.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs Lever marks as remote (or whose location says Remote).", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep only jobs posted in the last N days (Lever's posting date is exact)." }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Add the full description as plain text and HTML. Lever sends it with the job list, so this costs no extra requests and no extra charge; turn it off for a smaller dataset.", "default": true }, "maxItems": { "title": "Max jobs (total)", "minimum": 1, "type": "integer", "description": "Stop after this many jobs in total. Keeps cost predictable.", "default": 100 }, "maxItemsPerCompany": { "title": "Max jobs per company", "minimum": 1, "type": "integer", "description": "Optional cap per board (newest jobs first). With monitoring on, it is the number of newest jobs watched per board." }, "onlyNewOrChanged": { "title": "Only new jobs (monitoring)", "type": "boolean", "description": "Remember what earlier runs of this input returned and output only jobs that are new since then. Use with a Schedule; jobs seen before are not output and not charged.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same input stay separate; defaults to a key derived from the input." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: Lever's job-board API is public and direct requests are fastest, so the Actor always reads it directly (through the Apify proxy it streams very slowly). A proxy you configure here is used only to open company careers pages. No residential proxy or Unblocker is ever needed.", "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 } } } } } } } } } }