{ "openapi": "3.0.1", "info": { "title": "Universal Career Site & ATS Jobs Scraper", "description": "Scrape every available job from company career sites and ATS platforms, including Workday, Greenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Personio, and BambooHR. Get titles, locations, salaries, descriptions, apply URLs, and raw source fields. No ATS API key required.", "version": "0.1", "x-build-id": "QSKUIwX2j1PQL7PIi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trakk~universal-career-site-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trakk-universal-career-site-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/trakk~universal-career-site-jobs-scraper/runs": { "post": { "operationId": "runs-sync-trakk-universal-career-site-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/trakk~universal-career-site-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-trakk-universal-career-site-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔗 Company or career-page URLs", "minItems": 1, "type": "array", "description": "Add company homepages or direct Greenhouse, Lever, Ashby, Workday, Workable, SmartRecruiters, Recruitee, Personio, BambooHR, and other career-page URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxJobsPerSource": { "title": "🎯 Maximum jobs per source", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum jobs returned from each supplied company. Set to 0 to collect every available job.", "default": 0 }, "maxJobsTotal": { "title": "🧮 Maximum jobs in the entire run", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Global cap across every source after deduplication. Set to 0 for no global limit.", "default": 0 }, "includeDescriptions": { "title": "📝 Fetch full job descriptions", "type": "boolean", "description": "Open job-detail endpoints when needed and include both clean text and source HTML descriptions.", "default": true }, "includeRawData": { "title": "🧬 Include every native ATS field", "type": "boolean", "description": "Adds rawJson and flattened native__ fields so platform-specific values are never silently discarded.", "default": true }, "saveRawResponses": { "title": "🗄️ Archive complete source responses", "type": "boolean", "description": "Save successful JSON, HTML, and XML responses in the run key-value store for auditing. Disabled by default to keep storage light.", "default": false }, "discoverFromCompanyWebsite": { "title": "🧭 Find career pages automatically", "type": "boolean", "description": "When a normal company homepage is supplied, locate its Careers or Jobs page and detect the underlying ATS.", "default": true }, "maxDiscoveryPages": { "title": "🔎 Discovery pages per website", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum company-site pages checked while searching for its career portal.", "default": 5 }, "maxPagesPerSource": { "title": "📄 Universal fallback page limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety limit for unknown or custom career sites. Native ATS integrations still request every available result page.", "default": 500 }, "maxConcurrency": { "title": "⚡ Maximum concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of sources and job details processed in parallel. The default balances speed and reliability.", "default": 10 }, "maxRetries": { "title": "🔁 Request attempts", "minimum": 1, "maximum": 15, "type": "integer", "description": "Retry budget for temporary network and source-server failures.", "default": 5 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional Apify or custom proxy configuration for career sites that restrict direct access.", "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 } } }, "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 } } } } } } } } } }