{
"openapi": "3.0.1",
"info": {
"title": "Lever Jobs Scraper & API",
"description": "Free Lever jobs scraper: pay only for platform usage. Extract every open job from one or many Lever boards (US and EU) with titles, locations, teams, salary ranges, remote/hybrid/on-site type, descriptions, and publish dates. Filter by team, location, workplace type, keywords, or date.",
"version": "1.0",
"x-build-id": "nB1ZB4XCBVMjJc4Pt"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/miladamirzadeh~lever-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-miladamirzadeh-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/miladamirzadeh~lever-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-miladamirzadeh-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/miladamirzadeh~lever-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-miladamirzadeh-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": {
"mode": {
"title": "Mode",
"enum": [
"company_jobs",
"job_details"
],
"type": "string",
"description": "Company jobs lists every open job on the given Lever boards. Job details fetches specific postings by URL.",
"default": "company_jobs"
},
"companySlugs": {
"title": "Company board slugs or URLs",
"type": "array",
"description": "Lever board slugs such as spotify or zoox, or board URLs such as https://jobs.lever.co/spotify or https://jobs.eu.lever.co/seb. The slug is the path segment right after lever.co/. US and EU boards are both detected automatically. Used in Company jobs mode.",
"default": [
"spotify"
],
"items": {
"type": "string"
}
},
"jobUrls": {
"title": "Job posting URLs",
"type": "array",
"description": "Specific postings as Lever URLs (https://jobs.lever.co/spotify/2193db3f-77c5-43b8-b030-8f92c9882bf1) or slug/postingId. Used in Job details mode.",
"default": [],
"items": {
"type": "string"
}
},
"includeContent": {
"title": "Include job description",
"type": "boolean",
"description": "Save the full description as HTML (content), plain text (descriptionText), and structured bullet sections (sections). Turn off for smaller, faster exports.",
"default": true
},
"workplaceTypes": {
"title": "Workplace type",
"type": "array",
"description": "Keep only jobs with any of these workplace types, as set by the employer in Lever. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"remote",
"hybrid",
"onsite"
],
"enumTitles": [
"Remote",
"Hybrid",
"On-site"
]
},
"default": []
},
"filterDepartment": {
"title": "Department or team contains",
"type": "string",
"description": "Keep only jobs whose department or team contains this text (case-insensitive), e.g. Engineering."
},
"filterLocation": {
"title": "Location or country",
"type": "string",
"description": "Keep only jobs where any listed location contains this text (case-insensitive), e.g. London. A two-letter country code such as DE, US or UK matches the country only, so DE does not match Denver and CA means Canada. A US state name such as California also finds its code (\"San Francisco, CA\"), and state codes that are not country codes (NY, TX) match the state. Remote also matches jobs whose workplace type is remote."
},
"filterCommitment": {
"title": "Commitment contains",
"type": "string",
"description": "Keep only jobs whose commitment (employment type) contains this text, e.g. Full-time, Intern, or Contract. Employers name these freely."
},
"jobKeywords": {
"title": "Keywords",
"maxItems": 20,
"type": "array",
"description": "Keep jobs whose title or description contains any of these keywords as a whole word or phrase (case-insensitive). Up to 20 keywords.",
"default": [],
"items": {
"type": "string"
}
},
"postedAfter": {
"title": "Posted on or after",
"type": "string",
"description": "Keep jobs created on or after this UTC date. Relative values such as 1 day suit scheduled runs."
},
"onlyWithSalary": {
"title": "Only jobs with a salary range",
"type": "boolean",
"description": "Keep only jobs with a salary, either in the employer's Lever salary fields or stated in the job description (see salarySource).",
"default": false
},
"maxJobsPerCompany": {
"title": "Maximum jobs per company",
"minimum": 1,
"type": "integer",
"description": "Maximum number of matching jobs saved per company, newest first. Set a high value such as 9999 to save every open role.",
"default": 500
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. Lever's Postings API is public, so a proxy is not required.",
"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
}
}
}
}
}
}
}
}
}
}