{ "openapi": "3.0.1", "info": { "title": "ATS Jobs Scraper API — Greenhouse, Lever, Ashby & 4 more", "description": "Live jobs from Greenhouse, Lever, Ashby, Workable, Recruitee, SmartRecruiters and Personio boards in one schema: annualized salary, remote/hybrid, seniority, tech stack. Ready-made company lists, hiring-signal summaries. $1/1K jobs.", "version": "0.1", "x-build-id": "ShI8SKhMvQAkEv6eh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spherical_tact~greenhouse-lever-ashby-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spherical_tact-greenhouse-lever-ashby-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/spherical_tact~greenhouse-lever-ashby-jobs/runs": { "post": { "operationId": "runs-sync-spherical_tact-greenhouse-lever-ashby-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/spherical_tact~greenhouse-lever-ashby-jobs/run-sync": { "post": { "operationId": "run-sync-spherical_tact-greenhouse-lever-ashby-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 (job boards)", "type": "array", "description": "One per line: board name ('stripe'), 'ats:name' ('lever:spotify', 'workable:huggingface', 'smartrecruiters:Wise'), a careers URL or a domain. Plain names are tried on Greenhouse, Lever, Ashby, Workable, Recruitee, SmartRecruiters, then Personio. Up to 500 per run (with presets).", "items": { "type": "string" } }, "companyPresets": { "title": "Company presets (ready-made lists)", "type": "array", "description": "Add curated, verified job boards without looking up names. Combine with companies and filters. Tip: set maxItems — a whole list can return thousands of jobs.", "items": { "type": "string", "enum": [ "ai_ml", "devtools_infra", "fintech", "security", "crypto_web3", "consumer_tech", "europe", "remote_first" ], "enumTitles": [ "AI & ML companies (63)", "Developer tools & infrastructure (55)", "Fintech (50)", "Security (25)", "Crypto & Web3 (22)", "Consumer tech (30)", "European scale-ups (42)", "Remote-first companies (22)" ] } }, "outputMode": { "title": "Output", "enum": [ "jobs", "companies" ], "type": "string", "description": "'jobs' = one row per matching job. 'companies' = one summary row per job board: open and matching jobs, new in 7/30 days, top departments, seniority and work-mode mix, salary disclosure and medians, top tech stack, latest titles. Filters apply before summarizing.", "default": "jobs" }, "keywords": { "title": "Title keywords (any of)", "type": "array", "description": "Keep jobs whose title, department or team contains any of these, matched at word start ('engineer' also matches 'engineering', 'ml' does not match 'html'). Case-insensitive. Empty = all.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Drop jobs whose title contains any of these (word-start match).", "items": { "type": "string" } }, "departments": { "title": "Departments / teams (any of)", "type": "array", "description": "Keep jobs whose department or team contains any of these (word-start match).", "items": { "type": "string" } }, "locations": { "title": "Locations (any of)", "type": "array", "description": "Keep jobs whose location text or country contains any of these (word-start match), e.g. 'London', 'United States', 'Remote', 'Germany'. Multi-location jobs match if any location matches.", "items": { "type": "string" } }, "workModes": { "title": "Work mode (any of)", "type": "array", "description": "From the ATS field when present (Lever, Ashby, some Greenhouse boards), otherwise from the location/title or an explicit sentence in the description. Include 'unspecified' to keep jobs that don't say.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite", "unspecified" ] } }, "seniority": { "title": "Seniority (any of)", "type": "array", "description": "Inferred from the job title (e.g. 'Senior', 'Staff', 'II', 'Head of'). Many titles carry no level, so include 'unspecified' to avoid missing jobs.", "items": { "type": "string", "enum": [ "intern", "junior", "mid", "senior", "staff", "principal", "lead", "manager", "director", "executive", "unspecified" ] } }, "categories": { "title": "Job category (any of)", "type": "array", "description": "Job family inferred from title (then department).", "items": { "type": "string", "enum": [ "software_engineering", "data", "ml_ai", "devops_infra", "security", "product", "design", "research", "sales_marketing", "operations", "hardware", "other" ] } }, "employmentTypes": { "title": "Employment type (any of)", "type": "array", "description": "From the ATS field when present, otherwise from the title (intern, part-time, contract).", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "unspecified" ] } }, "techStack": { "title": "Tech stack (any of)", "type": "array", "description": "Keep jobs whose title or description mentions any of these technologies. Aliases are unified (Postgres=PostgreSQL, k8s=Kubernetes, Golang=Go, React.js=React).", "items": { "type": "string" } }, "minAnnualSalary": { "title": "Minimum annual salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose annualized salary maximum is at least this (hourly x2080, monthly x12), in the job's own currency. Jobs without a stated salary are dropped when this is set." }, "salaryCurrencies": { "title": "Salary currencies (any of)", "type": "array", "description": "Keep jobs whose salary is in these ISO codes, e.g. USD, EUR, GBP. Jobs without a salary are dropped when this is set.", "items": { "type": "string" } }, "requireSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only jobs where a salary range was found (ATS pay field or a range in the description).", "default": false }, "postedAfter": { "title": "Posted after", "pattern": "^(\\d{4}-\\d{2}-\\d{2}.*|\\d+\\s*days?)$", "type": "string", "description": "Keep jobs first published on or after this date: '2026-09-15' or relative like '7 days'. Lever and Ashby give the publish date; Greenhouse gives first_published." }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "html", "both", "none" ], "type": "string", "description": "Include the job description as plain text, HTML, both, or none (smaller output).", "default": "text" }, "onlyNew": { "title": "Only jobs I haven't received yet", "type": "boolean", "description": "For scheduled runs: return only jobs you haven't received from this Actor with the same input. IDs are kept in a key-value store named 'ats-jobs-state' in your account.", "default": false }, "maxItemsPerCompany": { "title": "Max results per company", "minimum": 1, "type": "integer", "description": "Cap rows per job board (newest first). Empty = no cap." }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of rows (jobs, or company summaries in 'companies' mode) to return in total. Each row is billed, so this caps your cost. Empty = all matching." } } }, "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 } } } } } } } } } }