{ "openapi": "3.0.1", "info": { "title": "Career Site Jobs API: Greenhouse, Lever, Ashby, Workday", "description": "Jobs straight from company career sites: Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Recruitee, Personio, Teamtailor, Workable, BambooHR. Search 30,000 companies or fetch your own list. Normalized location, salary, remote, dates, apply link. $2 per 1,000 jobs.", "version": "0.1", "x-build-id": "BWDKZw0EopMAcHYnA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/praguedatalab~career-site-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-praguedatalab-career-site-jobs", "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/praguedatalab~career-site-jobs/runs": { "post": { "operationId": "runs-sync-praguedatalab-career-site-jobs", "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/praguedatalab~career-site-jobs/run-sync": { "post": { "operationId": "run-sync-praguedatalab-career-site-jobs", "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": "Company names (\"Airbnb\"), ATS slugs (\"greenhouse:airbnb\", \"workday:nvidia|wd5|NVIDIAExternalCareerSite\") or career-page URLs (\"https://jobs.lever.co/spotify\", \"https://www.example.com/careers\"). The ATS is detected automatically. Leave empty to search the job index instead.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep jobs whose title or description contains any of these words or phrases (case and accent insensitive, plurals tolerated). End a word with :* for a prefix match (\"engineer:*\").", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs in any of these places: a city, a country or \"City, Region, Country\" in English or the local language (\"Berlin\", \"Germany\", \"Munich, Bavaria, Germany\", \"London, England, United Kingdom\"). \"Remote\" matches remote jobs.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs marked remote by the career site (or whose location says remote).", "default": false }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Keep only these workplace types. Leave empty for all.", "items": { "type": "string", "enum": [ "ONSITE", "HYBRID", "REMOTE" ], "enumTitles": [ "On-site", "Hybrid", "Remote" ] } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Keep only these employment types. Leave empty for all.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACT", "INTERNSHIP", "TEMPORARY", "OTHER" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary", "Other" ] } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Keep only jobs posted in the last N days. Leave empty for all open jobs." }, "ats": { "title": "ATS platforms", "type": "array", "description": "Keep only jobs from these ATS: greenhouse, lever (or lever.co), ashby, smartrecruiters, workday, recruitee, personio, teamtailor, workable, bamboohr. Leave empty for all.", "items": { "type": "string" } }, "includeDescription": { "title": "Include description (plain text)", "type": "boolean", "description": "Add the full job description as plain text (descriptionText).", "default": true }, "includeDescriptionHtml": { "title": "Include description (HTML)", "type": "boolean", "description": "Also add the description as HTML (descriptionHtml).", "default": false }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Stop after this many jobs (each saved job is one charged result). Default: 500, or 10 when the input uses the field names of other career-site APIs (as they do)." }, "maxJobsPerCompany": { "title": "Maximum jobs per company", "minimum": 1, "type": "integer", "description": "Optional cap per career board, so one large employer does not fill the whole result." }, "mode": { "title": "Mode", "enum": [ "auto", "companies", "search", "indexer" ], "type": "string", "description": "Auto: live fetch when companies are given, otherwise search. Companies: live fetch of the given boards. Search: the job index over thousands of companies (live fallback over the built-in company list when the index is unavailable). Indexer: builds the job index; reserved for the Actor owner.", "default": "auto" }, "leaderFields": { "title": "Add compatibility output fields", "type": "boolean", "description": "Also output the snake_case fields of other career-site job APIs (id, date_posted, organization, locations_derived, ai_employment_type, ...). On by default when the input uses their field names." }, "maxRunSeconds": { "title": "Time limit (seconds)", "minimum": 10, "type": "integer", "description": "Stop fetching after this many seconds and keep what was found. The live search over the built-in company list uses 210 s when empty." }, "indexStoreId": { "title": "Job index store ID", "type": "string", "description": "Optional ID of a key-value store holding a job index built by the indexer mode. Leave empty to use the public index." }, "timeRange": { "title": "timeRange", "enum": [ "1h", "24h", "7d", "6m" ], "type": "string", "description": "Compatibility: jobs posted in the last 1h, 24h, 7d or 6m. Inputs that use these compatibility fields default to 7d and 10 results, as the other API does." }, "limit": { "title": "limit", "minimum": 1, "type": "integer", "description": "Compatibility: same as Maximum jobs." }, "titleSearch": { "title": "titleSearch", "type": "array", "description": "Compatibility: words or phrases that must appear in the job title (any of them). Use :* for a prefix (\"Soft:*\").", "items": { "type": "string" } }, "titleExclusionSearch": { "title": "titleExclusionSearch", "type": "array", "description": "Compatibility: drop jobs whose title contains any of these.", "items": { "type": "string" } }, "locationSearch": { "title": "locationSearch", "type": "array", "description": "Compatibility: \"City, Region, Country\", a country or a city in English (\"United Kingdom\", \"New York, New York, United States\").", "items": { "type": "string" } }, "locationExclusionSearch": { "title": "locationExclusionSearch", "type": "array", "description": "Compatibility: drop jobs in these places.", "items": { "type": "string" } }, "descriptionSearch": { "title": "descriptionSearch", "type": "array", "description": "Compatibility: words or phrases that must appear in the title or description.", "items": { "type": "string" } }, "descriptionExclusionSearch": { "title": "descriptionExclusionSearch", "type": "array", "description": "Compatibility: drop jobs whose title or description contains any of these.", "items": { "type": "string" } }, "organizationSearch": { "title": "organizationSearch", "type": "array", "description": "Compatibility: words that must appear in the company name.", "items": { "type": "string" } }, "organizationExclusionSearch": { "title": "organizationExclusionSearch", "type": "array", "description": "Compatibility: drop companies whose name contains any of these.", "items": { "type": "string" } }, "domainFilter": { "title": "domainFilter", "type": "array", "description": "Compatibility: company domains to keep (\"airbnb.com\").", "items": { "type": "string" } }, "domainExclusionFilter": { "title": "domainExclusionFilter", "type": "array", "description": "Compatibility: company domains to drop.", "items": { "type": "string" } }, "descriptionType": { "title": "descriptionType", "enum": [ "text", "html" ], "type": "string", "description": "Compatibility: \"text\" or \"html\" description." }, "atsExclusionFilter": { "title": "atsExclusionFilter", "type": "array", "description": "Compatibility: ATS to drop (same values as ATS platforms).", "items": { "type": "string" } }, "aiEmploymentTypeFilter": { "title": "aiEmploymentTypeFilter", "type": "array", "description": "Compatibility: employment types (matched on the career site's own employment type).", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "aiWorkArrangementFilter": { "title": "aiWorkArrangementFilter", "type": "array", "description": "Compatibility: work arrangements (matched on the career site's own workplace type).", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "hasSalary": { "title": "hasSalary", "type": "boolean", "description": "Compatibility: keep only jobs that publish a salary." }, "aiHasSalary": { "title": "aiHasSalary", "type": "boolean", "description": "Compatibility: same as hasSalary." }, "datePostedAfter": { "title": "datePostedAfter", "type": "string", "description": "Compatibility: keep jobs posted on or after this UTC date or datetime (\"2026-01-01\" or \"2026-01-01T14:00:00\")." }, "hasNoLocation": { "title": "hasNoLocation", "type": "boolean", "description": "Compatibility: keep only jobs without a recognized location." }, "remote only (legacy)": { "title": "remote only (legacy)", "type": "boolean", "description": "Compatibility: same as Remote jobs only." } } }, "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 } } } } } } } } } }