{ "openapi": "3.0.1", "info": { "title": "Career Site Jobs Search: Greenhouse, Lever, Workday Jobs API", "description": "Search open jobs by keyword across tens of thousands of company career sites (Greenhouse, Lever, Ashby, Workday, BambooHR, Workable, Recruitee, Personio, Rippling). Filter by remote, country, company, date. Optional full descriptions. No login.", "version": "0.1", "x-build-id": "jL0YunTuWdeQUtfLw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steady-scrape~career-jobs-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steady-scrape-career-jobs-search", "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/steady-scrape~career-jobs-search/runs": { "post": { "operationId": "runs-sync-steady-scrape-career-jobs-search", "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/steady-scrape~career-jobs-search/run-sync": { "post": { "operationId": "run-sync-steady-scrape-career-jobs-search", "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": { "keywords": { "title": "Keywords (job title)", "type": "array", "description": "Job title search terms. A job matches if its title contains ALL words of ANY one term (word match, plurals and '-ing' forms included, e.g. 'engineer' also matches 'Engineering'). Wrap a term in double quotes for an exact phrase, e.g. \"\\\"data engineer\\\"\". Leave empty to search by the other filters only.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title matches any of these terms (same matching rules as keywords), e.g. 'senior', 'intern', 'manager'.", "items": { "type": "string" } }, "searchIn": { "title": "Search keywords in", "enum": [ "title", "titleAndDepartment" ], "type": "string", "description": "Where keywords are matched. 'title' (default, most precise) or 'titleAndDepartment' (also matches the department/team name). Full job descriptions are not searched.", "default": "title" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only jobs marked remote by the employer's board or whose location says remote.", "default": false }, "countries": { "title": "Countries", "type": "array", "description": "Only jobs located in these countries. ISO 2-letter codes (US, GB, DE, CA, ...) or English names. Jobs with no detectable country are excluded when this is set.", "items": { "type": "string" } }, "locations": { "title": "Locations (text)", "type": "array", "description": "Case-insensitive text match on the job location or country name, e.g. 'Berlin', 'New York', 'California', 'Remote'. A job matches if its location contains any of these.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs posted in the last N days (by the board's posting date; for boards without dates, the date our index first saw the job). Jobs with an unknown date are excluded when this is set." }, "companies": { "title": "Companies", "type": "array", "description": "Only these companies. Matches the company name, the board slug, or 'platform:slug' (e.g. 'Stripe', 'openai', 'greenhouse:figma'). Substring match, case-insensitive.", "items": { "type": "string" } }, "platforms": { "title": "ATS platforms", "type": "array", "description": "Only career sites hosted on these applicant tracking systems. Empty = all.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby", "workday", "bamboohr", "workable", "recruitee", "personio", "rippling", "teamtailor", "breezy", "gem", "oraclehcm" ], "enumTitles": [ "Greenhouse", "Lever", "Ashby", "Workday", "BambooHR", "Workable", "Recruitee", "Personio", "Rippling", "Teamtailor", "Breezy HR", "Gem", "Oracle Cloud HCM" ] } }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Only jobs with these workplace types (as stated or detected from the location). Jobs with unknown workplace type are excluded when this is set.", "items": { "type": "string", "enum": [ "REMOTE", "HYBRID", "ONSITE" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Only jobs with these employment types (when the board states one).", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACT", "TEMPORARY", "INTERN", "OTHER" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Other" ] } }, "salaryOnly": { "title": "Only jobs with a listed salary", "type": "boolean", "description": "Only jobs where the board publishes a structured salary range in its job list (mainly Lever, Ashby, Recruitee). With full descriptions on, salaries parsed from descriptions are added on top.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of jobs to return (you are charged per returned job).", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance" ], "type": "string", "description": "'newest' = most recently posted first. 'relevance' = titles starting with / containing your exact term first, then newest.", "default": "newest" }, "includeDescriptions": { "title": "Include full job descriptions (live)", "type": "boolean", "description": "Fetch each returned job live from the employer's board: adds the full description (HTML + text), structured salary where published, and confirms the job is still open (closed jobs are skipped, not charged). Slower; supported live for Greenhouse, Lever, Ashby and Workday. Other platforms return index data with a link.", "default": false }, "onlyNewSinceLastRun": { "title": "Only jobs not returned before", "type": "boolean", "description": "Skip jobs this search already returned in earlier runs (remembered per search in a key-value store in your account). Ideal for scheduled daily alerts.", "default": false }, "stateKey": { "title": "State key (optional)", "type": "string", "description": "Name for the 'only new' memory. By default it is derived from your search filters; set this to keep the same memory after changing filters." }, "dedupe": { "title": "Remove duplicates", "type": "boolean", "description": "Drop repeated postings of the same title + location at the same company (e.g. the same role posted on several boards of one employer).", "default": true }, "maxConcurrency": { "title": "Max concurrency (descriptions)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests when fetching full descriptions. Keep low to be polite to career sites.", "default": 8 } } }, "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 } } } } } } } } } }