{ "openapi": "3.0.1", "info": { "title": "Company Job Postings & Hiring Signals Scraper", "description": "Pull every open role from any company's job board via official ATS APIs —\nGreenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Personio,\nBreezy. Enriched with seniority, function, salary, remote flag and the tech\nnamed in each posting. From $2 / 1,000 companies.", "version": "0.0", "x-build-id": "hEK2KKqssyMJo62Gf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~company-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-company-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/eiv~company-jobs-scraper/runs": { "post": { "operationId": "runs-sync-eiv-company-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/eiv~company-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-company-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": { "companies": { "title": "Companies", "type": "array", "description": "Company domains or careers URLs, one per line. A direct job-board URL (boards.greenhouse.io/acme, jobs.lever.co/acme, jobs.ashbyhq.com/acme …) is used straight away and skips discovery.", "items": { "type": "string" } }, "boards": { "title": "Known job boards", "type": "array", "description": "Skip discovery entirely by naming the ATS and board token: [{\"ats\":\"greenhouse\",\"token\":\"gitlab\"}]. The cheapest and most reliable input if you already know them. Valid ats values: greenhouse, lever, ashby, smartrecruiters, workable, recruitee, personio, breezy." }, "startUrls": { "title": "Start URLs (for chaining)", "type": "array", "description": "Alternative to Companies, for feeding output from another Actor straight into this one.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sourceDatasetId": { "title": "Source dataset ID", "type": "string", "description": "Read companies from an existing dataset. Works out of the box with the Website Tech Stack & Lead Enrichment Scraper — its careersPageUrl field is picked up automatically." }, "sourceDatasetField": { "title": "Source dataset field", "type": "string", "description": "Which field on the source dataset holds the domain or careers URL.", "default": "domain" }, "titleKeywords": { "title": "Title keywords", "type": "array", "description": "Keep only roles whose title contains any of these (case-insensitive). Leave empty for every role.", "items": { "type": "string" } }, "locationKeywords": { "title": "Location keywords", "type": "array", "description": "Keep only roles whose location, city or country contains any of these. E.g. Germany, Remote, London.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Keep only postings flagged as remote.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Keep only roles published in the last N days — the strongest freshness signal for outbound timing. Postings with no publication date are excluded, since they cannot be shown to be recent. Leave at 0 for all roles.", "default": 0 }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap per company. Large employers can have thousands of open roles (Bosch: 4,760), so this protects you from an unexpected bill. Records flag truncated:true when a board exceeded the cap.", "default": 200 }, "includeDescriptions": { "title": "Fetch job descriptions", "type": "boolean", "description": "Required for the techKeywords field and for salaries stated only in the body text. Costs roughly 10x the bandwidth — Greenhouse grows from 343 KB to 4.1 MB on a 561-role board. Turn off for a fast, cheap titles-and-locations pass.", "default": true }, "includeFullDescriptionText": { "title": "Include full description text", "type": "boolean", "description": "Write the whole description (up to 8,000 characters) into each record. Off by default because it multiplies dataset size; a 300-character snippet and the extracted keywords are always included.", "default": false }, "includeCompanySummary": { "title": "Include per-company summary", "type": "boolean", "description": "Add one rollup record per company (recordType: company-summary) with counts by function and seniority, top locations, top tooling, and a 0-100 hiring velocity score. Not billed as a job.", "default": true }, "guessBoardToken": { "title": "Guess the board token from the domain", "type": "boolean", "description": "When no board is linked from the site, try the domain name as a token on Greenhouse, Lever and Ashby. Adds up to three cheap requests and is verified against the live API before being accepted.", "default": true }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Companies processed in parallel. Job-board responses can be several MB, so raise memory alongside this.", "default": 20 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 3, "maximum": 120, "type": "integer", "description": "Per-request timeout. Some boards are slow to serialise thousands of postings.", "default": 30 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for timeouts, connection resets and 5xx responses. ATS APIs are reliable, so 1 is usually enough.", "default": 1 }, "flattenOutput": { "title": "Flatten output for CSV", "type": "boolean", "description": "Emit flat dot-notation columns with arrays joined by ' | '. Use for spreadsheets; leave off for warehouses.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional and usually unnecessary — ATS APIs are public and are not defended by bot management.", "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 } } }, "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 } } } } } } } } } }