{ "openapi": "3.0.1", "info": { "title": "Job Postings & ATS Scraper: Careers Pages, Greenhouse, Lever", "description": "Every open role of a company from its own job board and ATS: give a domain, careers URL, ATS URL or LinkedIn company URL. 23 ATS systems including Greenhouse, Lever and Ashby, one schema, a hiring summary per company, new and closed roles. $0.0008 a job, $0.0005 on higher Apify plans.", "version": "0.1", "x-build-id": "TXCGDV7XFpBSdyuDz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pvalyou~job-postings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pvalyou-job-postings", "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/pvalyou~job-postings/runs": { "post": { "operationId": "runs-sync-pvalyou-job-postings", "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/pvalyou~job-postings/run-sync": { "post": { "operationId": "run-sync-pvalyou-job-postings", "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", "required": [ "queries" ], "properties": { "mode": { "title": "What are you looking up?", "enum": [ "company", "job", "monitor" ], "type": "string", "description": "Company: every open role of each company, from its own job board. Job: one posting in full from its URL. Monitor: company mode on a schedule, with each role flagged new or closed since the previous run.", "default": "company" }, "queries": { "title": "Companies or job URLs", "minItems": 1, "maxItems": 1000, "type": "array", "description": "One per line. Company and monitor modes take a domain (acme.com), a website URL, a careers page URL, an ATS board URL (Greenhouse, Lever, Ashby, Workable and the others) or a LinkedIn company URL. Job mode takes the URL of one posting on the employer's careers site or ATS. For programmatic use each entry may also be an object with 'query' and any filter below.", "items": { "type": "string" } }, "max_jobs": { "title": "Jobs per company", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on the rows one company returns, after the filters. Each row is one job_record event. Up to 500. Company and monitor modes only, because a job URL is one posting.", "default": 200 }, "include_description": { "title": "Include descriptions", "type": "boolean", "description": "Full description text and html on every row. Off keeps rows small (title, locations, department, dates, links). Company and monitor modes only. Job mode always returns the whole posting, description included, and this switch does not change it.", "default": true }, "keywords": { "title": "Title contains", "type": "array", "description": "Keep roles whose title contains any of these words (case-insensitive).", "items": { "type": "string" } }, "exclude": { "title": "Title does not contain", "type": "array", "description": "Drop roles whose title contains any of these words.", "items": { "type": "string" } }, "country": { "title": "Country", "maxLength": 2, "type": "string", "description": "Two-letter code (US, GB, IL, DE). Keeps roles with a location in that country." }, "remote_only": { "title": "Remote only", "type": "boolean", "description": "Keep roles the employer marks remote.", "default": false }, "department": { "title": "Department contains", "type": "string", "description": "Keep roles whose department contains this word (Engineering, Sales, Marketing)." }, "posted_within_days": { "title": "Posted within days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep roles the provider dates within this many days. Rows without a provider date are dropped when this is set, and the summary says how many." } } }, "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 } } } } } } } } } }