{ "openapi": "3.0.1", "info": { "title": "Greenhouse Jobs API — Search 6,000+ Greenhouse Job Boards", "description": "Search open jobs on 6,000+ company job boards hosted on Greenhouse by title, location, remote and posting date, or get every job from companies by name. Only-new-jobs monitoring. $2 per 1,000 jobs, no login.", "version": "0.1", "x-build-id": "fqiry7wSPyogvW9Sa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/suitable_sunspot~greenhouse-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-suitable_sunspot-greenhouse-jobs-api", "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/suitable_sunspot~greenhouse-jobs-api/runs": { "post": { "operationId": "runs-sync-suitable_sunspot-greenhouse-jobs-api", "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/suitable_sunspot~greenhouse-jobs-api/run-sync": { "post": { "operationId": "run-sync-suitable_sunspot-greenhouse-jobs-api", "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": "Job title keywords", "type": "array", "description": "Keep jobs whose title contains any of these words (matched at word start: 'engineer' matches 'Engineering Manager', 'AI' does not match 'maintain'). Leave companies empty to search every company in the daily index of ~20,000 live Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Teamtailor, Breezy and Personio boards. Filtered-out jobs are free.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Drop jobs whose title contains any of these, e.g. senior, intern, sales.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs whose location contains any of these (city, region or country as written in the posting, e.g. Berlin, London, Germany, United States). Use 'remote' to also accept remote roles.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs the ATS flags as remote or whose title/location says remote, anywhere or work from home.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs first published in the last N days. Jobs without a publish date are dropped when this is set." }, "companies": { "title": "Companies (names, ATS boards or careers URLs)", "type": "array", "description": "Optional. Company names (Stripe, Notion, NVIDIA — looked up in a directory of ~35,000 ATS boards), 'vendor:board' strings (greenhouse:gitlab, lever:palantir, ashby:openai) or careers-page URLs (https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite). Fetched live. Leave empty to search the whole index with the filters above.", "items": { "type": "string" } }, "onlyNewJobs": { "title": "Only new jobs since the last run (hiring signals)", "type": "boolean", "description": "Turn this on for scheduled monitoring. The Actor remembers which jobs it already delivered (in a named key-value store in your own Apify account) and returns only postings that appeared since your previous run. You pay only for the new rows. The first run returns all current jobs as the baseline.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Used with 'Only new jobs'. Keep one name per watch-list (e.g. 'sales-targets', 'competitors') so different schedules keep separate memories.", "default": "default" }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "type": "integer", "description": "Cap per company. Hitting it is reported as coverageStatus=capped with a reason, never a silent truncation. Default 200; raise it for big employers.", "default": 200 }, "maxItems": { "title": "Max items (run-wide)", "minimum": 1, "type": "integer", "description": "Hard ceiling on delivered rows across all companies in one run (and therefore on cost).", "default": 1000 }, "includeDescriptions": { "title": "Include descriptions", "type": "boolean", "description": "Company mode: fetch full job descriptions (one extra request per job for Workday, SmartRecruiters and Breezy). Search mode returns jobs without descriptions.", "default": true }, "maxRetries": { "title": "Max HTTP retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Retries per request for retryable failures (429, 5xx, network).", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Public ATS APIs rarely need a proxy; enable only if a source blocks.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }