{ "openapi": "3.0.1", "info": { "title": "Career Page Jobs Scraper: Company Name or Website to Jobs", "description": "Company names or websites in, open jobs out: finds the careers page, detects the applicant tracking system (Workday, Greenhouse, Lever, Ashby and 10 more, 14 in all) and returns one job format. Unofficial: not affiliated with any ATS vendor or employer.", "version": "0.5", "x-build-id": "P6DyFQk3Myr3QADAu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gefese~company-careers-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gefese-company-careers-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/gefese~company-careers-jobs-scraper/runs": { "post": { "operationId": "runs-sync-gefese-company-careers-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/gefese~company-careers-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-gefese-company-careers-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": { "companyNames": { "title": "Company names", "type": "array", "description": "Company names, one per employer (for example Figma or Best Buy). The actor builds a few candidate domains from each name, accepts one only if its homepage title or site name contains the name, then finds the careers page and reads the jobs. If no website is accepted, it tries the name as a board name on Greenhouse, Lever and Ashby. A name can match the wrong company: check detectionMethod and resolvedDomain in the output, or use companyUrls for a precise match.", "items": { "type": "string" } }, "companyUrls": { "title": "Company website URLs", "type": "array", "description": "Company websites, one per employer (for example https://www.notion.com). The actor finds the careers page, detects the applicant tracking system and reads the open jobs. A URL that already points at a supported career site (Workday, Greenhouse, Lever, Ashby, Workable, Recruitee, Personio, Dayforce, Eightfold, Zoho Recruit, ClearCompany, Cornerstone, Jobvite, Rippling) is read directly; for ClearCompany that is apply.clearcompany.com/, .clearcompany.com/careers or the former .hrmdirect.com address. URLs are the precise option: use them when a company name could be ambiguous. Companies on other systems, or whose site blocks automated access, are reported in the DETECTION record and cost nothing.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQuery": { "title": "Search keyword", "type": "string", "description": "Optional keyword. Dayforce, Eightfold, Cornerstone, Workable and Workday apply it with the career site's own search; for the other vendors every word must appear in the job title (case-insensitive). Leave empty for all jobs.", "default": "" }, "maxItemsPerCompany": { "title": "Maximum jobs per company", "minimum": 1, "type": "integer", "description": "Stops after this many jobs for each company website. Each job is one billed result.", "default": 20 }, "includeDescription": { "title": "Include job description", "type": "boolean", "description": "Adds the plain-text description. For Eightfold, Zoho Recruit, Workable and Workday this costs one extra request per job, so runs are slower (ClearCompany returns the description with the job list).", "default": true }, "maxPagesPerCompany": { "title": "Careers pages to check per company", "minimum": 0, "maximum": 10, "type": "integer", "description": "After the homepage, at most this many same-site pages (careers or jobs links, then /careers and /jobs) are fetched to look for the ATS link.", "default": 4 }, "guessBoardsFromDomain": { "title": "Guess boards from the company name", "type": "boolean", "description": "When no ATS link is found on the website (or no website was found for a name), try the company name or domain name (for example shopify.com -> shopify, Best Buy -> bestbuy) as the board name on Greenhouse, Lever and Ashby (3 to 4 extra requests per company). A board is accepted only if it lists at least one job. The guess can match a different organisation with the same name; such items have detectionMethod name_guess. Turn this off to use only boards linked from the company's own pages.", "default": 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 } } } } } } } } } }