{ "openapi": "3.0.1", "info": { "title": "Company Jobs Tracker", "description": "Track job listings for specific companies across StepStone portals (DE, AT, BE, NL, Totaljobs, NIjobs, Pnet). Detects new, changed, and removed postings with stateful diff tracking. Pay per company tracked.", "version": "0.0", "x-build-id": "0JNUH1YkUk0wst9sX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~company-jobs-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-company-jobs-tracker", "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/blackfalcondata~company-jobs-tracker/runs": { "post": { "operationId": "runs-sync-blackfalcondata-company-jobs-tracker", "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/blackfalcondata~company-jobs-tracker/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-company-jobs-tracker", "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": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "List of companies to track (max 200)", "items": { "type": "object", "required": [ "name", "geo" ], "properties": { "name": { "title": "Company Name", "type": "string", "description": "Company display name" }, "geo": { "title": "Portal Code", "type": "string", "description": "Portal code (DE, AT, NL, BE, TOTALJOBS, etc.)", "enum": [ "DE", "BE", "AT", "NL", "TOTALJOBS", "CWJOBS", "JOBSITE", "MILKROUND", "CATERER", "RETAILCHOICE", "CATERERGLOBAL", "CAREERSTRUCTURE", "CITYJOBS", "JUSTENGINEERS", "EMEDCAREERS", "NIJOBS", "JOBSIE", "PNET" ] }, "query": { "title": "Search Query Override", "type": "string", "description": "Search query override (defaults to company name)" }, "companyId": { "title": "Company ID (Server-side Filter)", "type": "integer", "description": "Server-side companyId filter. Skips client-side matching when set.", "nullable": true }, "matchMode": { "title": "Match Mode", "type": "string", "description": "Company matching mode", "enum": [ "strict", "strict_normalized", "prefix", "contains" ], "default": "strict_normalized" } } } }, "maxResultsPerCompany": { "title": "Max Results Per Company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Max jobs to fetch per company per run (hard ceiling: 100)", "default": 50 }, "calibrateOnly": { "title": "Calibrate Only", "type": "boolean", "description": "Run this first to validate company name matching before enabling tracking. No state is written.", "default": false }, "maxTotalRequests": { "title": "Max Total Requests", "minimum": 1, "type": "integer", "description": "Hard cap on total HTTP requests across all companies", "default": 500 }, "maxCompanies": { "title": "Max Companies", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on companies processed per run", "default": 200 }, "removedConfirmationRuns": { "title": "Removed Confirmation Runs", "minimum": 0, "type": "integer", "description": "Job must be missing for N+1 consecutive successful runs before marked removed. Default 1 = two-run confirmation.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration", "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 } } } } } } } } } }