{ "openapi": "3.0.1", "info": { "title": "Company Jobs & Salary Scraper", "description": "Every open role at any company, straight from the job board it publishes on — Greenhouse, Lever, Ashby or SmartRecruiters. Salary ranges included where they exist, title, department, location, remote flag and posting date. Give it a company name; it finds the board.", "version": "0.0", "x-build-id": "uPTa04k8gtFwRjfEv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~job-postings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-job-postings-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~job-postings-scraper/runs": { "post": { "operationId": "runs-sync-eiv-job-postings-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~job-postings-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-job-postings-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": "The token each company's job board is published under — the last part of its careers URL. boards.greenhouse.io/stripe is 'stripe', jobs.lever.co/palantir is 'palantir', jobs.ashbyhq.com/ramp is 'ramp'. Paste the whole URL if you prefer; it is reduced for you. All four platforms are searched, so you do not need to know which one a company uses. Write greenhouse:stripe to pin one and skip the search.", "items": { "type": "string" } }, "platforms": { "title": "Platforms", "type": "array", "description": "Leave empty for all four. greenhouse, lever, ashby, smartrecruiters. Narrowing this makes the search cheaper when you already know where a company posts.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Any one matching is enough. Searched in the title, department and team, and in the description when descriptions are included.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop any posting matching one of these. Useful for stripping 'Intern', 'Contract' or a product line you do not care about.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Matched against the department and the team, as a substring. 'Engineering' catches 'Engineering - Pipeline'.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Matched against every location a posting lists, not only the first — a role open in four cities matches a search for any of them. The word 'remote' also matches a posting flagged remote whose location does not say so.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Keep only postings the platform flags as remote, or whose location says so.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Drop anything older. Postings with no date are kept — SmartRecruiters often omits it, and an unknown date is not evidence a role is stale." }, "minSalary": { "title": "Minimum salary", "minimum": 0, "type": "integer", "description": "Compared against the top of the annualised range, so a role paying 150k-190k clears a 180k floor. Annualising means an hourly rate and a yearly one are judged on the same scale. Postings that publish no pay are kept, because most do not and dropping them silently would hide the majority of the market. Use 'Only postings that publish pay' to drop them instead." }, "requireSalary": { "title": "Only postings that publish pay", "type": "boolean", "description": "Keep only postings whose salary could be established. Expect this to narrow a run sharply on Greenhouse boards, which mostly state nothing.", "default": false }, "includeDescription": { "title": "Include the full description", "type": "boolean", "description": "Adds the posting text to every record. This is most of the payload — one board goes from 139 KB to 4.2 MB — so leave it off unless you need it. Salary is read from the description either way; turning this off does not cost you the pay data.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "A large board runs to several hundred roles. The summary row carries totalAvailable where the platform reports one, so you can see what was left behind.", "default": 1000 }, "includeCompanySummary": { "title": "Include a summary per company", "type": "boolean", "description": "Add one rollup per company: which platforms it was found on, pay coverage, median salary and its currency, remote count, postings in the last 7 and 30 days, top departments and locations. Not billed as a job.", "default": true }, "flattenOutput": { "title": "Flatten output for CSV", "type": "boolean", "description": "Emit flat dot-notation columns. Mainly affects the list of locations and the top-department list on summary rows.", "default": false }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Companies read in parallel. Each one searches up to four platforms, so this multiplies. Five is comfortable; the boards will rate limit above that.", "default": 5 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "Per-request timeout. A large board with descriptions is several megabytes.", "default": 60 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for connection resets and 5xx responses. A 429 backs off in seconds rather than milliseconds, and honours Retry-After.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. All four are public job board APIs and none of them blocks.", "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 } } } } } } } } } }